Live on Base Mainnet

78 live endpoints
for autonomous agents

Treasury curves, 53 FRED series endpoints, forex, yield spreads, breakeven inflation, macro bundles, recession probability, and composite dashboards. Pay per call with USDC on Base. No API keys. No subscriptions. No accounts.

API Discovery → Browse endpoints
Quick start
$ npx agentcash@latest discover https://api.mercury402.com
78
Live Endpoints
—
Revenue
—
API Calls
—
Customers
—
Next Milestone
Use with Claude

Mercury402 as an
MCP server.

Give Claude and other MCP clients direct access to all 78 endpoints. One command, no install step, no account.

$ npx -y mercury402-mcp
01

Add the server

Paste the Claude Code command or the Claude Desktop config. Your client launches it with npx.

02

Free by default

list_endpoints browses every route and price. get_endpoint_data returns the x402 quote. Nothing is spent.

03

Optional paid mode

Set MERCURY402_PAYER_PRIVATE_KEY to pay per call in USDC on Base, capped by MERCURY402_MAX_PRICE_USD. The key sits in plaintext in your client config, so use a dedicated low-balance wallet.

npm package → GitHub →
Claude Code
claude mcp add mercury402 -- npx -y mercury402-mcp
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "mercury402": {
      "command": "npx",
      "args": ["-y", "mercury402-mcp"]
    }
  }
}
How it works

One call. One payment.
78 routes live.

Mercury402 implements the x402 payment protocol for deterministic financial data: one endpoint, one price, one USDC payment on Base, one signed JSON response.

01

Discover 78 endpoints

Treasury, FRED, forex, spreads, breakeven inflation, macro intelligence, and composite dashboards are exposed as direct HTTP routes.

02

Receive 402 Payment Required

Your client gets a precise payment descriptor for the requested route, including the exact price and Base USDC settlement details.

03

Pay with USDC on Base

Your agent submits the x402 payment and Mercury verifies settlement before serving data. No API keys or account provisioning.

04

Consume deterministic JSON

The response includes structured data and provenance so automated strategies, dashboards, and agent workflows stay reproducible.

REQUESTGET /v1/macro/bundle
402{ "amount": "100000", "token": "USDC" }
PAYMENTx402 settlement → Base L2
✓ verified on-chain
200 OK{ "treasury_10y": 4.24, "cpi_yoy": 3.2,
  "vix": 14.8, "yield_spread_10y_2y": 0.30 }
Endpoints

78 live endpoints.
Real financial data.

Complete coverage across 7 core categories: Treasury (4), FRED Series (53), Forex (4), Yield Spreads (5), Breakeven Inflation (4), Macro Intelligence (3), and Composite (3). Pricing is $0.05 base, $0.10 for macro premium endpoints, $0.40 for inflation and labor composites, and $0.50 for the economic dashboard.

Treasury (4)
Yield Curve (Daily)
GET /v1/treasury/yield-curve/daily-snapshot
U.S. Treasury par yield curve snapshot across 11 maturities.
Treasury $0.05 / call
Yield Curve (Historical)
POST /v1/treasury/yield-curve/historical
Historical Treasury curve snapshots for a requested date range.
Treasury $0.05 / call
Auction Results
GET /v1/treasury/auction-results/recent
Recent Treasury auction results and proxy issuance data.
Treasury $0.05 / call
TIPS Rates
GET /v1/treasury/tips-rates/current
Current TIPS real yields across key maturities.
Treasury $0.05 / call
FRED Series (53)
Any FRED Series
GET /v1/fred/{series_id}
Direct access to any valid FRED series ID, including the full 800k+ catalog.
FRED $0.05 / call
Consumer Price Index (CPI)
GET /v1/fred/cpi
Consumer Price Index for All Urban Consumers (CPIAUCSL)
Prices $0.05 / call
Core CPI
GET /v1/fred/cpi-core
Core CPI (excl. food & energy, CPILFESL)
Prices $0.05 / call
Producer Price Index (PPI)
GET /v1/fred/ppi
Producer Price Index for All Commodities
Prices $0.05 / call
Personal Consumption Expenditures
GET /v1/fred/pce
Personal Consumption Expenditures (PCE)
Prices $0.05 / call
Core PCE Price Index
GET /v1/fred/pce-core
Core PCE Price Index (excl. food & energy)
Prices $0.05 / call
PCE Deflator
GET /v1/fred/pce-deflator
PCE deflator, percent change from year ago
Prices $0.05 / call
Unemployment Rate
GET /v1/fred/unemployment-rate
Civilian unemployment rate
Employment $0.05 / call
Nonfarm Payrolls
GET /v1/fred/nonfarm-payrolls
Total nonfarm payrolls (thousands)
Employment $0.05 / call
Initial Jobless Claims
GET /v1/fred/initial-claims
Initial jobless claims, weekly
Employment $0.05 / call
Continuing Jobless Claims
GET /v1/fred/continuing-claims
Continued claims, weekly
Employment $0.05 / call
Labor Force Participation Rate
GET /v1/fred/labor-force-participation
Labor force participation rate
Employment $0.05 / call
Average Hourly Earnings
GET /v1/fred/average-hourly-earnings
Average hourly earnings of all employees, total private
Employment $0.05 / call
JOLTS Job Openings
GET /v1/fred/jolts-openings
Job Openings and Labor Turnover Survey
Employment $0.05 / call
Quits Rate
GET /v1/fred/quits-rate
Quits rate (JOLTS)
Employment $0.05 / call
U-6 Unemployment
GET /v1/fred/u6-unemployment
Total unemployed + marginally attached + part-time for economic reasons
Employment $0.05 / call
Gross Domestic Product
GET /v1/fred/gdp
Real GDP, billions of chained 2017 dollars
Growth $0.05 / call
Real GDP Growth
GET /v1/fred/gdp-growth
Real GDP percent change, annualized
Growth $0.05 / call
Gross Domestic Income
GET /v1/fred/gdi
Real GDI
Growth $0.05 / call
GDP Deflator
GET /v1/fred/gdp-deflator
Gross domestic product: implicit price deflator
Growth $0.05 / call
Corporate Profits
GET /v1/fred/corporate-profits
Corporate profits after tax
Growth $0.05 / call
M1 Money Stock
GET /v1/fred/m1-money-stock
M1 money stock, seasonally adjusted
Rates $0.05 / call
M2 Money Stock
GET /v1/fred/m2-money-stock
M2 money stock, seasonally adjusted
Rates $0.05 / call
Federal Funds Effective Rate
GET /v1/fred/fed-funds-rate
Effective federal funds rate
Rates $0.05 / call
Fed Funds Target Upper
GET /v1/fred/fed-funds-target-upper
Federal funds target rate, upper bound
Rates $0.05 / call
3-Month Treasury
GET /v1/fred/treasury-3m
3-month Treasury constant maturity rate
Rates $0.05 / call
2-Year Treasury
GET /v1/fred/treasury-2y
2-year Treasury constant maturity rate
Rates $0.05 / call
5-Year Treasury
GET /v1/fred/treasury-5y
5-year Treasury constant maturity rate
Rates $0.05 / call
10-Year Treasury
GET /v1/fred/treasury-10y
10-year Treasury constant maturity rate
Rates $0.05 / call
30-Year Treasury
GET /v1/fred/treasury-30y
30-year Treasury constant maturity rate
Rates $0.05 / call
30-Year Fixed Mortgage
GET /v1/fred/mortgage-30y
30-year fixed-rate mortgage average
Rates $0.05 / call
BBB Corporate Yield
GET /v1/fred/bbb-corporate-yield
ICE BofA BBB US Corporate Index Option-Adjusted Yield
Rates $0.05 / call
High Yield Spread
GET /v1/fred/high-yield-spread
ICE BofA US High Yield Index Option-Adjusted Spread
Rates $0.05 / call
A-Rated Corporate Spread
GET /v1/fred/a-rated-spread
ICE BofA Single-A US Corporate Index OAS
Rates $0.05 / call
U Michigan Consumer Sentiment
GET /v1/fred/consumer-confidence
University of Michigan consumer sentiment index
Sentiment $0.05 / call
Conference Board CI
GET /v1/fred/conference-board-ci
Conference Board consumer confidence index (OECD)
Sentiment $0.05 / call
Inflation Expectations
GET /v1/fred/inflation-expectations
University of Michigan 1-year inflation expectations
Sentiment $0.05 / call
Leading Economic Index
GET /v1/fred/leading-indicators
Conference Board Leading Economic Index for the US
Sentiment $0.05 / call
Trade Balance
GET /v1/fred/trade-balance
Trade balance: goods and services, millions of USD
Trade $0.05 / call
Current Account Balance
GET /v1/fred/current-account
Current account balance, billions of USD
Trade $0.05 / call
Housing Starts
GET /v1/fred/housing-starts
New privately-owned housing units started (thousands)
Housing $0.05 / call
Building Permits
GET /v1/fred/building-permits
New privately-owned housing units authorized (thousands)
Housing $0.05 / call
Existing Home Sales
GET /v1/fred/existing-home-sales
Existing home sales, millions (SAAR)
Housing $0.05 / call
Case-Shiller Home Price Index
GET /v1/fred/case-shiller
S&P/Case-Shiller US National Home Price Index
Housing $0.05 / call
Homeownership Rate
GET /v1/fred/homeownership-rate
Homeownership rate for the US
Housing $0.05 / call
Industrial Production Index
GET /v1/fred/industrial-production
Industrial production: total index
Activity $0.05 / call
Retail Sales
GET /v1/fred/retail-sales
Advance retail sales: retail and food services (millions)
Activity $0.05 / call
Personal Income
GET /v1/fred/personal-income
Personal income, billions of USD
Activity $0.05 / call
Personal Saving Rate
GET /v1/fred/personal-saving-rate
Personal saving rate (percent)
Activity $0.05 / call
Total Vehicle Sales
GET /v1/fred/total-vehicle-sales
Total vehicle sales, millions (SAAR)
Activity $0.05 / call
Federal Debt-to-GDP
GET /v1/fred/federal-debt
Federal debt as percent of GDP
Activity $0.05 / call
Federal Surplus/Deficit
GET /v1/fred/federal-deficit
Federal surplus or deficit, billions
Activity $0.05 / call
VIX Index
GET /v1/fred/vix
CBOE Volatility Index: VIX
Activity $0.05 / call
Forex (4)
EUR/USD
GET /v1/forex/eur-usd
Euro area / US dollar exchange rate (DEXUSEU)
Forex $0.05 / call
GBP/USD
GET /v1/forex/gbp-usd
US / UK pound exchange rate (DEXUSUK)
Forex $0.05 / call
USD/JPY
GET /v1/forex/usd-jpy
Japan / US dollar exchange rate (DEXJPUS)
Forex $0.05 / call
USD/CNY
GET /v1/forex/usd-cny
China / US dollar exchange rate (DEXCHUS)
Forex $0.05 / call
Yield Spreads (5)
10Y-2Y Spread
GET /v1/yield-spread/10y-2y
10-year minus 2-year Treasury yield spread
Spread $0.05 / call
10Y-3M Spread
GET /v1/yield-spread/10y-3m
10-year minus 3-month Treasury yield spread
Spread $0.05 / call
5Y-2Y Spread
GET /v1/yield-spread/5y-2y
5-year minus 2-year Treasury yield spread
Spread $0.05 / call
30Y-5Y Spread
GET /v1/yield-spread/30y-5y
30-year minus 5-year Treasury yield spread
Spread $0.05 / call
10Y-5Y Spread
GET /v1/yield-spread/10y-5y
10-year minus 5-year Treasury yield spread
Spread $0.05 / call
Breakeven Inflation (4)
5Y Breakeven Inflation
GET /v1/breakeven/5y
5-year breakeven inflation rate (TIPS)
TIPS $0.05 / call
10Y Breakeven Inflation
GET /v1/breakeven/10y
10-year breakeven inflation rate (TIPS)
TIPS $0.05 / call
2Y Breakeven Inflation
GET /v1/breakeven/2y
2-year breakeven inflation rate (TIPS)
TIPS $0.05 / call
5Y5Y Forward Inflation
GET /v1/breakeven/5y5y
5-year, 5-year forward inflation expectation rate
TIPS $0.05 / call
Macro Intelligence (3)
Macro Snapshot
GET /v1/macro/snapshot/all
Single-call macro snapshot for GDP, CPI, rates, yields, VIX, dollar index, and sentiment.
Bundle $0.05 / call
Macro Bundle
GET /v1/macro/bundle
Treasury, CPI, GDP, employment, Fed funds, M2, VIX, and trade in one response.
Premium $0.10 / call
Recession Probability
GET /v1/macro/recession-probability
Logistic recession probability model built from the yield curve and labor data.
Premium $0.10 / call
Composite (3)
Inflation Tracker
GET /v1/composite/inflation-tracker
Composite inflation dashboard for CPI, PCE, and core CPI.
Composite $0.40 / call
Labor Market
GET /v1/composite/labor-market
Composite labor dashboard for unemployment, claims, and payrolls.
Composite $0.40 / call
Economic Dashboard
GET /v1/composite/economic-dashboard
Premium macro overview combining GDP, CPI, and unemployment.
Composite $0.50 / call
Payment flow

How x402 micropayments work

USDC on Base. Sub-second settlement. One deterministic response per call, from $0.05 single-series pulls to premium macro and composite products.

01
Request
GET /endpoint
→
02
402 Response
Payment descriptor returned
→
03
Pay USDC
On Base L2 via x402
→
04
Verify
On-chain in ~1.4s
→
05
Data
Deterministic JSON returned