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

ParameterTypeInRequiredDescription
seriesstringQuery (GET)NoTarget 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.
limitintegerQuery (GET)NoNumber of chronological periods to return when series=history (default: 12, max: 120).

Request Headers

HeaderValueDescription
Acceptapplication/jsonExpected response content type.

Benchmark Rates Exposed

  1. 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.
  2. Secured Overnight Financing Rate (SOFR): The broad measure of the cost of borrowing cash overnight collateralized by Treasury securities (NY Fed).
  3. Effective Federal Funds Rate (EFFR): The volume-weighted median of overnight federal funds transactions among depository institutions.
  4. 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

FieldTypeDescription
sourcestringBenchmark data provenance citation.
statusstringRequest status ("success" or "error").
as_ofstringEffective date of the latest Federal Reserve H.15 release (YYYY-MM-DD).
benchmarksobjectCurrent rate benchmarks.
benchmarks.prime_rateInterestRateWSJ / Fed Prime rate value object.
benchmarks.sofrInterestRateSecured Overnight Financing Rate value object.
benchmarks.effective_fed_fundsInterestRateEffective Federal Funds Rate value object.
benchmarks.target_rangeobjectFOMC policy target band with min, max, and formatted string.
fomc_calendarobjectNext scheduled FOMC rate decision dates and cycle phase.
fomc_calendar.next_meetingstringDate of the next FOMC decision (YYYY-MM-DD).
fomc_calendar.days_until_nextintegerCalendar days remaining until the next rate decision.
credit_spread_modelobjectBank Net Interest Margin (NIM) spread over benchmark.
cycle_historyarrayMonthly 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 CodeDescription
200 OKRequest succeeded. Benchmark rate data returned.
400 Bad RequestInvalid query parameters (e.g. invalid limit or series).
429 Too Many RequestsRate limit exceeded (60 requests/minute).