The /api/benchmark endpoint provides real-time access to money market benchmarks published by the Federal Reserve Board of Governors (Statistical Release H.15) and the Federal Reserve Bank of New York. It exposes the official Wall Street Journal / Federal Reserve Prime Rate, the Secured Overnight Financing Rate (SOFR), the Effective Federal Funds Rate (EFFR), the Federal Open Market Committee (FOMC) meeting calendar, bank credit card rate spreads (Net Interest Margin), and a 10-year historical cycle series.
To test this endpoint interactively, use the API Explorer.
Request
GET https://www.axetip.com/api/benchmark
GET https://www.axetip.com/api/benchmark?series=history&limit=12
GET https://www.axetip.com/api/benchmark?series=fomc
GET https://www.axetip.com/api/benchmark?series=nim
Parameters
| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
series | string | Query (GET) | No | Target data slice: history (10-year monthly historical rate cycle), fomc (meeting calendar and policy target), nim (credit card rate spread), or omitted for full overview. |
limit | integer | Query (GET) | No | Number of chronological periods to return when series=history (default: 12, max: 120). |
Request Headers
| Header | Value | Description |
|---|---|---|
Accept | application/json | Expected response content type. |
Benchmark Rates Exposed
- Federal Reserve / WSJ Prime Rate: The foundational benchmark used by U.S. commercial banks to index variable-rate credit cards, home equity lines of credit (HELOCs), and commercial revolving loans.
- Secured Overnight Financing Rate (SOFR): The broad measure of the cost of borrowing cash overnight collateralized by Treasury securities (NY Fed).
- Effective Federal Funds Rate (EFFR): The volume-weighted median of overnight federal funds transactions among depository institutions.
- FOMC Target Range: The policy target band set by the Federal Open Market Committee (currently 4.75% – 5.00%).
Net Interest Margin (NIM) Credit Spread Model
The endpoint tracks the statutory interest rate spread between the Federal Reserve Prime benchmark and commercial credit card APRs:
$$\text{NIM Credit Spread} = \text{Average Credit Card APR} - \text{Fed Prime Rate}$$
With the Federal Reserve Prime rate at 7.00% (700 bps) and the commercial credit card average APR at 30.45% (3,045 bps), commercial issuers capture a net interest margin spread of +2,345 bps (+23.45%).
Response Schema
| Field | Type | Description |
|---|---|---|
source | string | Benchmark data provenance citation. |
status | string | Request status ("success" or "error"). |
as_of | string | Effective date of the latest Federal Reserve H.15 release (YYYY-MM-DD). |
benchmarks | object | Current rate benchmarks. |
benchmarks.prime_rate | InterestRate | WSJ / Fed Prime rate value object. |
benchmarks.sofr | InterestRate | Secured Overnight Financing Rate value object. |
benchmarks.effective_fed_funds | InterestRate | Effective Federal Funds Rate value object. |
benchmarks.target_range | object | FOMC policy target band with min, max, and formatted string. |
fomc_calendar | object | Next scheduled FOMC rate decision dates and cycle phase. |
fomc_calendar.next_meeting | string | Date of the next FOMC decision (YYYY-MM-DD). |
fomc_calendar.days_until_next | integer | Calendar days remaining until the next rate decision. |
credit_spread_model | object | Bank Net Interest Margin (NIM) spread over benchmark. |
cycle_history | array | Monthly time series of historical Prime, SOFR, and EFFR rates (when series=history). |
Example Responses
1. Full Benchmark Overview (GET /api/benchmark)
{
"source": "Federal Reserve Board of Governors H.15 & NY Fed",
"status": "success",
"as_of": "2026-09-16",
"benchmarks": {
"prime_rate": {
"value": 7.0,
"bps": 700,
"formatted": "7.00%"
},
"sofr": {
"value": 4.82,
"bps": 482,
"formatted": "4.82%"
},
"effective_fed_funds": {
"value": 4.83,
"bps": 483,
"formatted": "4.83%"
},
"target_range": {
"min": { "value": 4.75, "bps": 475, "formatted": "4.75%" },
"max": { "value": 5.0, "bps": 500, "formatted": "5.00%" },
"formatted": "4.75% - 5.00%"
}
},
"fomc_calendar": {
"next_meeting": "2026-10-28",
"days_until_next": 42,
"current_cycle_phase": "Rate cutting cycle",
"upcoming_meetings": [
{ "date": "2026-10-28", "status": "scheduled" },
{ "date": "2026-12-09", "status": "scheduled" }
]
},
"credit_spread_model": {
"benchmark_rate": { "value": 7.0, "bps": 700, "formatted": "7.00%" },
"average_credit_card_apr": { "value": 30.45, "bps": 3045, "formatted": "30.45%" },
"net_interest_margin_spread": {
"bps": 2345,
"percentage": 23.45,
"formatted": "+2,345 bps (+23.45%)"
},
"note": "Statutory APR premium charged by commercial card issuers over Fed Prime benchmark."
}
}
2. Historical Rate Cycle (GET /api/benchmark?series=history&limit=3)
{
"source": "Federal Reserve Board of Governors H.15 & NY Fed",
"status": "success",
"series": "history",
"limit": 3,
"count": 3,
"data": [
{
"period": "2026-09",
"prime_rate": { "value": 7.0, "bps": 700, "formatted": "7.00%" },
"sofr": { "value": 4.82, "bps": 482, "formatted": "4.82%" },
"effective_fed_funds": { "value": 4.83, "bps": 483, "formatted": "4.83%" }
},
{
"period": "2026-08",
"prime_rate": { "value": 7.25, "bps": 725, "formatted": "7.25%" },
"sofr": { "value": 5.06, "bps": 506, "formatted": "5.06%" },
"effective_fed_funds": { "value": 5.08, "bps": 508, "formatted": "5.08%" }
},
{
"period": "2026-07",
"prime_rate": { "value": 7.5, "bps": 750, "formatted": "7.50%" },
"sofr": { "value": 5.31, "bps": 531, "formatted": "5.31%" },
"effective_fed_funds": { "value": 5.33, "bps": 533, "formatted": "5.33%" }
}
]
}
Code Samples
cURL
curl -s "https://www.axetip.com/api/benchmark"
TypeScript / Node.js
interface BenchmarkResponse {
source: string;
as_of: string;
benchmarks: {
prime_rate: { value: number; bps: number; formatted: string };
sofr: { value: number; bps: number; formatted: string };
effective_fed_funds: { value: number; bps: number; formatted: string };
};
credit_spread_model: {
net_interest_margin_spread: { bps: number; formatted: string };
};
}
const res = await fetch("https://www.axetip.com/api/benchmark");
const data: BenchmarkResponse = await res.json();
console.log(`Fed Prime: ${data.benchmarks.prime_rate.formatted} (${data.benchmarks.prime_rate.bps} bps)`);
console.log(`SOFR: ${data.benchmarks.sofr.formatted} | EFFR: ${data.benchmarks.effective_fed_funds.formatted}`);
console.log(`NIM Spread: ${data.credit_spread_model.net_interest_margin_spread.formatted}`);
Python
import httpx
url = "https://www.axetip.com/api/benchmark"
response = httpx.get(url, timeout=10.0)
data = response.json()
benchmarks = data["benchmarks"]
print(f"Fed Prime: {benchmarks['prime_rate']['formatted']} ({benchmarks['prime_rate']['bps']} bps)")
print(f"SOFR: {benchmarks['sofr']['formatted']} | EFFR: {benchmarks['effective_fed_funds']['formatted']}")
print(f"NIM Spread: {data['credit_spread_model']['net_interest_margin_spread']['formatted']}")
Go
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
)
type BenchmarkResponse struct {
Benchmarks struct {
PrimeRate struct {
Formatted string `json:"formatted"`
Bps int `json:"bps"`
} `json:"prime_rate"`
SOFR struct {
Formatted string `json:"formatted"`
} `json:"sofr"`
} `json:"benchmarks"`
CreditSpreadModel struct {
NIMSpread struct {
Formatted string `json:"formatted"`
} `json:"net_interest_margin_spread"`
} `json:"credit_spread_model"`
}
func main() {
resp, _ := http.Get("https://www.axetip.com/api/benchmark")
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var res BenchmarkResponse
json.Unmarshal(body, &res)
fmt.Printf("Fed Prime: %s (%d bps)\n", res.Benchmarks.PrimeRate.Formatted, res.Benchmarks.PrimeRate.Bps)
fmt.Printf("SOFR: %s\n", res.Benchmarks.SOFR.Formatted)
fmt.Printf("NIM Spread: %s\n", res.CreditSpreadModel.NIMSpread.Formatted)
}
Status Codes
| Status Code | Description |
|---|---|
200 OK | Request succeeded. Benchmark rate data returned. |
400 Bad Request | Invalid query parameters (e.g. invalid limit or series). |
429 Too Many Requests | Rate limit exceeded (60 requests/minute). |