API reference

Every endpoint with its TypeScript response type and a real example response. Types are generated from live production captures, so what you read is what you get. Every response is shaped { ticker, data, source, as_of }. Paid endpoints charge USDC per request over x402 — an unpaid call returns HTTP 402 with payment requirements; pay and retry.

Prices & snapshots

Last price, full snapshots, daily bars, and watchlist snapshots.

GET/api/v1/quote/{ticker}$0.01

Last price for a US stock, 15 minute delayed

Get the latest available price for any US-listed stock: the most recent 1-minute bar close plus today's OHLCV, change, and previous close. Currently 15 minutes delayed; each response carries `is_delayed: true`. Real-time pricing lands when the data plan is upgraded.

Example request
GET /api/v1/quote/AAPL
Response type (TypeScript)
interface QuoteResponse {
  ticker: string;
  data: {
    price: number;
    change: number;
    change_percent: number;
    day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    previous_close: number;
    timestamp: null;
    is_delayed: boolean;
    delayed_by: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "price": 0,
    "change": 0,
    "change_percent": 0,
    "day": {
      "open": 0,
      "high": 0,
      "low": 0,
      "close": 0,
      "volume": 0,
      "vwap": 0
    },
    "previous_close": 312.06,
    "timestamp": null,
    "is_delayed": true,
    "delayed_by": "15 minutes"
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:08.363Z"
}
GET/api/v1/snapshot/{ticker}$0.01

Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)

Single-call snapshot of a ticker's current state: last quote, last trade, today's OHLC + volume + VWAP, previous-day OHLC, today's change vs previous close.

Example request
GET /api/v1/snapshot/AAPL
Response type (TypeScript)
interface SnapshotResponse {
  ticker: string;
  data: {
    change: number;
    change_percent: number;
    day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    previous_day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    last_minute_bar: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
      trade_count: number;
      accumulated_volume: number;
      timestamp: null;
    };
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "change": 0,
    "change_percent": 0,
    "day": {
      "open": 0,
      "high": 0,
      "low": 0,
      "close": 0,
      "volume": 0,
      "vwap": 0
    },
    "previous_day": {
      "open": 311.775,
      "high": 315,
      "low": 309.53,
      "close": 312.06,
      "volume": 70026752.782678,
      "vwap": 311.9766
    },
    "last_minute_bar": {
      "open": 0,
      "high": 0,
      "low": 0,
      "close": 0,
      "volume": 0,
      "vwap": 0,
      "trade_count": 0,
      "accumulated_volume": 0,
      "timestamp": null
    }
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:11.311Z"
}
GET/api/v1/prev-close/{ticker}$0.01

Previous trading day OHLC bar

Open, high, low, close, volume, and VWAP for a ticker's most recent completed trading day. One call returns one bar, handy for prior-close reference without setting a date range.

Example request
GET /api/v1/prev-close/AAPL
Response type (TypeScript)
interface PrevCloseResponse {
  ticker: string;
  data: {
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    vwap: number;
    trade_count: number;
    timestamp: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "open": 311.775,
    "high": 315,
    "low": 309.53,
    "close": 312.06,
    "volume": 70026752,
    "vwap": 311.9766,
    "trade_count": 764555,
    "timestamp": "2026-05-29T20:00:00.000Z"
  },
  "source": "x402stock",
  "as_of": "2026-05-29T20:00:00.000Z"
}
GET/api/v1/open-close/{ticker}$0.01

Daily open/close (+ pre/after-hours) for a specific date

Official open, close, high, low, volume, plus pre-market and after-hours prices for a ticker on a given date. Pass `?date=YYYY-MM-DD` (required).

Example request
GET /api/v1/open-close/AAPL
Response type (TypeScript)
interface OpenCloseResponse {
  ticker: string;
  data: {
    date: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    pre_market: number;
    after_hours: number;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "date": "2026-05-28",
    "open": 310.68,
    "high": 312.8,
    "low": 309.57,
    "close": 312.51,
    "volume": 49119581.02302,
    "pre_market": 310.75,
    "after_hours": 312.0521
  },
  "source": "x402stock",
  "as_of": "2026-05-28T00:00:00.000Z"
}
GET/api/v1/unified-snapshot$0.02

Multi-ticker snapshot: fetch a whole watchlist's prices in one call

Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request.

Example request
GET /api/v1/unified-snapshot
Response type (TypeScript)
interface UnifiedSnapshotResponse {
  source: string;
  as_of: string;
  count: number;
  tickers: Array<{
    ticker: string;
    name: string;
    market_status: string;
    price: number;
    change: number;
    change_percent: number;
    day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    previous_close: number;
    updated: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T18:56:09.791Z",
  "count": 3,
  "tickers": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "market_status": "open",
      "price": 307.725,
      "change": -4.33,
      "change_percent": -1.39,
      "day": {
        "open": 309.625,
        "high": 310.94,
        "low": 305.02,
        "close": 307.65,
        "volume": 28308481,
        "vwap": 307.9593
      },
      "previous_close": 312.06,
      "updated": "2026-06-01T18:56:09.196Z"
    },
    {
      "ticker": "MSFT",
      "name": "Microsoft Corp",
      "market_status": "open",
      "price": 460.72,
      "change": 10.48,
      "change_percent": 2.328,
      "day": {
        "open": 464.84,
        "high": 466.32,
        "low": 458.27,
        "close": 460.6401,
        "volume": 37048744,
        "vwap": 461.8711
      },
      "previous_close": 450.24,
      "updated": "2026-06-01T18:56:09.306Z"
    },
    {
      "ticker": "NVDA",
      "name": "Nvidia Corp",
      "market_status": "open",
      "price": 224.22,
      "change": 13.08,
      "change_percent": 6.195,
      "day": {
        "open": 215.73,
        "high": 224.8,
        "low": 215.7,
        "close": 224.24,
        "volume": 151117874,
        "vwap": 220.3888
      },
      "previous_close": 211.14,
      "updated": "2026-06-01T18:56:09.418Z"
    }
  ]
}
GET/api/v1/full-market-snapshot$0.04

Whole-market snapshot: every US ticker's current price and day change in one call

Current state of every US-listed ticker in a single call: price, day change and percent change, volume, and VWAP per symbol. The base layer for building a screener or scanning the whole market without iterating ticker by ticker. Optional `?tickers=AAPL,MSFT` to narrow and `?include_otc=true` to add OTC names.

Example request
GET /api/v1/full-market-snapshot
Response type (TypeScript)
interface FullMarketSnapshotResponse {
  source: string;
  as_of: string;
  count: number;
  tickers: Array<{
    ticker: string;
    price: number;
    change: number;
    change_percent: number;
    volume: number;
    vwap: number;
    updated: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T18:56:06.420Z",
  "count": 5,
  "tickers": [
    {
      "ticker": "MSFT",
      "price": 460.76,
      "change": 10.454999999999984,
      "change_percent": 2.3220948827292074,
      "volume": 37048744,
      "vwap": 461.8711,
      "updated": "2026-06-01T18:41:05.851Z"
    },
    {
      "ticker": "AAPL",
      "price": 307.6546,
      "change": -4.360000000000014,
      "change_percent": -1.397167211433703,
      "volume": 28308481,
      "vwap": 307.9593,
      "updated": "2026-06-01T18:41:05.103Z"
    },
    {
      "ticker": "NVDA",
      "price": 224.24,
      "change": 13.035000000000023,
      "change_percent": 6.173628871838602,
      "volume": 151117874,
      "vwap": 220.3888,
      "updated": "2026-06-01T18:41:05.845Z"
    },
    {
      "ticker": "AMZN",
      "price": 262.935,
      "change": -7.71999999999997,
      "change_percent": -2.8524977830328004,
      "volume": 35995792,
      "vwap": 263.4962,
      "updated": "2026-06-01T18:41:05.503Z"
    },
    {
      "ticker": "TSLA",
      "price": 419.48,
      "change": -16.245000000000005,
      "change_percent": -3.727712889235642,
      "volume": 30988533,
      "vwap": 422.1637,
      "updated": "2026-06-01T18:41:06.334Z"
    }
  ]
}
GET/api/v1/grouped-daily$0.02

Whole-market daily OHLC for one date

End-of-day OHLCV bars for every US-listed ticker on a single date; one call returns the entire market. Pass `?date=YYYY-MM-DD` (required).

Example request
GET /api/v1/grouped-daily
Response type (TypeScript)
interface GroupedDailyResponse {
  source: string;
  as_of: string;
  date: string;
  adjusted: boolean;
  count: number;
  results: Array<{
    ticker: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    vwap: number;
    trade_count: number;
    timestamp: string;
  }>;
  results_note: string;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-28T00:00:00.000Z",
  "date": "2026-05-28",
  "adjusted": true,
  "count": 12288,
  "results": [
    {
      "ticker": "AAPL",
      "open": 310.68,
      "high": 312.8,
      "low": 309.57,
      "close": 312.51,
      "volume": 49119581.02302,
      "vwap": 311.536,
      "trade_count": 715716,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "MSFT",
      "open": 412.975,
      "high": 429.49,
      "low": 412.67,
      "close": 426.99,
      "volume": 47245334.950684,
      "vwap": 424.7431,
      "trade_count": 825490,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "NVDA",
      "open": 211.275,
      "high": 215.5191,
      "low": 211.22,
      "close": 214.25,
      "volume": 143955744.082572,
      "vwap": 213.5048,
      "trade_count": 2161520,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "AMZN",
      "open": 272.27,
      "high": 274.5,
      "low": 267.44,
      "close": 274,
      "volume": 40629218.808792,
      "vwap": 271.6462,
      "trade_count": 552087,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "GOOGL",
      "open": 388,
      "high": 391.87,
      "low": 385.16,
      "close": 390.13,
      "volume": 24357223.394535,
      "vwap": 389.7251,
      "trade_count": 611416,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "META",
      "open": 639.495,
      "high": 643,
      "low": 629.31,
      "close": 635.29,
      "volume": 16772379.359885,
      "vwap": 634.6978,
      "trade_count": 422541,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "TSLA",
      "open": 437.615,
      "high": 443.96,
      "low": 436.3,
      "close": 442.1,
      "volume": 32434990.293689,
      "vwap": 440.7259,
      "trade_count": 927566,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "SPY",
      "open": 750.25,
      "high": 755.15,
      "low": 749.23,
      "close": 754.6,
      "volume": 41587160.538608,
      "vwap": 753.1274,
      "trade_count": 582994,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "QQQ",
      "open": 729.73,
      "high": 736.6,
      "low": 726.41,
      "close": 735.6,
      "volume": 32839950.834207,
      "vwap": 732.9367,
      "trade_count": 613414,
      "timestamp": "2026-05-28T20:00:00.000Z"
    },
    {
      "ticker": "AMD",
      "open": 499,
      "high": 527.1999,
      "low": 493.52,
      "close": 518.09,
      "volume": 31438860.820797,
      "vwap": 513.7847,
      "trade_count": 624075,
      "timestamp": "2026-05-28T20:00:00.000Z"
    }
  ],
  "results_note": "Trimmed fixture: showing 10 representative tickers. The live endpoint returns all 12288 tickers (see count)."
}

Charts & indicators

OHLC aggregates and computed technical indicators.

GET/api/v1/aggregates/{ticker}$0.02

Historical price history: OHLC bars over any timespan and date range

The stock price history endpoint. Returns historical OHLCV bars at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Use for price history, charting, backtesting, and trend analysis over any date range.

Example request
GET /api/v1/aggregates/AAPL
Response type (TypeScript)
interface AggregatesResponse {
  ticker: string;
  data: {
    bars: Array<{
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
      trade_count: number;
      timestamp: string;
    }>;
    count: number;
    adjusted: boolean;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "bars": [
      {
        "open": 278.855,
        "high": 287.22,
        "low": 278.37,
        "close": 280.14,
        "volume": 79915442.436216,
        "vwap": 282.3707,
        "trade_count": 1301741,
        "timestamp": "2026-05-01T04:00:00.000Z"
      },
      {
        "open": 279.655,
        "high": 280.63,
        "low": 274.8601,
        "close": 276.83,
        "volume": 46668430.403132,
        "vwap": 276.913,
        "trade_count": 768697,
        "timestamp": "2026-05-04T04:00:00.000Z"
      },
      {
        "open": 276.925,
        "high": 284.57,
        "low": 276.501,
        "close": 284.18,
        "volume": 49311712.249733,
        "vwap": 282.4091,
        "trade_count": 779580,
        "timestamp": "2026-05-05T04:00:00.000Z"
      },
      {
        "open": 281.915,
        "high": 288.02,
        "low": 281.07,
        "close": 287.51,
        "volume": 58321656.83813,
        "vwap": 286.3088,
        "trade_count": 839415,
        "timestamp": "2026-05-06T04:00:00.000Z"
      },
      {
        "open": 289.27,
        "high": 292.13,
        "low": 285.78,
        "close": 287.44,
        "volume": 45224300.521764,
        "vwap": 288.7495,
        "trade_count": 776365,
        "timestamp": "2026-05-07T04:00:00.000Z"
      },
      {
        "open": 290.01,
        "high": 294.76,
        "low": 290,
        "close": 293.32,
        "volume": 52692761.275784,
        "vwap": 293.1208,
        "trade_count": 790657,
        "timestamp": "2026-05-08T04:00:00.000Z"
      },
      {
        "open": 291.979,
        "high": 293.88,
        "low": 290.23,
        "close": 292.68,
        "volume": 42247285.857671,
        "vwap": 292.233,
        "trade_count": 712441,
        "timestamp": "2026-05-11T04:00:00.000Z"
      },
      {
        "open": 292.56,
        "high": 295.27,
        "low": 292.56,
        "close": 294.8,
        "volume": 45748110.69675,
        "vwap": 294.1897,
        "trade_count": 718399,
        "timestamp": "2026-05-12T04:00:00.000Z"
      },
      {
        "open": 293.5,
        "high": 300.92,
        "low": 293.5,
        "close": 298.87,
        "volume": 52684260.34243,
        "vwap": 298.1137,
        "trade_count": 777464,
        "timestamp": "2026-05-13T04:00:00.000Z"
      },
      {
        "open": 299.82,
        "high": 300.45,
        "low": 295.38,
        "close": 298.21,
        "volume": 35324922.433075,
        "vwap": 298.2822,
        "trade_count": 666775,
        "timestamp": "2026-05-14T04:00:00.000Z"
      },
      {
        "open": 297.9,
        "high": 303.2,
        "low": 296.52,
        "close": 300.23,
        "volume": 54862836.293122,
        "vwap": 300.4335,
        "trade_count": 777324,
        "timestamp": "2026-05-15T04:00:00.000Z"
      },
      {
        "open": 300.24,
        "high": 300.66,
        "low": 294.91,
        "close": 297.84,
        "volume": 34482959.706124,
        "vwap": 297.2155,
        "trade_count": 732940,
        "timestamp": "2026-05-18T04:00:00.000Z"
      },
      {
        "open": 296.97,
        "high": 300.51,
        "low": 296.35,
        "close": 298.97,
        "volume": 42243633.013323,
        "vwap": 298.3829,
        "trade_count": 640857,
        "timestamp": "2026-05-19T04:00:00.000Z"
      },
      {
        "open": 298.18,
        "high": 302.8,
        "low": 298.08,
        "close": 302.25,
        "volume": 38229843.71746,
        "vwap": 301.1324,
        "trade_count": 653718,
        "timestamp": "2026-05-20T04:00:00.000Z"
      },
      {
        "open": 301.055,
        "high": 305.54,
        "low": 300.4,
        "close": 304.99,
        "volume": 42931848.412135,
        "vwap": 304.0912,
        "trade_count": 652102,
        "timestamp": "2026-05-21T04:00:00.000Z"
      },
      {
        "open": 306.12,
        "high": 311.4,
        "low": 305.84,
        "close": 308.82,
        "volume": 43670223.711414,
        "vwap": 309.1625,
        "trade_count": 754581,
        "timestamp": "2026-05-22T04:00:00.000Z"
      },
      {
        "open": 309.56,
        "high": 311.82,
        "low": 307.67,
        "close": 308.33,
        "volume": 48000493.679542,
        "vwap": 309.4794,
        "trade_count": 761571,
        "timestamp": "2026-05-26T04:00:00.000Z"
      },
      {
        "open": 308.33,
        "high": 313.26,
        "low": 308.3,
        "close": 310.85,
        "volume": 50825646.554059,
        "vwap": 311.278,
        "trade_count": 753827,
        "timestamp": "2026-05-27T04:00:00.000Z"
      },
      {
        "open": 310.68,
        "high": 312.8,
        "low": 309.57,
        "close": 312.51,
        "volume": 49119581.02302,
        "vwap": 311.536,
        "trade_count": 715716,
        "timestamp": "2026-05-28T04:00:00.000Z"
      }
    ],
    "count": 19,
    "adjusted": true
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:21.706Z"
}
GET/api/v1/indicators/sma/{ticker}$0.01

Simple Moving Average (SMA)

Simple Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`.

Example request
GET /api/v1/indicators/sma/AAPL
Response type (TypeScript)
interface SmaResponse {
  ticker: string;
  data: {
    indicator: string;
    count: number;
    values: Array<{
      timestamp: string;
      value: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "indicator": "sma",
    "count": 30,
    "values": [
      {
        "timestamp": "2026-05-29T04:00:00.000Z",
        "value": 275.2845999999998
      },
      {
        "timestamp": "2026-05-28T04:00:00.000Z",
        "value": 274.0421999999998
      },
      {
        "timestamp": "2026-05-27T04:00:00.000Z",
        "value": 272.8765999999998
      },
      {
        "timestamp": "2026-05-26T04:00:00.000Z",
        "value": 271.7159999999998
      },
      {
        "timestamp": "2026-05-22T04:00:00.000Z",
        "value": 270.55179999999984
      },
      {
        "timestamp": "2026-05-21T04:00:00.000Z",
        "value": 269.49059999999986
      },
      {
        "timestamp": "2026-05-20T04:00:00.000Z",
        "value": 268.6069999999998
      },
      {
        "timestamp": "2026-05-19T04:00:00.000Z",
        "value": 267.7785999999998
      },
      {
        "timestamp": "2026-05-18T04:00:00.000Z",
        "value": 266.99679999999984
      },
      {
        "timestamp": "2026-05-15T04:00:00.000Z",
        "value": 266.1891999999998
      },
      {
        "timestamp": "2026-05-14T04:00:00.000Z",
        "value": 265.39039999999983
      },
      {
        "timestamp": "2026-05-13T04:00:00.000Z",
        "value": 264.67659999999984
      },
      {
        "timestamp": "2026-05-12T04:00:00.000Z",
        "value": 263.9741999999998
      },
      {
        "timestamp": "2026-05-11T04:00:00.000Z",
        "value": 263.37259999999986
      },
      {
        "timestamp": "2026-05-08T04:00:00.000Z",
        "value": 262.8025999999998
      },
      {
        "timestamp": "2026-05-07T04:00:00.000Z",
        "value": 262.3951999999999
      },
      {
        "timestamp": "2026-05-06T04:00:00.000Z",
        "value": 262.13099999999986
      },
      {
        "timestamp": "2026-05-05T04:00:00.000Z",
        "value": 261.82359999999983
      },
      {
        "timestamp": "2026-05-04T04:00:00.000Z",
        "value": 261.4635999999998
      },
      {
        "timestamp": "2026-05-01T04:00:00.000Z",
        "value": 261.2185999999998
      },
      {
        "timestamp": "2026-04-30T04:00:00.000Z",
        "value": 260.82739999999984
      },
      {
        "timestamp": "2026-04-29T04:00:00.000Z",
        "value": 260.68739999999985
      },
      {
        "timestamp": "2026-04-28T04:00:00.000Z",
        "value": 260.5615999999998
      },
      {
        "timestamp": "2026-04-27T04:00:00.000Z",
        "value": 260.26299999999986
      },
      {
        "timestamp": "2026-04-24T04:00:00.000Z",
        "value": 260.1453999999998
      },
      {
        "timestamp": "2026-04-23T04:00:00.000Z",
        "value": 260.2341999999998
      },
      {
        "timestamp": "2026-04-22T04:00:00.000Z",
        "value": 260.2391999999998
      },
      {
        "timestamp": "2026-04-21T04:00:00.000Z",
        "value": 260.26819999999987
      },
      {
        "timestamp": "2026-04-20T04:00:00.000Z",
        "value": 260.50719999999984
      },
      {
        "timestamp": "2026-04-17T04:00:00.000Z",
        "value": 260.56439999999986
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T04:00:00.000Z"
}
GET/api/v1/indicators/ema/{ticker}$0.01

Exponential Moving Average (EMA)

Exponential Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`.

Example request
GET /api/v1/indicators/ema/AAPL
Response type (TypeScript)
interface EmaResponse {
  ticker: string;
  data: {
    indicator: string;
    count: number;
    values: Array<{
      timestamp: string;
      value: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "indicator": "ema",
    "count": 30,
    "values": [
      {
        "timestamp": "2026-05-29T04:00:00.000Z",
        "value": 283.23267378398805
      },
      {
        "timestamp": "2026-05-28T04:00:00.000Z",
        "value": 282.0560482241508
      },
      {
        "timestamp": "2026-05-27T04:00:00.000Z",
        "value": 280.81302978432024
      },
      {
        "timestamp": "2026-05-26T04:00:00.000Z",
        "value": 279.5870310000068
      },
      {
        "timestamp": "2026-05-22T04:00:00.000Z",
        "value": 278.4138485918438
      },
      {
        "timestamp": "2026-05-21T04:00:00.000Z",
        "value": 277.1727811874293
      },
      {
        "timestamp": "2026-05-20T04:00:00.000Z",
        "value": 276.0373845012019
      },
      {
        "timestamp": "2026-05-19T04:00:00.000Z",
        "value": 274.96748182778157
      },
      {
        "timestamp": "2026-05-18T04:00:00.000Z",
        "value": 273.9877872085073
      },
      {
        "timestamp": "2026-05-15T04:00:00.000Z",
        "value": 273.01422750273207
      },
      {
        "timestamp": "2026-05-14T04:00:00.000Z",
        "value": 271.90337964570074
      },
      {
        "timestamp": "2026-05-13T04:00:00.000Z",
        "value": 270.8296400394028
      },
      {
        "timestamp": "2026-05-12T04:00:00.000Z",
        "value": 269.6851355512151
      },
      {
        "timestamp": "2026-05-11T04:00:00.000Z",
        "value": 268.66003904310145
      },
      {
        "timestamp": "2026-05-08T04:00:00.000Z",
        "value": 267.6796324734321
      },
      {
        "timestamp": "2026-05-07T04:00:00.000Z",
        "value": 266.63308686010276
      },
      {
        "timestamp": "2026-05-06T04:00:00.000Z",
        "value": 265.78382509929065
      },
      {
        "timestamp": "2026-05-05T04:00:00.000Z",
        "value": 264.89704245028213
      },
      {
        "timestamp": "2026-05-04T04:00:00.000Z",
        "value": 264.1099829584569
      },
      {
        "timestamp": "2026-05-01T04:00:00.000Z",
        "value": 263.5907985894143
      },
      {
        "timestamp": "2026-04-30T04:00:00.000Z",
        "value": 262.915320980819
      },
      {
        "timestamp": "2026-04-29T04:00:00.000Z",
        "value": 262.5710483677912
      },
      {
        "timestamp": "2026-04-28T04:00:00.000Z",
        "value": 262.2608870766806
      },
      {
        "timestamp": "2026-04-27T04:00:00.000Z",
        "value": 261.91602532470836
      },
      {
        "timestamp": "2026-04-24T04:00:00.000Z",
        "value": 261.6836181951046
      },
      {
        "timestamp": "2026-04-23T04:00:00.000Z",
        "value": 261.3009087336803
      },
      {
        "timestamp": "2026-04-22T04:00:00.000Z",
        "value": 260.80584378403455
      },
      {
        "timestamp": "2026-04-21T04:00:00.000Z",
        "value": 260.3011843466482
      },
      {
        "timestamp": "2026-04-20T04:00:00.000Z",
        "value": 260.061640850593
      },
      {
        "timestamp": "2026-04-17T04:00:00.000Z",
        "value": 259.53150374245394
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T04:00:00.000Z"
}
GET/api/v1/indicators/rsi/{ticker}$0.01

Relative Strength Index (RSI)

Relative Strength Index time series (momentum oscillator). Tune with `?window=` (default 14), `?timespan=`, `?series_type=`, `?limit=`.

Example request
GET /api/v1/indicators/rsi/AAPL
Response type (TypeScript)
interface RsiResponse {
  ticker: string;
  data: {
    indicator: string;
    count: number;
    values: Array<{
      timestamp: string;
      value: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "indicator": "rsi",
    "count": 30,
    "values": [
      {
        "timestamp": "2026-05-29T04:00:00.000Z",
        "value": 78.75948028742924
      },
      {
        "timestamp": "2026-05-28T04:00:00.000Z",
        "value": 79.77684858811568
      },
      {
        "timestamp": "2026-05-27T04:00:00.000Z",
        "value": 78.84060355543994
      },
      {
        "timestamp": "2026-05-26T04:00:00.000Z",
        "value": 77.36332971428146
      },
      {
        "timestamp": "2026-05-22T04:00:00.000Z",
        "value": 78.35100263380943
      },
      {
        "timestamp": "2026-05-21T04:00:00.000Z",
        "value": 76.14012802284947
      },
      {
        "timestamp": "2026-05-20T04:00:00.000Z",
        "value": 74.40364065292412
      },
      {
        "timestamp": "2026-05-19T04:00:00.000Z",
        "value": 72.15066247040778
      },
      {
        "timestamp": "2026-05-18T04:00:00.000Z",
        "value": 71.3437659942078
      },
      {
        "timestamp": "2026-05-15T04:00:00.000Z",
        "value": 75.64841302045431
      },
      {
        "timestamp": "2026-05-14T04:00:00.000Z",
        "value": 74.43796622569732
      },
      {
        "timestamp": "2026-05-13T04:00:00.000Z",
        "value": 75.57774415554718
      },
      {
        "timestamp": "2026-05-12T04:00:00.000Z",
        "value": 73.2306568207304
      },
      {
        "timestamp": "2026-05-11T04:00:00.000Z",
        "value": 71.92565891809852
      },
      {
        "timestamp": "2026-05-08T04:00:00.000Z",
        "value": 72.9221908887106
      },
      {
        "timestamp": "2026-05-07T04:00:00.000Z",
        "value": 69.29254857426058
      },
      {
        "timestamp": "2026-05-06T04:00:00.000Z",
        "value": 69.39537787499944
      },
      {
        "timestamp": "2026-05-05T04:00:00.000Z",
        "value": 67.24841687646054
      },
      {
        "timestamp": "2026-05-04T04:00:00.000Z",
        "value": 61.74867896013044
      },
      {
        "timestamp": "2026-05-01T04:00:00.000Z",
        "value": 66.41219531902064
      },
      {
        "timestamp": "2026-04-30T04:00:00.000Z",
        "value": 58.72540896592833
      },
      {
        "timestamp": "2026-04-29T04:00:00.000Z",
        "value": 57.5133489059472
      },
      {
        "timestamp": "2026-04-28T04:00:00.000Z",
        "value": 58.240108216333795
      },
      {
        "timestamp": "2026-04-27T04:00:00.000Z",
        "value": 55.223973398336206
      },
      {
        "timestamp": "2026-04-24T04:00:00.000Z",
        "value": 59.67828325665147
      },
      {
        "timestamp": "2026-04-23T04:00:00.000Z",
        "value": 62.915368106508886
      },
      {
        "timestamp": "2026-04-22T04:00:00.000Z",
        "value": 62.70931534590749
      },
      {
        "timestamp": "2026-04-21T04:00:00.000Z",
        "value": 56.69377246523444
      },
      {
        "timestamp": "2026-04-20T04:00:00.000Z",
        "value": 66.48147682949731
      },
      {
        "timestamp": "2026-04-17T04:00:00.000Z",
        "value": 64.1241274938528
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T04:00:00.000Z"
}
GET/api/v1/indicators/macd/{ticker}$0.01

Moving Average Convergence/Divergence (MACD)

MACD time series with value, signal line, and histogram. Tune with `?short_window=`, `?long_window=`, `?signal_window=`, `?timespan=`, `?series_type=`, `?limit=`.

Example request
GET /api/v1/indicators/macd/AAPL
Response type (TypeScript)
interface MacdResponse {
  ticker: string;
  data: {
    indicator: string;
    count: number;
    values: Array<{
      timestamp: string;
      value: number;
      signal: number;
      histogram: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "indicator": "macd",
    "count": 30,
    "values": [
      {
        "timestamp": "2026-05-29T04:00:00.000Z",
        "value": 10.391555804023028,
        "signal": 9.777064363321957,
        "histogram": 0.6144914407010713
      },
      {
        "timestamp": "2026-05-28T04:00:00.000Z",
        "value": 10.424239282449092,
        "signal": 9.623441503146688,
        "histogram": 0.800797779302405
      },
      {
        "timestamp": "2026-05-27T04:00:00.000Z",
        "value": 10.268511805350045,
        "signal": 9.423242058321089,
        "histogram": 0.8452697470289579
      },
      {
        "timestamp": "2026-05-26T04:00:00.000Z",
        "value": 10.08940492650214,
        "signal": 9.211924621563846,
        "histogram": 0.8774803049382953
      },
      {
        "timestamp": "2026-05-22T04:00:00.000Z",
        "value": 9.970626256750847,
        "signal": 8.992554545329272,
        "histogram": 0.9780717114215758
      },
      {
        "timestamp": "2026-05-21T04:00:00.000Z",
        "value": 9.624103281806356,
        "signal": 8.748036617473877,
        "histogram": 0.8760666643324786
      },
      {
        "timestamp": "2026-05-20T04:00:00.000Z",
        "value": 9.431790636960043,
        "signal": 8.529019951390756,
        "histogram": 0.9027706855692889
      },
      {
        "timestamp": "2026-05-19T04:00:00.000Z",
        "value": 9.32812190645501,
        "signal": 8.303327279998435,
        "histogram": 1.0247946264565757
      },
      {
        "timestamp": "2026-05-18T04:00:00.000Z",
        "value": 9.39408477178921,
        "signal": 8.047128623384289,
        "histogram": 1.3469561484049208
      },
      {
        "timestamp": "2026-05-15T04:00:00.000Z",
        "value": 9.456690686862489,
        "signal": 7.71038958628306,
        "histogram": 1.7463011005794271
      },
      {
        "timestamp": "2026-05-14T04:00:00.000Z",
        "value": 9.155701281201573,
        "signal": 7.273814311138202,
        "histogram": 1.8818869700633707
      },
      {
        "timestamp": "2026-05-13T04:00:00.000Z",
        "value": 8.84402823934056,
        "signal": 6.803342568622359,
        "histogram": 2.040685670718201
      },
      {
        "timestamp": "2026-05-12T04:00:00.000Z",
        "value": 8.250379691520322,
        "signal": 6.293171150942808,
        "histogram": 1.9572085405775148
      },
      {
        "timestamp": "2026-05-11T04:00:00.000Z",
        "value": 7.787062749516679,
        "signal": 5.803869015798428,
        "histogram": 1.9831937337182504
      },
      {
        "timestamp": "2026-05-08T04:00:00.000Z",
        "value": 7.298290030820908,
        "signal": 5.308070582368865,
        "histogram": 1.9902194484520432
      },
      {
        "timestamp": "2026-05-07T04:00:00.000Z",
        "value": 6.503117723964522,
        "signal": 4.810515720255854,
        "histogram": 1.692602003708668
      },
      {
        "timestamp": "2026-05-06T04:00:00.000Z",
        "value": 5.992288812682887,
        "signal": 4.387365219328686,
        "histogram": 1.6049235933542008
      },
      {
        "timestamp": "2026-05-05T04:00:00.000Z",
        "value": 5.245997528644466,
        "signal": 3.986134320990136,
        "histogram": 1.2598632076543304
      },
      {
        "timestamp": "2026-05-04T04:00:00.000Z",
        "value": 4.556207598418723,
        "signal": 3.671168519076553,
        "histogram": 0.8850390793421701
      },
      {
        "timestamp": "2026-05-01T04:00:00.000Z",
        "value": 4.357876340589996,
        "signal": 3.44990874924101,
        "histogram": 0.9079675913489864
      },
      {
        "timestamp": "2026-04-30T04:00:00.000Z",
        "value": 3.704328061098181,
        "signal": 3.2229168514037627,
        "histogram": 0.4814112096944183
      },
      {
        "timestamp": "2026-04-29T04:00:00.000Z",
        "value": 3.7112634852944666,
        "signal": 3.102564048980158,
        "histogram": 0.6086994363143088
      },
      {
        "timestamp": "2026-04-28T04:00:00.000Z",
        "value": 3.7862790487553184,
        "signal": 2.9503891899015806,
        "histogram": 0.8358898588537378
      },
      {
        "timestamp": "2026-04-27T04:00:00.000Z",
        "value": 3.771971218136173,
        "signal": 2.741416725188146,
        "histogram": 1.0305544929480268
      },
      {
        "timestamp": "2026-04-24T04:00:00.000Z",
        "value": 4.014480551154804,
        "signal": 2.483778101951139,
        "histogram": 1.5307024492036652
      },
      {
        "timestamp": "2026-04-23T04:00:00.000Z",
        "value": 3.914345473645369,
        "signal": 2.101102489650223,
        "histogram": 1.813242983995146
      },
      {
        "timestamp": "2026-04-22T04:00:00.000Z",
        "value": 3.488291676916731,
        "signal": 1.6477917436514364,
        "histogram": 1.8404999332652945
      },
      {
        "timestamp": "2026-04-21T04:00:00.000Z",
        "value": 2.9202260428824616,
        "signal": 1.1876667603351128,
        "histogram": 1.7325592825473488
      },
      {
        "timestamp": "2026-04-20T04:00:00.000Z",
        "value": 2.8654189820913416,
        "signal": 0.7545269396982756,
        "histogram": 2.110892042393066
      },
      {
        "timestamp": "2026-04-17T04:00:00.000Z",
        "value": 2.0532773302148257,
        "signal": 0.22680392910000896,
        "histogram": 1.8264734011148167
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T04:00:00.000Z"
}
GET/api/v1/technicals/{ticker}$0.03

Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones

Use for a quick momentum or trend read on a US-listed stock. Returns the latest RSI (14) with overbought, oversold, or neutral zone, SMA 50 and EMA 20 with price position, and MACD with signal cross state, alongside the current delayed price. Factual indicator readings, not buy or sell guidance.

Example request
GET /api/v1/technicals/AAPL
Response type (TypeScript)
interface TechnicalsResponse {
  ticker: string;
  data: {
    price: {
      last: number;
      change_percent: number;
    };
    rsi_14: {
      value: number;
      zone: string;
    };
    sma_50: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    ema_20: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    macd: {
      value: number;
      signal: number;
      histogram: number;
      position: string;
    };
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "price": {
      "last": 0,
      "change_percent": 0
    },
    "rsi_14": {
      "value": 78.56,
      "zone": "overbought"
    },
    "sma_50": {
      "value": 275.2846,
      "price_vs_percent": -100,
      "position": "below"
    },
    "ema_20": {
      "value": 297.8868,
      "price_vs_percent": -100,
      "position": "below"
    },
    "macd": {
      "value": 10.3911,
      "signal": 9.7764,
      "histogram": 0.6147,
      "position": "above_signal"
    }
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:55.017Z"
}

Movers & screening

The day's gainers and losers and a whole-market screener.

GET/api/v1/gainers$0.02

Top gaining US stocks today

The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker.

Example request
GET /api/v1/gainers
Response type (TypeScript)
interface GainersResponse {
  source: string;
  as_of: string;
  direction: string;
  count: number;
  tickers: unknown[];
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:37.936Z",
  "direction": "gainers",
  "count": 0,
  "tickers": []
}
GET/api/v1/losers$0.02

Top losing US stocks today

The day's biggest percentage losers across US equities, with current and previous-day OHLCV per ticker.

Example request
GET /api/v1/losers
Response type (TypeScript)
interface LosersResponse {
  source: string;
  as_of: string;
  direction: string;
  count: number;
  tickers: unknown[];
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:40.131Z",
  "direction": "losers",
  "count": 0,
  "tickers": []
}
GET/api/v1/screener$0.03

Screen the whole US market: filter every ticker by price, percent move, and volume in one call

Screen the entire US stock market in one call. Filter every listed ticker by price range, percent change, and minimum volume, then sort by percent move, price, or volume. Tune with ?min_price=, ?max_price=, ?min_change_percent=, ?max_change_percent=, ?min_volume=, ?sort=, ?order=, ?limit=. Built for agents scanning for setups without iterating ticker by ticker.

Example request
GET /api/v1/screener
Response type (TypeScript)
interface ScreenerResponse {
  source: string;
  as_of: string;
  universe: number;
  matched: number;
  sort: string;
  order: string;
  count: number;
  results: Array<{
    ticker: string;
    price: number;
    change: number;
    change_percent: number;
    volume: number;
    vwap: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T21:38:06.059Z",
  "universe": 12673,
  "matched": 187,
  "sort": "change_percent",
  "order": "desc",
  "count": 10,
  "results": [
    {
      "ticker": "TGHL",
      "price": 1.31,
      "change": 0.9922,
      "change_percent": 285.27889591719384,
      "volume": 131960751,
      "vwap": 1.7252
    },
    {
      "ticker": "HKIT",
      "price": 4.86,
      "change": 3.3899999999999997,
      "change_percent": 232.19178082191775,
      "volume": 89981165,
      "vwap": 5.9313
    },
    {
      "ticker": "JZ",
      "price": 2.16,
      "change": 1.4311,
      "change_percent": 196.5796703296703,
      "volume": 45825909,
      "vwap": 1.7737
    },
    {
      "ticker": "ANY",
      "price": 5.121,
      "change": 3.18,
      "change_percent": 167.3684210526316,
      "volume": 125545357,
      "vwap": 3.7929
    },
    {
      "ticker": "DBGI",
      "price": 1.23,
      "change": 0.7461,
      "change_percent": 154.1847489150651,
      "volume": 57289463,
      "vwap": 1.1674
    },
    {
      "ticker": "ABTS",
      "price": 2.2278,
      "change": 1.2183,
      "change_percent": 122.84965211253405,
      "volume": 99832479,
      "vwap": 2.3479
    },
    {
      "ticker": "AIM",
      "price": 0.8359,
      "change": 0.4281,
      "change_percent": 104.97793035801864,
      "volume": 357360098,
      "vwap": 0.8299
    },
    {
      "ticker": "SUUN",
      "price": 1.57,
      "change": 0.7355,
      "change_percent": 85.07807981492192,
      "volume": 20242535,
      "vwap": 1.2914
    },
    {
      "ticker": "OPTU",
      "price": 1.2,
      "change": 0.5418,
      "change_percent": 82.31540565177757,
      "volume": 124554120,
      "vwap": 1.2648
    },
    {
      "ticker": "HUBC",
      "price": 0.4576,
      "change": 0.1988,
      "change_percent": 76.13941018766755,
      "volume": 411622196,
      "vwap": 0.4918
    }
  ]
}

Options

Options chains and per-contract history.

GET/api/v1/options/{ticker}$0.02

Options chain for a US stock: every contract with strike, expiration, and call/put type

The options chain for a US-listed underlying: every listed contract with its strike price, expiration date, call or put type, exercise style, contract ticker, and shares per contract. Filter with ?expiration_date=YYYY-MM-DD, ?contract_type=call|put, ?strike_price=, ?expired=true|false, and ?limit=. Use to discover which option contracts exist before pulling price history.

Example request
GET /api/v1/options/AAPL
Response type (TypeScript)
interface OptionsResponse {
  ticker: string;
  data: {
    count: number;
    contracts: Array<{
      contract_ticker: string;
      type: string;
      strike: number;
      expiration_date: string;
      exercise_style: string;
      shares_per_contract: number;
      primary_exchange: string;
      cfi: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 12,
    "contracts": [
      {
        "contract_ticker": "O:AAPL260601C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-01",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260603C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-03",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260605C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-05",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260608C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-08",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260610C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-10",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260612C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-12",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260615C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-15",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260618C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-18",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260626C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-06-26",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260702C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-07-02",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260710C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-07-10",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      },
      {
        "contract_ticker": "O:AAPL260717C00310000",
        "type": "call",
        "strike": 310,
        "expiration_date": "2026-07-17",
        "exercise_style": "american",
        "shares_per_contract": 100,
        "primary_exchange": "BATO",
        "cfi": "OCASPS"
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-06-01T23:53:59.701Z"
}
GET/api/v1/options-aggregates/{contract}$0.02

Historical OHLC bars for a single option contract

Historical OHLCV price bars for one option contract over any date range. Pass the option contract ticker in the path (e.g. O:AAPL260620C00150000) and tune ?multiplier=, ?timespan=minute|hour|day|week|month, ?from= and ?to= (optional; default to the trailing year), ?adjusted=, ?sort=, and ?limit=. Use for backtesting or charting a single option's price history.

Example request
GET /api/v1/options-aggregates/O:AAPL260116C00150000
Response type (TypeScript)
interface OptionsAggregatesResponse {
  ticker: string;
  data: {
    bars: Array<{
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
      trade_count: number;
      timestamp: string;
    }>;
    count: number;
    adjusted: boolean;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "O:AAPL260618C00310000",
  "data": {
    "bars": [
      {
        "open": 0.6,
        "high": 0.64,
        "low": 0.54,
        "close": 0.64,
        "volume": 316,
        "vwap": 0.5794,
        "trade_count": 39,
        "timestamp": "2026-04-01T04:00:00.000Z"
      },
      {
        "open": 0.6,
        "high": 0.65,
        "low": 0.5,
        "close": 0.58,
        "volume": 98,
        "vwap": 0.5945,
        "trade_count": 25,
        "timestamp": "2026-04-02T04:00:00.000Z"
      },
      {
        "open": 0.58,
        "high": 0.91,
        "low": 0.58,
        "close": 0.74,
        "volume": 200,
        "vwap": 0.7481,
        "trade_count": 21,
        "timestamp": "2026-04-06T04:00:00.000Z"
      },
      {
        "open": 0.6,
        "high": 0.8,
        "low": 0.41,
        "close": 0.58,
        "volume": 164,
        "vwap": 0.4929,
        "trade_count": 56,
        "timestamp": "2026-04-07T04:00:00.000Z"
      },
      {
        "open": 0.6,
        "high": 0.75,
        "low": 0.58,
        "close": 0.63,
        "volume": 172,
        "vwap": 0.6535,
        "trade_count": 36,
        "timestamp": "2026-04-08T04:00:00.000Z"
      },
      {
        "open": 0.68,
        "high": 0.78,
        "low": 0.55,
        "close": 0.78,
        "volume": 238,
        "vwap": 0.6644,
        "trade_count": 63,
        "timestamp": "2026-04-09T04:00:00.000Z"
      },
      {
        "open": 0.66,
        "high": 0.85,
        "low": 0.63,
        "close": 0.63,
        "volume": 158,
        "vwap": 0.7602,
        "trade_count": 28,
        "timestamp": "2026-04-10T04:00:00.000Z"
      },
      {
        "open": 0.63,
        "high": 0.63,
        "low": 0.5,
        "close": 0.57,
        "volume": 197,
        "vwap": 0.5549,
        "trade_count": 38,
        "timestamp": "2026-04-13T04:00:00.000Z"
      },
      {
        "open": 0.72,
        "high": 0.85,
        "low": 0.59,
        "close": 0.69,
        "volume": 192,
        "vwap": 0.6771,
        "trade_count": 46,
        "timestamp": "2026-04-14T04:00:00.000Z"
      },
      {
        "open": 0.65,
        "high": 1.42,
        "low": 0.65,
        "close": 1.4,
        "volume": 933,
        "vwap": 1.2092,
        "trade_count": 159,
        "timestamp": "2026-04-15T04:00:00.000Z"
      },
      {
        "open": 1.47,
        "high": 1.47,
        "low": 1.05,
        "close": 1.06,
        "volume": 545,
        "vwap": 1.1522,
        "trade_count": 115,
        "timestamp": "2026-04-16T04:00:00.000Z"
      },
      {
        "open": 1.23,
        "high": 1.97,
        "low": 1.23,
        "close": 1.49,
        "volume": 1108,
        "vwap": 1.6481,
        "trade_count": 198,
        "timestamp": "2026-04-17T04:00:00.000Z"
      },
      {
        "open": 1.5,
        "high": 2.03,
        "low": 1.5,
        "close": 1.65,
        "volume": 1329,
        "vwap": 1.801,
        "trade_count": 169,
        "timestamp": "2026-04-20T04:00:00.000Z"
      },
      {
        "open": 1.61,
        "high": 1.61,
        "low": 0.9,
        "close": 1.08,
        "volume": 738,
        "vwap": 1.0966,
        "trade_count": 194,
        "timestamp": "2026-04-21T04:00:00.000Z"
      },
      {
        "open": 1.15,
        "high": 1.84,
        "low": 1,
        "close": 1.68,
        "volume": 6718,
        "vwap": 1.7308,
        "trade_count": 362,
        "timestamp": "2026-04-22T04:00:00.000Z"
      },
      {
        "open": 1.81,
        "high": 1.92,
        "low": 1.33,
        "close": 1.46,
        "volume": 911,
        "vwap": 1.5463,
        "trade_count": 270,
        "timestamp": "2026-04-23T04:00:00.000Z"
      },
      {
        "open": 1.25,
        "high": 1.37,
        "low": 1.13,
        "close": 1.29,
        "volume": 820,
        "vwap": 1.2563,
        "trade_count": 106,
        "timestamp": "2026-04-24T04:00:00.000Z"
      },
      {
        "open": 1.07,
        "high": 1.09,
        "low": 0.85,
        "close": 0.98,
        "volume": 1760,
        "vwap": 0.9515,
        "trade_count": 260,
        "timestamp": "2026-04-27T04:00:00.000Z"
      },
      {
        "open": 1.3,
        "high": 1.33,
        "low": 1.05,
        "close": 1.11,
        "volume": 320,
        "vwap": 1.1394,
        "trade_count": 102,
        "timestamp": "2026-04-28T04:00:00.000Z"
      },
      {
        "open": 0.85,
        "high": 1.2,
        "low": 0.85,
        "close": 1.07,
        "volume": 551,
        "vwap": 1.0772,
        "trade_count": 126,
        "timestamp": "2026-04-29T04:00:00.000Z"
      }
    ],
    "count": 20,
    "adjusted": true
  },
  "source": "x402stock",
  "as_of": "2026-06-01T23:54:27.889Z"
}

Short signals

Short interest, short volume, fails-to-deliver, and the squeeze bundle.

GET/api/v1/short-interest/{ticker}$0.02

Bi-weekly short interest and days-to-cover for a stock

The exchange-reported short-interest history for a US-listed stock: total shares sold short, average daily volume, and days-to-cover for each bi-weekly FINRA settlement date, most recent first. A core short-squeeze and bearish-positioning signal. Tune how many settlements to return with `?limit=` (default 12).

Example request
GET /api/v1/short-interest/AAPL
Response type (TypeScript)
interface ShortInterestResponse {
  ticker: string;
  data: {
    count: number;
    latest: {
      settlement_date: string;
      short_interest: number;
      avg_daily_volume: number;
      days_to_cover: number;
    };
    history: Array<{
      settlement_date: string;
      short_interest: number;
      avg_daily_volume: number;
      days_to_cover: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 6,
    "latest": {
      "settlement_date": "2026-05-15",
      "short_interest": 138782718,
      "avg_daily_volume": 50565316,
      "days_to_cover": 2.74
    },
    "history": [
      {
        "settlement_date": "2026-05-15",
        "short_interest": 138782718,
        "avg_daily_volume": 50565316,
        "days_to_cover": 2.74
      },
      {
        "settlement_date": "2026-04-30",
        "short_interest": 134675274,
        "avg_daily_volume": 45944025,
        "days_to_cover": 2.93
      },
      {
        "settlement_date": "2026-04-15",
        "short_interest": 134422787,
        "avg_daily_volume": 39674165,
        "days_to_cover": 3.39
      },
      {
        "settlement_date": "2026-03-31",
        "short_interest": 126771284,
        "avg_daily_volume": 42873045,
        "days_to_cover": 2.96
      },
      {
        "settlement_date": "2026-03-13",
        "short_interest": 124192030,
        "avg_daily_volume": 38121907,
        "days_to_cover": 3.26
      },
      {
        "settlement_date": "2026-02-27",
        "short_interest": 129553812,
        "avg_daily_volume": 39794651,
        "days_to_cover": 3.26
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-15T00:00:00.000Z"
}
GET/api/v1/short-volume/{ticker}$0.02

Daily short-sale volume and short-volume ratio for a stock

Daily short-sale volume for a US-listed stock: total volume, short volume, exempt and non-exempt short volume, the short-volume ratio, and a per-venue breakdown (NYSE, Nasdaq, ADF), most recent day first. A higher-frequency read on shorting pressure than bi-weekly short interest. Tune with `?limit=` (default 20).

Example request
GET /api/v1/short-volume/AAPL
Response type (TypeScript)
interface ShortVolumeResponse {
  ticker: string;
  data: {
    count: number;
    latest: {
      date: string;
      total_volume: number;
      short_volume: number;
      exempt_volume: number;
      non_exempt_volume: number;
      short_volume_ratio: number;
      venues: {
        nyse: number;
        nasdaq_carteret: number;
        nasdaq_chicago: number;
        adf: number;
      };
    };
    history: Array<{
      date: string;
      total_volume: number;
      short_volume: number;
      exempt_volume: number;
      non_exempt_volume: number;
      short_volume_ratio: number;
      venues: {
        nyse: number;
        nasdaq_carteret: number;
        nasdaq_chicago: number;
        adf: number;
      };
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 10,
    "latest": {
      "date": "2026-05-29",
      "total_volume": 14864822.80445,
      "short_volume": 6083612.891307,
      "exempt_volume": 164350,
      "non_exempt_volume": 5919262.891307,
      "short_volume_ratio": 40.93,
      "venues": {
        "nyse": 1103183,
        "nasdaq_carteret": 4930548,
        "nasdaq_chicago": 49880,
        "adf": 0
      }
    },
    "history": [
      {
        "date": "2026-05-29",
        "total_volume": 14864822.80445,
        "short_volume": 6083612.891307,
        "exempt_volume": 164350,
        "non_exempt_volume": 5919262.891307,
        "short_volume_ratio": 40.93,
        "venues": {
          "nyse": 1103183,
          "nasdaq_carteret": 4930548,
          "nasdaq_chicago": 49880,
          "adf": 0
        }
      },
      {
        "date": "2026-05-28",
        "total_volume": 15018623.508142,
        "short_volume": 5530909.388436,
        "exempt_volume": 48084,
        "non_exempt_volume": 5482825.388436,
        "short_volume_ratio": 36.83,
        "venues": {
          "nyse": 1168764,
          "nasdaq_carteret": 4320372,
          "nasdaq_chicago": 41772,
          "adf": 0
        }
      },
      {
        "date": "2026-05-27",
        "total_volume": 20717490.359599,
        "short_volume": 11705767.246896,
        "exempt_volume": 33578,
        "non_exempt_volume": 11672189.246896,
        "short_volume_ratio": 56.5,
        "venues": {
          "nyse": 7467219,
          "nasdaq_carteret": 4186330,
          "nasdaq_chicago": 52217,
          "adf": 0
        }
      },
      {
        "date": "2026-05-26",
        "total_volume": 13174731.653709,
        "short_volume": 4775159.922933,
        "exempt_volume": 24407,
        "non_exempt_volume": 4750752.922933,
        "short_volume_ratio": 36.24,
        "venues": {
          "nyse": 227566,
          "nasdaq_carteret": 4493202,
          "nasdaq_chicago": 54391,
          "adf": 0
        }
      },
      {
        "date": "2026-05-22",
        "total_volume": 15322158.123659,
        "short_volume": 7859585.858503,
        "exempt_volume": 67975,
        "non_exempt_volume": 7791610.858503,
        "short_volume_ratio": 51.3,
        "venues": {
          "nyse": 2260425,
          "nasdaq_carteret": 5525431,
          "nasdaq_chicago": 73729,
          "adf": 0
        }
      },
      {
        "date": "2026-05-21",
        "total_volume": 11020225.815672,
        "short_volume": 5388400.001,
        "exempt_volume": 22802,
        "non_exempt_volume": 5365598.001,
        "short_volume_ratio": 48.9,
        "venues": {
          "nyse": 764116,
          "nasdaq_carteret": 4572214,
          "nasdaq_chicago": 52069,
          "adf": 0
        }
      },
      {
        "date": "2026-05-20",
        "total_volume": 12124878.48879,
        "short_volume": 3750645.262622,
        "exempt_volume": 61919,
        "non_exempt_volume": 3688726.262622,
        "short_volume_ratio": 30.93,
        "venues": {
          "nyse": 108699,
          "nasdaq_carteret": 3578798,
          "nasdaq_chicago": 63147,
          "adf": 0
        }
      },
      {
        "date": "2026-05-19",
        "total_volume": 12816897.122638,
        "short_volume": 6146647.560578,
        "exempt_volume": 20908,
        "non_exempt_volume": 6125739.560578,
        "short_volume_ratio": 47.96,
        "venues": {
          "nyse": 268800,
          "nasdaq_carteret": 5839292,
          "nasdaq_chicago": 38554,
          "adf": 0
        }
      },
      {
        "date": "2026-05-18",
        "total_volume": 9691579.407584,
        "short_volume": 3040885.069775,
        "exempt_volume": 65539,
        "non_exempt_volume": 2975346.069775,
        "short_volume_ratio": 31.38,
        "venues": {
          "nyse": 77500,
          "nasdaq_carteret": 2928542,
          "nasdaq_chicago": 34843,
          "adf": 0
        }
      },
      {
        "date": "2026-05-15",
        "total_volume": 16275822.859084,
        "short_volume": 8714049.111124,
        "exempt_volume": 41327,
        "non_exempt_volume": 8672722.111124,
        "short_volume_ratio": 53.54,
        "venues": {
          "nyse": 2421731,
          "nasdaq_carteret": 6196844,
          "nasdaq_chicago": 95473,
          "adf": 0
        }
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-29T00:00:00.000Z"
}
GET/api/v1/fails-to-deliver/{ticker}$0.02

Fails-to-deliver history for a stock: settlement-fail share volume by date

Settlement fails-to-deliver for a US-listed stock from the SEC's semi-monthly data: the aggregate shares that failed to deliver on each settlement date, with the reference price, most recent first. A niche short-pressure and squeeze signal. ?limit= records (default 30). Sourced from SEC EDGAR.

Example request
GET /api/v1/fails-to-deliver/AAPL
Response type (TypeScript)
interface FailsToDeliverResponse {
  source: string;
  as_of: string;
  symbol: string;
  periods_read: number;
  count: number;
  note: string;
  fails: Array<{
    settlement_date: string;
    cusip: string;
    symbol: string;
    fails: number;
    description: string;
    price: number;
  }>;
}
Example response (click to expand)
{
  "source": "sec_edgar",
  "as_of": "2026-05-14T00:00:00.000Z",
  "symbol": "GME",
  "periods_read": 2,
  "count": 10,
  "note": "QUANTITY (FAILS) is the aggregate net balance of shares that failed to deliver as of the settlement date.",
  "fails": [
    {
      "settlement_date": "2026-05-14",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 443681,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 22.08
    },
    {
      "settlement_date": "2026-05-13",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 182600,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 22.37
    },
    {
      "settlement_date": "2026-05-12",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 145638,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.17
    },
    {
      "settlement_date": "2026-05-11",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 171556,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 24.28
    },
    {
      "settlement_date": "2026-05-08",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 19894,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.97
    },
    {
      "settlement_date": "2026-05-05",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 130264,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 23.84
    },
    {
      "settlement_date": "2026-05-04",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 52755,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 26.53
    },
    {
      "settlement_date": "2026-04-30",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 1348,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 24.52
    },
    {
      "settlement_date": "2026-04-29",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 21429,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 25.09
    },
    {
      "settlement_date": "2026-04-24",
      "cusip": "36467W109",
      "symbol": "GME",
      "fails": 1395,
      "description": "GAMESTOP CORP (HLDG CO) CL A",
      "price": 25.01
    }
  ]
}
GET/api/v1/squeeze/{ticker}$0.04

Short-squeeze bundle: short interest, daily short volume, and fails-to-deliver in one call

The short-squeeze picture for a US stock in one call: bi-weekly short interest with days-to-cover, daily short-sale volume with short-volume ratio, and settlement fails-to-deliver, plus a computed signal pulling the headline gauges together. Replaces three separate calls (short-interest + short-volume + fails-to-deliver) at a lower combined price. Sections degrade independently.

Example request
GET /api/v1/squeeze/AAPL

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

Forex

Currency-pair price history and previous-day bars.

GET/api/v1/forex/{pair}/aggregates$0.02

Forex price history: OHLC bars for a currency pair over any timespan and date range

Historical OHLCV bars for a foreign-exchange pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD or USD-JPY. Use for FX charting, backtesting, and macro/rate analysis.

Example request
GET /api/v1/forex/BTC-USD/aggregates
Response type (TypeScript)
interface ForexAggregatesResponse {
  ticker: string;
  data: {
    bars: Array<{
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
      trade_count: number;
      timestamp: string;
    }>;
    count: number;
    adjusted: boolean;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "C:EURUSD",
  "data": {
    "bars": [
      {
        "open": 1.17293,
        "high": 1.1786,
        "low": 1.1714,
        "close": 1.1719,
        "volume": 182880,
        "vwap": 1.1743,
        "trade_count": 182880,
        "timestamp": "2026-05-01T00:00:00.000Z"
      },
      {
        "open": 1.17448,
        "high": 1.17491,
        "low": 1.1723,
        "close": 1.1725,
        "volume": 5744,
        "vwap": 1.1732,
        "trade_count": 5744,
        "timestamp": "2026-05-03T00:00:00.000Z"
      },
      {
        "open": 1.17252,
        "high": 1.17388,
        "low": 1.1679,
        "close": 1.16913,
        "volume": 224865,
        "vwap": 1.171,
        "trade_count": 224865,
        "timestamp": "2026-05-04T00:00:00.000Z"
      },
      {
        "open": 1.16912,
        "high": 1.17253,
        "low": 1.1675,
        "close": 1.17145,
        "volume": 187569,
        "vwap": 1.1694,
        "trade_count": 187569,
        "timestamp": "2026-05-05T00:00:00.000Z"
      },
      {
        "open": 1.17144,
        "high": 1.17966,
        "low": 1.171,
        "close": 1.1746,
        "volume": 235359,
        "vwap": 1.1748,
        "trade_count": 235359,
        "timestamp": "2026-05-06T00:00:00.000Z"
      },
      {
        "open": 1.17314,
        "high": 1.1788,
        "low": 1.1723,
        "close": 1.1785,
        "volume": 175303,
        "vwap": 1.1759,
        "trade_count": 175303,
        "timestamp": "2026-05-08T00:00:00.000Z"
      },
      {
        "open": 1.17475,
        "high": 1.177,
        "low": 1.17457,
        "close": 1.17669,
        "volume": 5151,
        "vwap": 1.1763,
        "trade_count": 5151,
        "timestamp": "2026-05-10T00:00:00.000Z"
      },
      {
        "open": 1.17777,
        "high": 1.1778,
        "low": 1.1721,
        "close": 1.17348,
        "volume": 177980,
        "vwap": 1.1745,
        "trade_count": 177980,
        "timestamp": "2026-05-12T00:00:00.000Z"
      },
      {
        "open": 1.17346,
        "high": 1.1742,
        "low": 1.1694,
        "close": 1.1715,
        "volume": 185295,
        "vwap": 1.1715,
        "trade_count": 185295,
        "timestamp": "2026-05-13T00:00:00.000Z"
      },
      {
        "open": 1.17155,
        "high": 1.17214,
        "low": 1.1659,
        "close": 1.16616,
        "volume": 197220,
        "vwap": 1.1697,
        "trade_count": 197220,
        "timestamp": "2026-05-14T00:00:00.000Z"
      },
      {
        "open": 1.16614,
        "high": 1.16634,
        "low": 1.1615,
        "close": 1.1623,
        "volume": 217652,
        "vwap": 1.1635,
        "trade_count": 217652,
        "timestamp": "2026-05-15T00:00:00.000Z"
      },
      {
        "open": 1.16197,
        "high": 1.16237,
        "low": 1.161,
        "close": 1.16132,
        "volume": 5505,
        "vwap": 1.1618,
        "trade_count": 5505,
        "timestamp": "2026-05-17T00:00:00.000Z"
      },
      {
        "open": 1.16137,
        "high": 1.16612,
        "low": 1.1607,
        "close": 1.16544,
        "volume": 225484,
        "vwap": 1.1637,
        "trade_count": 225484,
        "timestamp": "2026-05-18T00:00:00.000Z"
      },
      {
        "open": 1.16544,
        "high": 1.16558,
        "low": 1.15896,
        "close": 1.16066,
        "volume": 215736,
        "vwap": 1.1621,
        "trade_count": 215736,
        "timestamp": "2026-05-19T00:00:00.000Z"
      },
      {
        "open": 1.16066,
        "high": 1.16442,
        "low": 1.1581,
        "close": 1.16245,
        "volume": 225951,
        "vwap": 1.1607,
        "trade_count": 225951,
        "timestamp": "2026-05-20T00:00:00.000Z"
      },
      {
        "open": 1.16245,
        "high": 1.1636,
        "low": 1.1575,
        "close": 1.16176,
        "volume": 188718,
        "vwap": 1.1612,
        "trade_count": 188718,
        "timestamp": "2026-05-21T00:00:00.000Z"
      },
      {
        "open": 1.16175,
        "high": 1.16188,
        "low": 1.1586,
        "close": 1.16031,
        "volume": 179340,
        "vwap": 1.1606,
        "trade_count": 179340,
        "timestamp": "2026-05-22T00:00:00.000Z"
      },
      {
        "open": 1.16393,
        "high": 1.1646,
        "low": 1.16284,
        "close": 1.16417,
        "volume": 6109,
        "vwap": 1.1641,
        "trade_count": 6109,
        "timestamp": "2026-05-24T00:00:00.000Z"
      },
      {
        "open": 1.16413,
        "high": 1.1653,
        "low": 1.1629,
        "close": 1.16355,
        "volume": 136787,
        "vwap": 1.1641,
        "trade_count": 136787,
        "timestamp": "2026-05-25T00:00:00.000Z"
      },
      {
        "open": 1.1635,
        "high": 1.1645,
        "low": 1.16118,
        "close": 1.16364,
        "volume": 171791,
        "vwap": 1.1632,
        "trade_count": 171791,
        "timestamp": "2026-05-26T00:00:00.000Z"
      },
      {
        "open": 1.16361,
        "high": 1.1661,
        "low": 1.1615,
        "close": 1.16173,
        "volume": 194314,
        "vwap": 1.1638,
        "trade_count": 194314,
        "timestamp": "2026-05-27T00:00:00.000Z"
      },
      {
        "open": 1.16172,
        "high": 1.16613,
        "low": 1.1584,
        "close": 1.16521,
        "volume": 197655,
        "vwap": 1.1627,
        "trade_count": 197655,
        "timestamp": "2026-05-28T00:00:00.000Z"
      }
    ],
    "count": 22,
    "adjusted": true
  },
  "source": "x402stock",
  "as_of": "2026-06-03T01:44:00.871Z"
}
GET/api/v1/forex/{pair}/prev-close$0.01

Previous day OHLC bar for a currency pair

Open, high, low, close, volume, and VWAP for a foreign-exchange pair's most recent completed trading day. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD. One call returns one bar for a quick prior-close reference.

Example request
GET /api/v1/forex/BTC-USD/prev-close
Response type (TypeScript)
interface ForexPrevCloseResponse {
  ticker: string;
  data: {
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    vwap: number;
    trade_count: number;
    timestamp: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "C:EURUSD",
  "data": {
    "open": 1.16352,
    "high": 1.1656,
    "low": 1.1612,
    "close": 1.16211,
    "volume": 167388,
    "vwap": 1.1639,
    "trade_count": 167388,
    "timestamp": "2026-06-02T23:59:59.999Z"
  },
  "source": "x402stock",
  "as_of": "2026-06-02T23:59:59.999Z"
}

Crypto spot

Crypto-spot price history, previous UTC-day candles, and daily open/close.

GET/api/v1/crypto/{pair}/aggregates$0.02

Crypto price history: OHLC bars for a spot pair over any timespan and date range

Historical OHLCV bars for a major-coin crypto spot pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD or ETH-USD. Aggregated centralized-market spot — for Hyperliquid-listed token spot use /api/v1/spot, for perps use /api/v1/perps.

Example request
GET /api/v1/crypto/BTC-USD/aggregates
Response type (TypeScript)
interface CryptoAggregatesResponse {
  ticker: string;
  data: {
    bars: Array<{
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
      trade_count: number;
      timestamp: string;
    }>;
    count: number;
    adjusted: boolean;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "X:BTCUSD",
  "data": {
    "bars": [
      {
        "open": 76305.78,
        "high": 78961.14,
        "low": 76275.01,
        "close": 78234.05,
        "volume": 11852.46625517,
        "vwap": 77956.4358,
        "trade_count": 986918,
        "timestamp": "2026-05-01T00:00:00.000Z"
      },
      {
        "open": 78235.3,
        "high": 79200,
        "low": 77974,
        "close": 78629,
        "volume": 3783.47246405,
        "vwap": 78454.3441,
        "trade_count": 325211,
        "timestamp": "2026-05-02T00:00:00.000Z"
      },
      {
        "open": 78660,
        "high": 79428.6,
        "low": 78041,
        "close": 78558.89,
        "volume": 4380.42752258,
        "vwap": 78672.8729,
        "trade_count": 339992,
        "timestamp": "2026-05-03T00:00:00.000Z"
      },
      {
        "open": 78547.4,
        "high": 80770.7,
        "low": 78169,
        "close": 79852.37,
        "volume": 16448.85089936,
        "vwap": 79729.0463,
        "trade_count": 930858,
        "timestamp": "2026-05-04T00:00:00.000Z"
      },
      {
        "open": 79852.37,
        "high": 81799.6,
        "low": 79763,
        "close": 80907.72,
        "volume": 12211.2314954,
        "vwap": 81180.9838,
        "trade_count": 791845,
        "timestamp": "2026-05-05T00:00:00.000Z"
      },
      {
        "open": 80900.1,
        "high": 82818,
        "low": 80663,
        "close": 81438.1,
        "volume": 11499.79547722,
        "vwap": 81713.6351,
        "trade_count": 821760,
        "timestamp": "2026-05-06T00:00:00.000Z"
      },
      {
        "open": 81438.11,
        "high": 81709.17,
        "low": 79368.7,
        "close": 80005.38,
        "volume": 9567.76834312,
        "vwap": 80405.0186,
        "trade_count": 842973,
        "timestamp": "2026-05-07T00:00:00.000Z"
      },
      {
        "open": 80005.38,
        "high": 80492,
        "low": 79145,
        "close": 80188.82,
        "volume": 5342.90353922,
        "vwap": 80027.9992,
        "trade_count": 485370,
        "timestamp": "2026-05-08T00:00:00.000Z"
      },
      {
        "open": 80196.9,
        "high": 81065.32,
        "low": 80102,
        "close": 80655.96,
        "volume": 3414.27521082,
        "vwap": 80482.5739,
        "trade_count": 382157,
        "timestamp": "2026-05-09T00:00:00.000Z"
      },
      {
        "open": 80670.1,
        "high": 82450,
        "low": 80237,
        "close": 82199.99,
        "volume": 6517.97492197,
        "vwap": 81212.7534,
        "trade_count": 462343,
        "timestamp": "2026-05-10T00:00:00.000Z"
      },
      {
        "open": 82171.9,
        "high": 82379,
        "low": 80400,
        "close": 81727.06,
        "volume": 9920.75024672,
        "vwap": 81435.5378,
        "trade_count": 773515,
        "timestamp": "2026-05-11T00:00:00.000Z"
      },
      {
        "open": 81730.6,
        "high": 81778,
        "low": 79802.51,
        "close": 80484.72,
        "volume": 7862.70788893,
        "vwap": 80701.3526,
        "trade_count": 745293,
        "timestamp": "2026-05-12T00:00:00.000Z"
      },
      {
        "open": 80484.72,
        "high": 81293.93,
        "low": 78699.83,
        "close": 79288.26,
        "volume": 10419.92343343,
        "vwap": 79707.1096,
        "trade_count": 569901,
        "timestamp": "2026-05-13T00:00:00.000Z"
      },
      {
        "open": 79292.1,
        "high": 82066.22,
        "low": 78867,
        "close": 81079.39,
        "volume": 16536.47359658,
        "vwap": 80919.8963,
        "trade_count": 730976,
        "timestamp": "2026-05-14T00:00:00.000Z"
      },
      {
        "open": 81070.1,
        "high": 81650,
        "low": 78570,
        "close": 79058.51,
        "volume": 9281.40297212,
        "vwap": 79665.4745,
        "trade_count": 838818,
        "timestamp": "2026-05-15T00:00:00.000Z"
      },
      {
        "open": 79062.6,
        "high": 79183,
        "low": 77598,
        "close": 78105.45,
        "volume": 4791.0481082,
        "vwap": 78392.3258,
        "trade_count": 806590,
        "timestamp": "2026-05-16T00:00:00.000Z"
      },
      {
        "open": 78122.9,
        "high": 78624,
        "low": 76602,
        "close": 77407.59,
        "volume": 4066.53769086,
        "vwap": 77935.2898,
        "trade_count": 337191,
        "timestamp": "2026-05-17T00:00:00.000Z"
      },
      {
        "open": 77406.57,
        "high": 77780,
        "low": 75992,
        "close": 76943.98,
        "volume": 12060.58334105,
        "vwap": 76715.3036,
        "trade_count": 841307,
        "timestamp": "2026-05-18T00:00:00.000Z"
      },
      {
        "open": 76943.96,
        "high": 77440,
        "low": 76061.12,
        "close": 76767.48,
        "volume": 8264.8186178,
        "vwap": 76728.1299,
        "trade_count": 634368,
        "timestamp": "2026-05-19T00:00:00.000Z"
      },
      {
        "open": 76756.3,
        "high": 77877,
        "low": 76433.52,
        "close": 77475.99,
        "volume": 9206.48568904,
        "vwap": 77258.6532,
        "trade_count": 627211,
        "timestamp": "2026-05-20T00:00:00.000Z"
      },
      {
        "open": 77475.98,
        "high": 78243,
        "low": 76619.02,
        "close": 77547.62,
        "volume": 8642.33733632,
        "vwap": 77530.5703,
        "trade_count": 588918,
        "timestamp": "2026-05-21T00:00:00.000Z"
      },
      {
        "open": 77547.25,
        "high": 77914,
        "low": 75266.73,
        "close": 75443.91,
        "volume": 8069.99601194,
        "vwap": 76681.6867,
        "trade_count": 560504,
        "timestamp": "2026-05-22T00:00:00.000Z"
      },
      {
        "open": 75456.6,
        "high": 77448,
        "low": 74027,
        "close": 76650,
        "volume": 9036.39498356,
        "vwap": 75621.8542,
        "trade_count": 525280,
        "timestamp": "2026-05-23T00:00:00.000Z"
      },
      {
        "open": 76670.1,
        "high": 77604,
  
… (truncated — call the endpoint for the full response)
GET/api/v1/crypto/{pair}/prev-close$0.01

Previous UTC-day OHLC candle for a crypto spot pair

Crypto trades 24/7, so there is no session close: this returns the previous UTC calendar day's full OHLCV candle (00:00–24:00 UTC) for a spot pair — open, high, low, close, volume, and VWAP. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD. One call returns yesterday's daily bar.

Example request
GET /api/v1/crypto/BTC-USD/prev-close
Response type (TypeScript)
interface CryptoPrevCloseResponse {
  ticker: string;
  data: {
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    vwap: number;
    trade_count: number;
    timestamp: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "X:BTCUSD",
  "data": {
    "open": 71314.43,
    "high": 71406,
    "low": 66099.58,
    "close": 66704,
    "volume": 31286.97032105,
    "vwap": 68318.2858,
    "trade_count": 1587492,
    "timestamp": "2026-06-02T23:59:59.999Z"
  },
  "source": "x402stock",
  "as_of": "2026-06-02T23:59:59.999Z"
}
GET/api/v1/crypto/{pair}/open-close$0.01

Daily open and close for a crypto spot pair on a specific date

The official UTC open and close price for a crypto spot pair on a given date. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD, and the date via `?date=YYYY-MM-DD` (required). Crypto trades 24/7, so this is the UTC-day open/close.

Example request
GET /api/v1/crypto/BTC-USD/open-close
Response type (TypeScript)
interface CryptoOpenCloseResponse {
  ticker: string;
  data: {
    date: string;
    open: number;
    close: number;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "X:BTCUSD",
  "data": {
    "date": "2026-05-15",
    "open": 81070.1,
    "close": 79058.51
  },
  "source": "x402stock",
  "as_of": "2026-05-15T00:00:00.000Z"
}

On-chain perps & spot (Hyperliquid)

Funding, open interest, order books, and candles for on-chain perps and spot tokens.

GET/api/v1/perps$0.02

Every on-chain perp in one call: funding rate, open interest, mark/oracle price, 24h volume

Live state of every perpetual-futures market in one call: per coin the mark and oracle price, hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. Native crypto-derivatives data — funding and open interest are perp-only, absent from any spot feed. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps
Response type (TypeScript)
interface HlPerpsResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  count: number;
  perps: Array<{
    coin: string;
    max_leverage: number;
    mark_price: number;
    oracle_price: number;
    mid_price: number;
    prev_day_price: number;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
    open_interest: number;
    day_volume_usd: number;
    day_volume_base: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:48:20.210Z",
  "venue": "hyperliquid",
  "market": "perp",
  "count": 230,
  "perps": [
    {
      "coin": "BTC",
      "max_leverage": 40,
      "mark_price": 63700,
      "oracle_price": 63728,
      "mid_price": 63703.5,
      "prev_day_price": 64231,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0002526362,
      "open_interest": 31320.32022,
      "day_volume_usd": 6714881110.838834,
      "day_volume_base": 105924.1805199999
    },
    {
      "coin": "ETH",
      "max_leverage": 25,
      "mark_price": 1767.2,
      "oracle_price": 1767.8,
      "mid_price": 1767.25,
      "prev_day_price": 1815.8,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0002149564,
      "open_interest": 629870.6864,
      "day_volume_usd": 1488672095.318889,
      "day_volume_base": 839194.5139000022
    },
    {
      "coin": "ATOM",
      "max_leverage": 5,
      "mark_price": 1.7975,
      "oracle_price": 1.8005,
      "mid_price": 1.797,
      "prev_day_price": 1.856,
      "funding_rate_hourly": 0.0000087934,
      "funding_apr_percent": 7.703,
      "premium": -0.000888642,
      "open_interest": 1434660,
      "day_volume_usd": 637955.3548200001,
      "day_volume_base": 353646.7600000002
    },
    {
      "coin": "MATIC",
      "max_leverage": 20,
      "mark_price": 0.37621,
      "oracle_price": 0.3754,
      "mid_price": null,
      "prev_day_price": 0.37621,
      "funding_rate_hourly": 0,
      "funding_apr_percent": 0,
      "premium": null,
      "open_interest": 0,
      "day_volume_usd": 0,
      "day_volume_base": 0
    },
    {
      "coin": "DYDX",
      "max_leverage": 5,
      "mark_price": 0.16094,
      "oracle_price": 0.161,
      "mid_price": 0.16102,
      "prev_day_price": 0.17845,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": 0,
      "open_interest": 32905411.40000001,
      "day_volume_usd": 1074031.3981369997,
      "day_volume_base": 6404406.599999999
    },
    {
      "coin": "SOL",
      "max_leverage": 20,
      "mark_price": 68.589,
      "oracle_price": 68.63,
      "mid_price": 68.6025,
      "prev_day_price": 71.64,
      "funding_rate_hourly": -0.000007669,
      "funding_apr_percent": -6.718,
      "premium": -0.0001544514,
      "open_interest": 3850352.48,
      "day_volume_usd": 466050886.4522603,
      "day_volume_base": 6714043.1000000015
    },
    {
      "coin": "AVAX",
      "max_leverage": 10,
      "mark_price": 7.6599,
      "oracle_price": 7.665,
      "mid_price": 7.662,
      "prev_day_price": 8.0711,
      "funding_rate_hourly": -0.0000013995,
      "funding_apr_percent": -1.226,
      "premium": -0.00024788,
      "open_interest": 5426783.38,
      "day_volume_usd": 7670687.509031001,
      "day_volume_base": 984304.1099999998
    },
    {
      "coin": "BNB",
      "max_leverage": 10,
      "mark_price": 602.77,
      "oracle_price": 603.08,
      "mid_price": 602.825,
      "prev_day_price": 621.35,
      "funding_rate_hourly": 0.0000063884,
      "funding_apr_percent": 5.5962,
      "premium": -0.0003167076,
      "open_interest": 51329.868,
      "day_volume_usd": 24724436.712979987,
      "day_volume_base": 40970.148
    },
    {
      "coin": "APE",
      "max_leverage": 5,
      "mark_price": 0.13532,
      "oracle_price": 0.13545,
      "mid_price": 0.13536,
      "prev_day_price": 0.14809,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": 0,
      "open_interest": 7533318.2,
      "day_volume_usd": 939138.065815,
      "day_volume_base": 6827426.600000001
    },
    {
      "coin": "OP",
      "max_leverage": 5,
      "mark_price": 0.1113,
      "oracle_price": 0.11142,
      "mid_price": 0.11135,
      "prev_day_price": 0.12298,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0000897505,
      "open_interest": 29277466.4,
      "day_volume_usd": 1611116.842007,
      "day_volume_base": 14499771.199999996
    },
    {
      "coin": "LTC",
      "max_leverage": 10,
      "mark_price": 45.517,
      "oracle_price": 45.545,
      "mid_price": 45.523,
      "prev_day_price": 47.195,
      "funding_rate_hourly": 0.0000088717,
      "funding_apr_percent": 7.7716,
      "premium": -0.0003315402,
      "open_interest": 218504.9,
      "day_volume_usd": 5628037.719929999,
      "day_volume_base": 122422.58
    },
    {
      "coin": "ARB",
      "max_leverage": 10,
      "mark_price": 0.0887,
      "oracle_price": 0.08881,
      "mid_price": 0.08871,
      "prev_day_price": 0.09307,
      "funding_rate_hourly": -0.0000149453,
      "funding_apr_percent": -13.0921,
      "premium": -0.0004503997,
      "open_interest": 54115626.400000006,
      "day_volume_usd": 3985359.9677260015,
      "day_volume_base": 44348456.2
    },
    {
      "coin": "DOGE",
      "max_leverage": 10,
      "mark_price": 0.0882,
      "oracle_price": 0.08825,
      "mid_price": 0.088234,
      "prev_day_price": 0.0915,
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0000793201,
      "open_interest": 302098886,
      "day_volume_usd": 23202670.482565995,
      "day_volume_base": 260371414
    },
    {
      "coin": "INJ",
      "max_leverage": 5,
      "mark_price": 5.4214,
      "oracle_price": 5.4275,
      "mid_price": 5.4217,
      "prev_day_price": 6.5116,
      "funding_rate_hourly": -0.000015081,
      "funding_apr_percent": -13.211,
      "premium": -0.0005730078,
      "open_interest": 991908.8,
      "day_volume_usd": 7042200.993400005,
      "day_volume_base": 1204018.1
    },
    {
      "coin": "SUI",
      "max_leverage": 10,
      "mark_price": 0.76371,
      "oracle_price": 0.76435,
      "mid_price": 0.76374,
      "prev_day_price": 0.82565,
      "funding_rate_hourly": -0.0000157518,
      "funding_apr_percent": -13.7986
… (truncated — call the endpoint for the full response)
GET/api/v1/perps/{coin}$0.01

Single on-chain perp: funding, open interest, mark/oracle price, 24h volume

Live state of one perpetual-futures market by coin (e.g. BTC, ETH, SOL): mark and oracle price, current hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. The single-coin read for funding and open-interest signals. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/BTC
Response type (TypeScript)
interface HlPerpResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  data: {
    coin: string;
    max_leverage: number;
    mark_price: number;
    oracle_price: number;
    mid_price: number;
    prev_day_price: number;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
    open_interest: number;
    day_volume_usd: number;
    day_volume_base: number;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:48:55.506Z",
  "venue": "hyperliquid",
  "market": "perp",
  "data": {
    "coin": "BTC",
    "max_leverage": 40,
    "mark_price": 63696,
    "oracle_price": 63727,
    "mid_price": 63703.5,
    "prev_day_price": 64231,
    "funding_rate_hourly": 0.0000125,
    "funding_apr_percent": 10.95,
    "premium": -0.0002683321,
    "open_interest": 31317.9911,
    "day_volume_usd": 6715014671.538914,
    "day_volume_base": 105926.2760499999
  }
}
GET/api/v1/perps/funding/{coin}$0.01

Historical funding-rate series for an on-chain perp

The historical hourly funding-rate series for one perpetual-futures market, each point with the funding rate, annualized APR, and premium, most recent first. Pass the coin in the path (e.g. BTC) and tune the window with `?hours=` (default 24, max 720) or an explicit `?start=`/`?end=` epoch-ms range. Use to study funding regimes and carry. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/funding/BTC
Response type (TypeScript)
interface HlFundingResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  count: number;
  history: Array<{
    time: string;
    funding_rate_hourly: number;
    funding_apr_percent: number;
    premium: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:49:12.778Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "count": 24,
  "history": [
    {
      "time": "2026-06-04T00:00:00.032Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003727867
    },
    {
      "time": "2026-06-04T01:00:00.002Z",
      "funding_rate_hourly": 0.0000116035,
      "funding_apr_percent": 10.1647,
      "premium": -0.0004071721
    },
    {
      "time": "2026-06-04T02:00:00.047Z",
      "funding_rate_hourly": 0.0000067587,
      "funding_apr_percent": 5.9206,
      "premium": -0.0004459304
    },
    {
      "time": "2026-06-04T03:00:00.080Z",
      "funding_rate_hourly": 0.0000085033,
      "funding_apr_percent": 7.4489,
      "premium": -0.0004319739
    },
    {
      "time": "2026-06-04T04:00:00.010Z",
      "funding_rate_hourly": 0.0000060531,
      "funding_apr_percent": 5.3025,
      "premium": -0.0004515753
    },
    {
      "time": "2026-06-04T05:00:00.076Z",
      "funding_rate_hourly": 0.0000042721,
      "funding_apr_percent": 3.7424,
      "premium": -0.0004658231
    },
    {
      "time": "2026-06-04T06:00:00.007Z",
      "funding_rate_hourly": 0.0000034197,
      "funding_apr_percent": 2.9957,
      "premium": -0.0004726428
    },
    {
      "time": "2026-06-04T07:00:00.059Z",
      "funding_rate_hourly": 0.000010114,
      "funding_apr_percent": 8.8599,
      "premium": -0.0004190877
    },
    {
      "time": "2026-06-04T08:00:00.004Z",
      "funding_rate_hourly": 0.0000034241,
      "funding_apr_percent": 2.9995,
      "premium": -0.0004726071
    },
    {
      "time": "2026-06-04T09:00:00.027Z",
      "funding_rate_hourly": 0.0000052245,
      "funding_apr_percent": 4.5767,
      "premium": -0.0004582042
    },
    {
      "time": "2026-06-04T10:00:00.015Z",
      "funding_rate_hourly": 0.0000066623,
      "funding_apr_percent": 5.8362,
      "premium": -0.0004467019
    },
    {
      "time": "2026-06-04T11:00:00.025Z",
      "funding_rate_hourly": -0.0000045162,
      "funding_apr_percent": -3.9562,
      "premium": -0.0005361298
    },
    {
      "time": "2026-06-04T12:00:00.078Z",
      "funding_rate_hourly": -0.000010187,
      "funding_apr_percent": -8.9238,
      "premium": -0.0005814957
    },
    {
      "time": "2026-06-04T13:00:00.006Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003922656
    },
    {
      "time": "2026-06-04T14:00:00.014Z",
      "funding_rate_hourly": 0.0000039124,
      "funding_apr_percent": 3.4273,
      "premium": -0.0004687007
    },
    {
      "time": "2026-06-04T15:00:00.006Z",
      "funding_rate_hourly": 7.613e-7,
      "funding_apr_percent": 0.6669,
      "premium": -0.0004939092
    },
    {
      "time": "2026-06-04T16:00:00.043Z",
      "funding_rate_hourly": 0.0000049885,
      "funding_apr_percent": 4.3699,
      "premium": -0.0004600917
    },
    {
      "time": "2026-06-04T17:00:00.015Z",
      "funding_rate_hourly": -6.88e-7,
      "funding_apr_percent": -0.6027,
      "premium": -0.000505504
    },
    {
      "time": "2026-06-04T18:00:00.073Z",
      "funding_rate_hourly": 0.0000069786,
      "funding_apr_percent": 6.1133,
      "premium": -0.0004441714
    },
    {
      "time": "2026-06-04T19:00:00.000Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003740205
    },
    {
      "time": "2026-06-04T20:00:00.031Z",
      "funding_rate_hourly": 0.0000125,
      "funding_apr_percent": 10.95,
      "premium": -0.0003675202
    },
    {
      "time": "2026-06-04T21:00:00.063Z",
      "funding_rate_hourly": 0.0000055109,
      "funding_apr_percent": 4.8275,
      "premium": -0.0004559132
    },
    {
      "time": "2026-06-04T22:00:00.059Z",
      "funding_rate_hourly": 0.0000036956,
      "funding_apr_percent": 3.2373,
      "premium": -0.0004704349
    },
    {
      "time": "2026-06-04T23:00:00.046Z",
      "funding_rate_hourly": 0.0000069637,
      "funding_apr_percent": 6.1002,
      "premium": -0.0004442908
    }
  ]
}
GET/api/v1/perps/predicted-funding$0.02

Predicted next-period funding for every coin across major perp venues

Predicted next-period funding rate for each coin across venues — on-chain plus centralized perp venues (Hyperliquid, Binance, Bybit) — each with the funding interval and next funding time. A cross-exchange funding-arbitrage signal in one call: compare where a coin's funding is richest or cheapest. Free on-chain DEX data, no key.

Example request
GET /api/v1/perps/predicted-funding
Response type (TypeScript)
interface HlPredictedFundingResponse {
  source: string;
  as_of: string;
  count: number;
  coins: Array<{
    coin: string;
    venues: Array<{
      venue: string;
      funding_rate: number;
      funding_interval_hours: number;
      next_funding_time: string;
    }>;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:49:40.892Z",
  "count": 230,
  "coins": [
    {
      "coin": "0G",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00002245,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00003862,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "2Z",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00002836,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AAVE",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00002791,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.0000242,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ACE",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ADA",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00004721,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": -0.0000194712,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00017157,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AERO",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00018039,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AI",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0,
          "funding_interval_hours": null,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AI16Z",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0,
          "funding_interval_hours": null,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        }
      ]
    },
    {
      "coin": "AIXBT",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000017609,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": 0.00005,
          "funding_interval_hours": 4,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ALGO",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": -0.00021936,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        },
        {
          "venue": "HlPerp",
          "funding_rate": 0.0000125,
          "funding_interval_hours": 1,
          "next_funding_time": "2026-06-04T23:00:00.000Z"
        },
        {
          "venue": "BybitPerp",
          "funding_rate": -0.00034483,
          "funding_interval_hours": 8,
          "next_funding_time": "2026-06-05T00:00:00.000Z"
        }
      ]
    },
    {
      "coin": "ALT",
      "venues": [
        {
          "venue": "BinPerp",
          "funding_rate": 0.00002611,
          "fundi
… (truncated — call the endpoint for the full response)
GET/api/v1/perps/orderbook/{coin}$0.01

L2 order book (aggregated price levels) for an on-chain perp

The level-2 order book for one perpetual-futures market: aggregated bid and ask price levels, each with size and the number of resting orders, as of the book timestamp. Pass the coin in the path (e.g. BTC). Use to gauge liquidity, spread, and depth. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/orderbook/BTC
Response type (TypeScript)
interface HlOrderBookResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  bids: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
  asks: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:50:02.108Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "bids": [
    {
      "price": 63736,
      "size": 36.46718,
      "orders": 78
    },
    {
      "price": 63735,
      "size": 0.85526,
      "orders": 8
    },
    {
      "price": 63734,
      "size": 6.34854,
      "orders": 11
    },
    {
      "price": 63733,
      "size": 1.41491,
      "orders": 6
    },
    {
      "price": 63732,
      "size": 1.22006,
      "orders": 9
    },
    {
      "price": 63731,
      "size": 7.91279,
      "orders": 10
    },
    {
      "price": 63730,
      "size": 2.14113,
      "orders": 5
    },
    {
      "price": 63729,
      "size": 5.14867,
      "orders": 6
    },
    {
      "price": 63728,
      "size": 8.17165,
      "orders": 14
    },
    {
      "price": 63727,
      "size": 0.82584,
      "orders": 4
    },
    {
      "price": 63726,
      "size": 20.75114,
      "orders": 8
    },
    {
      "price": 63725,
      "size": 29.34051,
      "orders": 10
    },
    {
      "price": 63724,
      "size": 18.57028,
      "orders": 9
    },
    {
      "price": 63723,
      "size": 7.808,
      "orders": 6
    },
    {
      "price": 63722,
      "size": 2.92204,
      "orders": 3
    },
    {
      "price": 63721,
      "size": 10.96273,
      "orders": 9
    },
    {
      "price": 63720,
      "size": 16.60816,
      "orders": 5
    },
    {
      "price": 63719,
      "size": 1.57917,
      "orders": 3
    },
    {
      "price": 63718,
      "size": 14.64938,
      "orders": 9
    },
    {
      "price": 63717,
      "size": 20.19743,
      "orders": 4
    }
  ],
  "asks": [
    {
      "price": 63737,
      "size": 0.62793,
      "orders": 7
    },
    {
      "price": 63738,
      "size": 0.00034,
      "orders": 2
    },
    {
      "price": 63739,
      "size": 0.00017,
      "orders": 1
    },
    {
      "price": 63740,
      "size": 0.00041,
      "orders": 2
    },
    {
      "price": 63741,
      "size": 0.00017,
      "orders": 1
    },
    {
      "price": 63742,
      "size": 0.00041,
      "orders": 2
    },
    {
      "price": 63743,
      "size": 0.00317,
      "orders": 2
    },
    {
      "price": 63744,
      "size": 0.16207,
      "orders": 3
    },
    {
      "price": 63745,
      "size": 0.26706,
      "orders": 4
    },
    {
      "price": 63746,
      "size": 0.81334,
      "orders": 5
    },
    {
      "price": 63747,
      "size": 0.5273,
      "orders": 5
    },
    {
      "price": 63748,
      "size": 0.00047,
      "orders": 2
    },
    {
      "price": 63749,
      "size": 0.78534,
      "orders": 3
    },
    {
      "price": 63750,
      "size": 2.25263,
      "orders": 8
    },
    {
      "price": 63751,
      "size": 2.04021,
      "orders": 7
    },
    {
      "price": 63752,
      "size": 0.3685,
      "orders": 7
    },
    {
      "price": 63753,
      "size": 3.41925,
      "orders": 11
    },
    {
      "price": 63754,
      "size": 3.16462,
      "orders": 5
    },
    {
      "price": 63755,
      "size": 5.94561,
      "orders": 14
    },
    {
      "price": 63756,
      "size": 5.64526,
      "orders": 12
    }
  ]
}
GET/api/v1/perps/candles/{coin}$0.02

Historical OHLCV candles for an on-chain perp at any interval

Historical OHLCV candles for one perpetual-futures market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, and more) over a time window. Pass the coin in the path (e.g. BTC) and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or an explicit `?start=`/`?end=` epoch-ms range. Free on-chain DEX data (venue: Hyperliquid), no key.

Example request
GET /api/v1/perps/candles/BTC
Response type (TypeScript)
interface HlCandlesResponse {
  source: string;
  as_of: string;
  venue: string;
  coin: string;
  interval: string;
  count: number;
  candles: Array<{
    start: string;
    end: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    trades: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-04T23:50:19.922Z",
  "venue": "hyperliquid",
  "coin": "BTC",
  "interval": "1h",
  "count": 25,
  "candles": [
    {
      "start": "2026-06-03T23:00:00.000Z",
      "end": "2026-06-03T23:59:59.999Z",
      "open": 64884,
      "high": 64959,
      "low": 64061,
      "close": 64118,
      "volume": 6882.91177,
      "trades": 61403
    },
    {
      "start": "2026-06-04T00:00:00.000Z",
      "end": "2026-06-04T00:59:59.999Z",
      "open": 64118,
      "high": 64413,
      "low": 62980,
      "close": 63310,
      "volume": 8198.336,
      "trades": 81013
    },
    {
      "start": "2026-06-04T01:00:00.000Z",
      "end": "2026-06-04T01:59:59.999Z",
      "open": 63312,
      "high": 63496,
      "low": 62076,
      "close": 62148,
      "volume": 7562.7258,
      "trades": 80193
    },
    {
      "start": "2026-06-04T02:00:00.000Z",
      "end": "2026-06-04T02:59:59.999Z",
      "open": 62148,
      "high": 63603,
      "low": 61350,
      "close": 63190,
      "volume": 12606.95184,
      "trades": 106026
    },
    {
      "start": "2026-06-04T03:00:00.000Z",
      "end": "2026-06-04T03:59:59.999Z",
      "open": 63189,
      "high": 64508,
      "low": 63181,
      "close": 64342,
      "volume": 6377.23223,
      "trades": 59416
    },
    {
      "start": "2026-06-04T04:00:00.000Z",
      "end": "2026-06-04T04:59:59.999Z",
      "open": 64341,
      "high": 64752,
      "low": 64240,
      "close": 64374,
      "volume": 3053.52815,
      "trades": 35171
    },
    {
      "start": "2026-06-04T05:00:00.000Z",
      "end": "2026-06-04T05:59:59.999Z",
      "open": 64374,
      "high": 64374,
      "low": 63615,
      "close": 63927,
      "volume": 3157.62682,
      "trades": 43362
    },
    {
      "start": "2026-06-04T06:00:00.000Z",
      "end": "2026-06-04T06:59:59.999Z",
      "open": 63927,
      "high": 64468,
      "low": 63861,
      "close": 63994,
      "volume": 1740.94493,
      "trades": 34276
    },
    {
      "start": "2026-06-04T07:00:00.000Z",
      "end": "2026-06-04T07:59:59.999Z",
      "open": 63997,
      "high": 64046,
      "low": 63456,
      "close": 63566,
      "volume": 2520.10491,
      "trades": 37047
    },
    {
      "start": "2026-06-04T08:00:00.000Z",
      "end": "2026-06-04T08:59:59.999Z",
      "open": 63565,
      "high": 63878,
      "low": 63212,
      "close": 63605,
      "volume": 2963.29414,
      "trades": 39171
    },
    {
      "start": "2026-06-04T09:00:00.000Z",
      "end": "2026-06-04T09:59:59.999Z",
      "open": 63606,
      "high": 63618,
      "low": 62680,
      "close": 63230,
      "volume": 3677.18068,
      "trades": 48086
    },
    {
      "start": "2026-06-04T10:00:00.000Z",
      "end": "2026-06-04T10:59:59.999Z",
      "open": 63231,
      "high": 63250,
      "low": 62266,
      "close": 62386,
      "volume": 3965.43342,
      "trades": 49150
    },
    {
      "start": "2026-06-04T11:00:00.000Z",
      "end": "2026-06-04T11:59:59.999Z",
      "open": 62387,
      "high": 62802,
      "low": 62160,
      "close": 62514,
      "volume": 3136.88503,
      "trades": 43466
    },
    {
      "start": "2026-06-04T12:00:00.000Z",
      "end": "2026-06-04T12:59:59.999Z",
      "open": 62515,
      "high": 63959,
      "low": 62360,
      "close": 63736,
      "volume": 6547.47893,
      "trades": 57801
    },
    {
      "start": "2026-06-04T13:00:00.000Z",
      "end": "2026-06-04T13:59:59.999Z",
      "open": 63736,
      "high": 64244,
      "low": 63045,
      "close": 64184,
      "volume": 7128.15872,
      "trades": 66804
    },
    {
      "start": "2026-06-04T14:00:00.000Z",
      "end": "2026-06-04T14:59:59.999Z",
      "open": 64185,
      "high": 64464,
      "low": 63750,
      "close": 63925,
      "volume": 3342.89059,
      "trades": 51352
    },
    {
      "start": "2026-06-04T15:00:00.000Z",
      "end": "2026-06-04T15:59:59.999Z",
      "open": 63923,
      "high": 64380,
      "low": 63662,
      "close": 63862,
      "volume": 2198.99678,
      "trades": 41590
    },
    {
      "start": "2026-06-04T16:00:00.000Z",
      "end": "2026-06-04T16:59:59.999Z",
      "open": 63861,
      "high": 63891,
      "low": 63418,
      "close": 63536,
      "volume": 2992.87915,
      "trades": 40647
    },
    {
      "start": "2026-06-04T17:00:00.000Z",
      "end": "2026-06-04T17:59:59.999Z",
      "open": 63536,
      "high": 63692,
      "low": 62935,
      "close": 63518,
      "volume": 4189.18918,
      "trades": 46711
    },
    {
      "start": "2026-06-04T18:00:00.000Z",
      "end": "2026-06-04T18:59:59.999Z",
      "open": 63514,
      "high": 64117,
      "low": 63108,
      "close": 63788,
      "volume": 3507.95321,
      "trades": 44543
    },
    {
      "start": "2026-06-04T19:00:00.000Z",
      "end": "2026-06-04T19:59:59.999Z",
      "open": 63787,
      "high": 64138,
      "low": 63499,
      "close": 63596,
      "volume": 3834.17274,
      "trades": 39491
    },
    {
      "start": "2026-06-04T20:00:00.000Z",
      "end": "2026-06-04T20:59:59.999Z",
      "open": 63597,
      "high": 63630,
      "low": 63138,
      "close": 63615,
      "volume": 3656.90641,
      "trades": 34927
    },
    {
      "start": "2026-06-04T21:00:00.000Z",
      "end": "2026-06-04T21:59:59.999Z",
      "open": 63615,
      "high": 63848,
      "low": 63071,
      "close": 63255,
      "volume": 3799.27999,
      "trades": 37484
    },
    {
      "start": "2026-06-04T22:00:00.000Z",
      "end": "2026-06-04T22:59:59.999Z",
      "open": 63255,
      "high": 63753,
      "low": 63160,
      "close": 63715,
      "volume": 2400.61581,
      "trades": 32915
    },
    {
      "start": "2026-06-04T23:00:00.000Z",
      "end": "2026-06-04T23:59:59.999Z",
      "open": 63715,
      "high": 63830,
      "low": 63352,
      "close": 63764,
      "volume": 1884.8456,
      "trades": 21505
    }
  ]
}
GET/api/v1/perps/overview/{coin}$0.03

On-chain perp 360 in one call: live context, funding history, order book, and price candles

Everything about one on-chain perpetual-futures market in one call: live mark/oracle price with funding rate and open interest, recent funding history, the L2 order book, and OHLCV candles. Pass the coin in the path (e.g. BTC, ETH). Replaces four calls (perps/{coin} + funding + orderbook + candles) at a lower combined price. Free DEX data (venue: Hyperliquid). Sections degrade independently.

Example request
GET /api/v1/perps/overview/BTC

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

GET/api/v1/spot$0.02

Every Hyperliquid spot token in one call: price, 24h volume, supply, market cap

Live on-chain spot prices for every token on the Hyperliquid DEX (HYPE, PURR, and hundreds more), quoted in USDC: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap — sorted by 24h volume. Spot, not derivatives: for funding/open interest use /api/v1/perps; for major-coin fiat prices use /api/v1/crypto.

Example request
GET /api/v1/spot
Response type (TypeScript)
interface HlSpotAllResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  count: number;
  pairs: Array<{
    pair: string;
    id: string;
    base_token: string;
    quote_token: string;
    canonical: boolean;
    mark_price: number;
    mid_price: number;
    prev_day_price: number;
    day_volume_usd: number;
    day_volume_base: number;
    circulating_supply: number;
    total_supply: number;
    market_cap_usd: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.450Z",
  "venue": "hyperliquid",
  "market": "spot",
  "count": 5,
  "pairs": [
    {
      "pair": "HYPE/USDC",
      "id": "@107",
      "base_token": "HYPE",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 62.87,
      "mid_price": 62.8335,
      "prev_day_price": 74.581,
      "day_volume_usd": 414627195.68830013,
      "day_volume_base": 6077950.050000002,
      "circulating_supply": 298358462.35153913,
      "total_supply": 999191084.3483734,
      "market_cap_usd": 18757796528.04
    },
    {
      "pair": "UBTC/USDC",
      "id": "@142",
      "base_token": "UBTC",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 63750,
      "mid_price": 63749.5,
      "prev_day_price": 63325,
      "day_volume_usd": 96012122.16522998,
      "day_volume_base": 1515.65301,
      "circulating_supply": 20999999.997555982,
      "total_supply": 20999999.997555982,
      "market_cap_usd": 1338749999844.19
    },
    {
      "pair": "UZEC/USDC",
      "id": "@272",
      "base_token": "UZEC",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 454.61,
      "mid_price": 454.245,
      "prev_day_price": 631.83,
      "day_volume_usd": 24318884.251700994,
      "day_volume_base": 46668.1613,
      "circulating_supply": 20999999.99544563,
      "total_supply": 20999999.99544563,
      "market_cap_usd": 9546809997.93
    },
    {
      "pair": "UETH/USDC",
      "id": "@151",
      "base_token": "UETH",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 1765.4,
      "mid_price": 1765.35,
      "prev_day_price": 1782.2,
      "day_volume_usd": 23547626.64772,
      "day_volume_base": 13266.2289,
      "circulating_supply": 99999999.9781432,
      "total_supply": 99999999.9782341,
      "market_cap_usd": 176539999961.41
    },
    {
      "pair": "USOL/USDC",
      "id": "@156",
      "base_token": "USOL",
      "quote_token": "USDC",
      "canonical": false,
      "mark_price": 68.633,
      "mid_price": 68.6325,
      "prev_day_price": 70.5,
      "day_volume_usd": 12554680.857987994,
      "day_volume_base": 181993.411,
      "circulating_supply": 499999999.7968679,
      "total_supply": 499999999.8051735,
      "market_cap_usd": 34316499986.06
    }
  ]
}
GET/api/v1/spot/{token}$0.01

Single Hyperliquid spot token: price, 24h volume, supply, market cap

Live on-chain spot market for one Hyperliquid-listed token by symbol (e.g. HYPE, PURR) or @index: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap, quoted in USDC. Spot, not a perp — for funding/open interest use /api/v1/perps/{coin}; for major-coin fiat prices use /api/v1/crypto.

Example request
GET /api/v1/spot/HYPE
Response type (TypeScript)
interface HlSpotResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  data: {
    pair: string;
    id: string;
    base_token: string;
    quote_token: string;
    canonical: boolean;
    mark_price: number;
    mid_price: number;
    prev_day_price: number;
    day_volume_usd: number;
    day_volume_base: number;
    circulating_supply: number;
    total_supply: number;
    market_cap_usd: number;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.451Z",
  "venue": "hyperliquid",
  "market": "spot",
  "data": {
    "pair": "HYPE/USDC",
    "id": "@107",
    "base_token": "HYPE",
    "quote_token": "USDC",
    "canonical": false,
    "mark_price": 62.87,
    "mid_price": 62.8335,
    "prev_day_price": 74.581,
    "day_volume_usd": 414627195.68830013,
    "day_volume_base": 6077950.050000002,
    "circulating_supply": 298358462.35153913,
    "total_supply": 999191084.3483734,
    "market_cap_usd": 18757796528.04
  }
}
GET/api/v1/spot/orderbook/{token}$0.01

L2 order book (aggregated price levels) for a Hyperliquid spot token

Level-2 order book for one Hyperliquid spot market: aggregated bid and ask price levels, each with size and resting order count, as of the book timestamp. Pass a token symbol (e.g. HYPE, PURR) or @index. Use to gauge spot liquidity, spread, and depth. Spot book — for the perp book use /api/v1/perps/orderbook/{coin}.

Example request
GET /api/v1/spot/orderbook/HYPE
Response type (TypeScript)
interface HlSpotOrderBookResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  pair: string;
  id: string;
  bids: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
  asks: Array<{
    price: number;
    size: number;
    orders: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:18.775Z",
  "venue": "hyperliquid",
  "market": "spot",
  "pair": "HYPE/USDC",
  "id": "@107",
  "bids": [
    {
      "price": 62.865,
      "size": 55.67,
      "orders": 1
    },
    {
      "price": 62.83,
      "size": 79.48,
      "orders": 1
    },
    {
      "price": 62.829,
      "size": 42.26,
      "orders": 1
    },
    {
      "price": 62.811,
      "size": 2,
      "orders": 1
    },
    {
      "price": 62.799,
      "size": 63.65,
      "orders": 1
    },
    {
      "price": 62.798,
      "size": 12.5,
      "orders": 1
    },
    {
      "price": 62.797,
      "size": 56.94,
      "orders": 3
    },
    {
      "price": 62.796,
      "size": 19.9,
      "orders": 1
    },
    {
      "price": 62.792,
      "size": 45.99,
      "orders": 1
    },
    {
      "price": 62.79,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.75,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.749,
      "size": 0.26,
      "orders": 1
    },
    {
      "price": 62.71,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.67,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.669,
      "size": 89.51,
      "orders": 1
    },
    {
      "price": 62.63,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.618,
      "size": 358.11,
      "orders": 1
    },
    {
      "price": 62.614,
      "size": 54.41,
      "orders": 2
    },
    {
      "price": 62.613,
      "size": 3.5,
      "orders": 1
    },
    {
      "price": 62.612,
      "size": 6.99,
      "orders": 1
    }
  ],
  "asks": [
    {
      "price": 62.89,
      "size": 101.58,
      "orders": 1
    },
    {
      "price": 62.9,
      "size": 87.62,
      "orders": 1
    },
    {
      "price": 62.91,
      "size": 0.77,
      "orders": 1
    },
    {
      "price": 62.927,
      "size": 79.47,
      "orders": 1
    },
    {
      "price": 62.94,
      "size": 79.47,
      "orders": 1
    },
    {
      "price": 62.943,
      "size": 427.48,
      "orders": 1
    },
    {
      "price": 62.95,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.958,
      "size": 542.96,
      "orders": 1
    },
    {
      "price": 62.977,
      "size": 317.89,
      "orders": 1
    },
    {
      "price": 62.988,
      "size": 759.47,
      "orders": 1
    },
    {
      "price": 62.99,
      "size": 1,
      "orders": 1
    },
    {
      "price": 62.996,
      "size": 39.68,
      "orders": 1
    },
    {
      "price": 63,
      "size": 1,
      "orders": 1
    },
    {
      "price": 63.027,
      "size": 34.46,
      "orders": 1
    },
    {
      "price": 63.03,
      "size": 1,
      "orders": 1
    },
    {
      "price": 63.032,
      "size": 3.96,
      "orders": 1
    },
    {
      "price": 63.041,
      "size": 21.22,
      "orders": 1
    },
    {
      "price": 63.046,
      "size": 3.96,
      "orders": 1
    },
    {
      "price": 63.056,
      "size": 20,
      "orders": 1
    },
    {
      "price": 63.068,
      "size": 7.92,
      "orders": 1
    }
  ]
}
GET/api/v1/spot/candles/{token}$0.02

Historical OHLCV candles for a Hyperliquid spot token at any interval

Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}.

Example request
GET /api/v1/spot/candles/HYPE
Response type (TypeScript)
interface HlSpotCandlesResponse {
  source: string;
  as_of: string;
  venue: string;
  market: string;
  pair: string;
  id: string;
  interval: string;
  count: number;
  candles: Array<{
    start: string;
    end: string;
    open: number;
    high: number;
    low: number;
    close: number;
    volume: number;
    trades: number;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T00:22:20.025Z",
  "venue": "hyperliquid",
  "market": "spot",
  "pair": "HYPE/USDC",
  "id": "@107",
  "interval": "1d",
  "count": 3,
  "candles": [
    {
      "start": "2026-05-24T00:00:00.000Z",
      "end": "2026-05-24T23:59:59.999Z",
      "open": 58.714,
      "high": 64.461,
      "low": 58.645,
      "close": 62.746,
      "volume": 3323719.51,
      "trades": 176032
    },
    {
      "start": "2026-05-25T00:00:00.000Z",
      "end": "2026-05-25T23:59:59.999Z",
      "open": 62.745,
      "high": 63.931,
      "low": 60.781,
      "close": 61.111,
      "volume": 1899989.67,
      "trades": 119107
    },
    {
      "start": "2026-05-26T00:00:00.000Z",
      "end": "2026-05-26T23:59:59.999Z",
      "open": 61.108,
      "high": 64.727,
      "low": 58.556,
      "close": 59.512,
      "volume": 2924203.9,
      "trades": 135760
    }
  ]
}

Fundamentals & corporate actions

Financial statements, dividends, splits, corporate events, IPOs.

GET/api/v1/financials/{ticker}$0.02

Fundamentals: income, balance sheet, and cash flow statements

Per-period financial statements (income statement, balance sheet, cash flow, comprehensive income) sourced from SEC filings, flattened to fact_key → value maps. Pass `?timeframe=annual|quarterly|ttm` and `?limit=`.

Example request
GET /api/v1/financials/AAPL
Response type (TypeScript)
interface FinancialsResponse {
  ticker: string;
  data: {
    count: number;
    reports: Array<{
      company_name: string;
      cik: string;
      timeframe: string;
      fiscal_period: string;
      fiscal_year: string;
      start_date: string;
      end_date: string;
      filing_date: string;
      source_filing_url: string;
      statements: {
        balance_sheet: {
          long_term_debt: number;
          liabilities_and_equity: number;
          equity: number;
          noncurrent_assets: number;
          other_current_assets: number;
          accounts_payable: number;
          current_liabilities: number;
          fixed_assets: number;
          current_assets: number;
          equity_attributable_to_noncontrolling_interest: number;
          other_noncurrent_assets: number;
          other_noncurrent_liabilities: number;
          noncurrent_liabilities: number;
          other_current_liabilities: number;
          inventory: number;
          liabilities: number;
          assets: number;
          equity_attributable_to_parent: number;
        };
        cash_flow_statement: {
          net_cash_flow_from_financing_activities_continuing: number;
          net_cash_flow_from_investing_activities_continuing: number;
          net_cash_flow: number;
          net_cash_flow_from_operating_activities: number;
          net_cash_flow_from_financing_activities: number;
          net_cash_flow_continuing: number;
          net_cash_flow_from_operating_activities_continuing: number;
          net_cash_flow_from_investing_activities: number;
        };
        income_statement: {
          net_income_loss_attributable_to_noncontrolling_interest: number;
          diluted_average_shares: number;
          income_tax_expense_benefit: number;
          gross_profit: number;
          operating_income_loss: number;
          basic_earnings_per_share: number;
          research_and_development: number;
          income_loss_from_continuing_operations_before_tax: number;
          operating_expenses: number;
          basic_average_shares: number;
          net_income_loss_attributable_to_parent: number;
          nonoperating_income_loss: number;
          cost_of_revenue: number;
          net_income_loss_available_to_common_stockholders_basic: number;
          benefits_costs_expenses: number;
          preferred_stock_dividends_and_other_adjustments: number;
          net_income_loss: number;
          participating_securities_distributed_and_undistributed_earnings_loss_basic: number;
          revenues: number;
          income_loss_from_continuing_operations_after_tax: number;
          diluted_earnings_per_share: number;
          costs_and_expenses: number;
          selling_general_and_administrative_expenses: number;
        };
        comprehensive_income: {
          comprehensive_income_loss_attributable_to_parent: number;
          comprehensive_income_loss: number;
          comprehensive_income_loss_attributable_to_noncontrolling_interest: number;
          other_comprehensive_income_loss: number;
          other_comprehensive_income_loss_attributable_to_parent: number;
        };
      };
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 4,
    "reports": [
      {
        "company_name": "Apple Inc.",
        "cik": "0000320193",
        "timeframe": "annual",
        "fiscal_period": "FY",
        "fiscal_year": "2025",
        "start_date": "2024-09-29",
        "end_date": "2025-09-27",
        "filing_date": "2025-10-31",
        "source_filing_url": "https://api.polygon.io/v1/reference/sec/filings/0000320193-25-000079",
        "statements": {
          "balance_sheet": {
            "long_term_debt": 90678000000,
            "liabilities_and_equity": 359241000000,
            "equity": 73733000000,
            "noncurrent_assets": 211284000000,
            "other_current_assets": 142239000000,
            "accounts_payable": 69860000000,
            "current_liabilities": 165631000000,
            "fixed_assets": 49834000000,
            "current_assets": 147957000000,
            "equity_attributable_to_noncontrolling_interest": 0,
            "other_noncurrent_assets": 161450000000,
            "other_noncurrent_liabilities": 29199000000,
            "noncurrent_liabilities": 119877000000,
            "other_current_liabilities": 95771000000,
            "inventory": 5718000000,
            "liabilities": 285508000000,
            "assets": 359241000000,
            "equity_attributable_to_parent": 73733000000
          },
          "cash_flow_statement": {
            "net_cash_flow_from_financing_activities_continuing": -120686000000,
            "net_cash_flow_from_investing_activities_continuing": 15195000000,
            "net_cash_flow": 5991000000,
            "net_cash_flow_from_operating_activities": 111482000000,
            "net_cash_flow_from_financing_activities": -120686000000,
            "net_cash_flow_continuing": 5991000000,
            "net_cash_flow_from_operating_activities_continuing": 111482000000,
            "net_cash_flow_from_investing_activities": 15195000000
          },
          "income_statement": {
            "net_income_loss_attributable_to_noncontrolling_interest": 0,
            "diluted_average_shares": 15004697000,
            "income_tax_expense_benefit": 20719000000,
            "gross_profit": 195201000000,
            "operating_income_loss": 133050000000,
            "basic_earnings_per_share": 7.49,
            "research_and_development": 34550000000,
            "income_loss_from_continuing_operations_before_tax": 132729000000,
            "operating_expenses": 62151000000,
            "basic_average_shares": 14948500000,
            "net_income_loss_attributable_to_parent": 112010000000,
            "nonoperating_income_loss": -321000000,
            "cost_of_revenue": 220960000000,
            "net_income_loss_available_to_common_stockholders_basic": 112010000000,
            "benefits_costs_expenses": 283432000000,
            "preferred_stock_dividends_and_other_adjustments": 0,
            "net_income_loss": 112010000000,
            "participating_securities_distributed_and_undistributed_earnings_loss_basic": 0,
            "revenues": 416161000000,
            "income_loss_from_continuing_operations_after_tax": 112010000000,
            "diluted_earnings_per_share": 7.46,
            "costs_and_expenses": 283432000000,
            "selling_general_and_administrative_expenses": 27601000000
          },
          "comprehensive_income": {
            "comprehensive_income_loss_attributable_to_parent": 113611000000,
            "comprehensive_income_loss": 113611000000,
            "comprehensive_income_loss_attributable_to_noncontrolling_interest": 0,
            "other_comprehensive_income_loss": 113611000000,
            "other_comprehensive_income_loss_attributable_to_parent": 1601000000
          }
        }
      },
      {
        "company_name": "Apple Inc.",
        "cik": "0000320193",
        "timeframe": "annual",
        "fiscal_period": "FY",
        "fiscal_year": "2024",
        "start_date": "2023-10-01",
        "end_date": "2024-09-28",
        "filing_date": "2024-11-01",
        "source_filing_url": "https://api.polygon.io/v1/reference/sec/filings/0000320193-24-000123",
        "statements": {
          "comprehensive_income": {
            "comprehensive_income_loss_attributable_to_parent": 98016000000,
            "comprehensive_income_loss_attributable_to_noncontrolling_interest": 0,
            "other_comprehensive_income_loss_attributable_to_parent": 4280000000,
            "other_comprehensive_income_loss": 98016000000,
            "comprehensive_income_loss": 98016000000
          },
          "income_statement": {
            "net_income_loss": 93736000000,
            "preferred_stock_dividends_and_other_adjustments": 0,
            "net_income_loss_attributable_to_noncontrolling_interest": 0,
            "participating_securities_distributed_and_undistributed_earnings_loss_basic": 0,
            "operating_expenses": 57467000000,
            "operating_income_loss": 123216000000,
            "revenues": 391035000000,
            "diluted_average_shares": 15408095000,
            "income_loss_from_continuing_operations_after_tax": 93736000000,
            "net_income_loss_attributable_to_parent": 93736000000,
            "benefits_costs_expenses": 267550000000,
            "selling_general_and_administrative_expenses": 26097000000,
            "nonoperating_income_loss": 269000000,
            "cost_of_revenue": 210352000000,
            "diluted_earnings_per_share": 6.08,
            "basic_earnings_per_share": 6.11,
            "costs_and_expenses": 267550000000,
            "net_income_loss_available_to_common_stockholders_basic": 93736000000,
            "gross_profit": 180683000000,
            "income_loss_from_continuing_operations_before_tax": 123485000000,
            "research_and_development": 31370000000,
            "income_tax_expense_benefit": 29749000000,
            "basic_average_shares": 15343783000
          },
          "cash_flow_statement": {
            "net_cash_f
… (truncated — call the endpoint for the full response)
GET/api/v1/dividends/{ticker}$0.01

Dividend history (cash amount, ex-date, pay date, frequency)

Historical cash dividends for a ticker: amount, currency, type, frequency, and the declaration / ex-dividend / record / pay dates. Most recent first.

Example request
GET /api/v1/dividends/AAPL
Response type (TypeScript)
interface DividendsResponse {
  ticker: string;
  data: {
    count: number;
    dividends: Array<{
      cash_amount: number;
      currency: string;
      dividend_type: string;
      frequency: number;
      declaration_date: string;
      ex_dividend_date: string;
      record_date: string;
      pay_date: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 10,
    "dividends": [
      {
        "cash_amount": 0.27,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2026-04-30",
        "ex_dividend_date": "2026-05-11",
        "record_date": "2026-05-11",
        "pay_date": "2026-05-14"
      },
      {
        "cash_amount": 0.26,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2026-01-29",
        "ex_dividend_date": "2026-02-09",
        "record_date": "2026-02-09",
        "pay_date": "2026-02-12"
      },
      {
        "cash_amount": 0.26,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2025-10-30",
        "ex_dividend_date": "2025-11-10",
        "record_date": "2025-11-10",
        "pay_date": "2025-11-13"
      },
      {
        "cash_amount": 0.26,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2025-07-31",
        "ex_dividend_date": "2025-08-11",
        "record_date": "2025-08-11",
        "pay_date": "2025-08-14"
      },
      {
        "cash_amount": 0.26,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2025-05-01",
        "ex_dividend_date": "2025-05-12",
        "record_date": "2025-05-12",
        "pay_date": "2025-05-15"
      },
      {
        "cash_amount": 0.25,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2025-01-30",
        "ex_dividend_date": "2025-02-10",
        "record_date": "2025-02-10",
        "pay_date": "2025-02-13"
      },
      {
        "cash_amount": 0.25,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2024-10-31",
        "ex_dividend_date": "2024-11-08",
        "record_date": "2024-11-11",
        "pay_date": "2024-11-14"
      },
      {
        "cash_amount": 0.25,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2024-08-01",
        "ex_dividend_date": "2024-08-12",
        "record_date": "2024-08-12",
        "pay_date": "2024-08-15"
      },
      {
        "cash_amount": 0.25,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2024-05-02",
        "ex_dividend_date": "2024-05-10",
        "record_date": "2024-05-13",
        "pay_date": "2024-05-16"
      },
      {
        "cash_amount": 0.24,
        "currency": "USD",
        "dividend_type": "CD",
        "frequency": 4,
        "declaration_date": "2024-02-01",
        "ex_dividend_date": "2024-02-09",
        "record_date": "2024-02-12",
        "pay_date": "2024-02-15"
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:20.242Z"
}
GET/api/v1/splits/{ticker}$0.01

Stock split history

Historical stock splits for a ticker, with execution date and split ratio (split_from to split_to). Most recent first.

Example request
GET /api/v1/splits/AAPL
Response type (TypeScript)
interface SplitsResponse {
  ticker: string;
  data: {
    count: number;
    splits: Array<{
      execution_date: string;
      type: string;
      split_from: number;
      split_to: number;
      ratio: number;
      ratio_text: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 5,
    "splits": [
      {
        "execution_date": "2020-08-31",
        "type": "forward",
        "split_from": 1,
        "split_to": 4,
        "ratio": 4,
        "ratio_text": "4:1"
      },
      {
        "execution_date": "2014-06-09",
        "type": "forward",
        "split_from": 1,
        "split_to": 7,
        "ratio": 7,
        "ratio_text": "7:1"
      },
      {
        "execution_date": "2005-02-28",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "2000-06-21",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "1987-06-16",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:22.987Z"
}
GET/api/v1/splits-calendar$0.02

Split calendar: upcoming and recent forward & reverse splits across all US tickers

Market-wide split calendar across all US tickers (no ticker needed). Each row has the ticker, execution date, direction (`forward`/`reverse`), split_from/split_to, numeric `ratio`, and a human `ratio_text` like `10:1` or `1:8`. Future-dated announced splits sort first. Filter `?type=forward|reverse|all`, `?from=`/`?to=` date window, `?order=`, `?limit=`.

Example request
GET /api/v1/splits-calendar
Response type (TypeScript)
interface SplitsCalendarResponse {
  source: string;
  as_of: string;
  count: number;
  splits: Array<{
    ticker: string;
    execution_date: string;
    type: string;
    split_from: number;
    split_to: number;
    ratio: number;
    ratio_text: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-05T18:00:00.000Z",
  "count": 4,
  "splits": [
    {
      "ticker": "NVDA",
      "execution_date": "2024-06-10",
      "type": "forward",
      "split_from": 1,
      "split_to": 10,
      "ratio": 10,
      "ratio_text": "10:1"
    },
    {
      "ticker": "AAPL",
      "execution_date": "2020-08-31",
      "type": "forward",
      "split_from": 1,
      "split_to": 4,
      "ratio": 4,
      "ratio_text": "4:1"
    },
    {
      "ticker": "GE",
      "execution_date": "2021-08-02",
      "type": "reverse",
      "split_from": 8,
      "split_to": 1,
      "ratio": 0.125,
      "ratio_text": "1:8"
    },
    {
      "ticker": "AMC",
      "execution_date": "2023-08-24",
      "type": "reverse",
      "split_from": 10,
      "split_to": 1,
      "ratio": 0.1,
      "ratio_text": "1:10"
    }
  ]
}
GET/api/v1/events/{ticker}$0.01

Corporate events (ticker changes and more)

Timeline of corporate events for a ticker, such as ticker symbol changes, with the company name, CIK, and composite FIGI.

Example request
GET /api/v1/events/AAPL
Response type (TypeScript)
interface EventsResponse {
  ticker: string;
  data: {
    name: string;
    composite_figi: string;
    cik: string;
    events: Array<{
      type: string;
      date: string;
      ticker: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "name": "Apple Inc.",
    "composite_figi": "BBG000B9XRY4",
    "cik": "0000320193",
    "events": [
      {
        "type": "ticker_change",
        "date": "2003-09-10",
        "ticker": "AAPL"
      }
    ]
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:25.460Z"
}
GET/api/v1/ipos$0.02

IPO calendar: upcoming and historical US listings with price range and size

Upcoming and historical US IPOs: issuer name, ticker, announced and listing dates, offer price range and final price, shares offered, total deal size, exchange, and status. Filter by `?ipo_status=pending|new|history|rumor`, `?ticker=`, and `?limit=`. Use to track the new-issue calendar and recently priced deals.

Example request
GET /api/v1/ipos
Response type (TypeScript)
interface IposResponse {
  source: string;
  as_of: string;
  count: number;
  ipos: Array<{
    ticker: string;
    issuer_name: string;
    status: string;
    announced_date: string;
    listing_date: null;
    primary_exchange: string;
    security_type: string;
    security_description: string;
    currency: string;
    isin: string;
    final_issue_price: number;
    lowest_offer_price: number;
    highest_offer_price: number;
    max_shares_offered: number;
    total_offer_size: number;
    shares_outstanding: number;
    last_updated: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T18:56:03.416Z",
  "count": 10,
  "ipos": [
    {
      "ticker": "FISN",
      "issuer_name": "Deep Fission Inc.",
      "status": "pending",
      "announced_date": "2026-05-20",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares",
      "currency": "USD",
      "isin": "US2439271006",
      "final_issue_price": null,
      "lowest_offer_price": 24,
      "highest_offer_price": 26,
      "max_shares_offered": 6000000,
      "total_offer_size": 156000000,
      "shares_outstanding": null,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "TP",
      "issuer_name": "Ticketplus Ltd.",
      "status": "pending",
      "announced_date": "2026-05-28",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares",
      "currency": "USD",
      "isin": null,
      "final_issue_price": null,
      "lowest_offer_price": null,
      "highest_offer_price": null,
      "max_shares_offered": null,
      "total_offer_size": 28750000,
      "shares_outstanding": null,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "YLY",
      "issuer_name": "Zi Yun Dong Fang Ltd.",
      "status": "pending",
      "announced_date": "2025-05-16",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares",
      "currency": "USD",
      "isin": null,
      "final_issue_price": 5,
      "lowest_offer_price": 4,
      "highest_offer_price": 6,
      "max_shares_offered": 6250000,
      "total_offer_size": 31250000,
      "shares_outstanding": 21250000,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "ENT",
      "issuer_name": "Entrata Inc.",
      "status": "pending",
      "announced_date": "2026-05-28",
      "listing_date": null,
      "primary_exchange": "XNYS",
      "security_type": "CS",
      "security_description": "Ordinary Shares - Class A",
      "currency": "USD",
      "isin": null,
      "final_issue_price": null,
      "lowest_offer_price": null,
      "highest_offer_price": null,
      "max_shares_offered": null,
      "total_offer_size": 100000000,
      "shares_outstanding": null,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "KEYYU",
      "issuer_name": "Keystone Acquisition Corp.",
      "status": "pending",
      "announced_date": "2026-05-04",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "SP",
      "security_description": "Units 1 Ord Cls A  1/2 War",
      "currency": "USD",
      "isin": null,
      "final_issue_price": 10,
      "lowest_offer_price": 10,
      "highest_offer_price": 10,
      "max_shares_offered": 25000000,
      "total_offer_size": 250000000,
      "shares_outstanding": 25000000,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "POCH",
      "issuer_name": "Poche Technology Co. Ltd",
      "status": "pending",
      "announced_date": "2026-03-18",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares - Class A",
      "currency": "USD",
      "isin": null,
      "final_issue_price": null,
      "lowest_offer_price": 4,
      "highest_offer_price": 5,
      "max_shares_offered": 6250000,
      "total_offer_size": 31250000,
      "shares_outstanding": 19052200,
      "last_updated": "2026-05-29"
    },
    {
      "ticker": "RIKU",
      "issuer_name": "Riku Dining Group Ltd.",
      "status": "pending",
      "announced_date": "2025-09-12",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares - Class A",
      "currency": "USD",
      "isin": "KYG7573F1019",
      "final_issue_price": 5,
      "lowest_offer_price": 4,
      "highest_offer_price": 6,
      "max_shares_offered": 5000000,
      "total_offer_size": 25000000,
      "shares_outstanding": 23000000,
      "last_updated": "2026-05-28"
    },
    {
      "ticker": "SFPT",
      "issuer_name": "Safepoint Holdings Inc.",
      "status": "pending",
      "announced_date": "2026-05-08",
      "listing_date": null,
      "primary_exchange": "XNYS",
      "security_type": "CS",
      "security_description": "Ordinary Shares",
      "currency": "USD",
      "isin": "US7869271038",
      "final_issue_price": null,
      "lowest_offer_price": 15,
      "highest_offer_price": 17,
      "max_shares_offered": 16666667,
      "total_offer_size": 283333339,
      "shares_outstanding": 68432417,
      "last_updated": "2026-05-28"
    },
    {
      "ticker": "QNT",
      "issuer_name": "Quantinuum Inc.",
      "status": "pending",
      "announced_date": "2026-05-08",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares - Class A",
      "currency": "USD",
      "isin": "US74768A1043",
      "final_issue_price": null,
      "lowest_offer_price": 45,
      "highest_offer_price": 50,
      "max_shares_offered": 21052632,
      "total_offer_size": 1052631600,
      "shares_outstanding": 25948276,
      "last_updated": "2026-05-28"
    },
    {
      "ticker": "SPCX",
      "issuer_name": "Space Exploration Technologies Corp.",
      "status": "pending",
      "announced_date": "2026-05-20",
      "listing_date": null,
      "primary_exchange": "XNAS",
      "security_type": "CS",
      "security_description": "Ordinary Shares - Class A",
      "currency": "USD",
      "isin": "US84615Q1031",
      "final_issue_price": null,
      "lowest_offer_price": null,
      "highest_offer_price": null,
      "max_shares_offered": null,
      "total_offer_size": 1000000000,
      "shares_outstanding": null,
      "last_updated": "2026-05-28"
    }
  ]
}

SEC filings & disclosures

Straight from SEC EDGAR: filings, insider trades, 8-K events, XBRL facts, 13F holdings, AI summaries.

GET/api/v1/filings/{ticker}$0.01

SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more

List a company's recent SEC EDGAR filings sourced directly from the SEC: form type, filing and report dates, the 8-K item codes, and a direct link to each primary document. Filter to a single form with `?type=10-K` (also 10-Q, 8-K, 4, etc.) and cap with `?limit=`. Use as the index into a company's disclosures before fetching or summarizing a specific filing.

Example request
GET /api/v1/filings/AAPL
Response type (TypeScript)
interface FilingsResponse {
  ticker: string;
  data: {
    cik: string;
    company: string;
    count: number;
    filings: Array<{
      form: string;
      accession: string;
      filing_date: string;
      report_date: string;
      description: string;
      items: unknown[];
      primary_document: string;
      url: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "cik": "0000320193",
    "company": "Apple Inc.",
    "count": 20,
    "filings": [
      {
        "form": "4",
        "accession": "0001140361-26-023363",
        "filing_date": "2026-05-29",
        "report_date": "2026-05-27",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126023363/form4.xml"
      },
      {
        "form": "SD",
        "accession": "0001140361-26-023149",
        "filing_date": "2026-05-28",
        "report_date": null,
        "description": "SD",
        "items": [],
        "primary_document": "ef20073373_sd.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126023149/ef20073373_sd.htm"
      },
      {
        "form": "144",
        "accession": "0001921094-26-000555",
        "filing_date": "2026-05-27",
        "report_date": null,
        "description": null,
        "items": [],
        "primary_document": "primary_doc.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000192109426000555/primary_doc.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-020871",
        "filing_date": "2026-05-12",
        "report_date": "2026-05-08",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020871/form4.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-020298",
        "filing_date": "2026-05-08",
        "report_date": "2026-05-06",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020298/form4.xml"
      },
      {
        "form": "144",
        "accession": "0001921094-26-000446",
        "filing_date": "2026-05-06",
        "report_date": null,
        "description": null,
        "items": [],
        "primary_document": "primary_doc.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000192109426000446/primary_doc.xml"
      },
      {
        "form": "144",
        "accession": "0001950047-26-004044",
        "filing_date": "2026-05-05",
        "report_date": null,
        "description": null,
        "items": [],
        "primary_document": "primary_doc.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726004044/primary_doc.xml"
      },
      {
        "form": "10-Q",
        "accession": "0000320193-26-000013",
        "filing_date": "2026-05-01",
        "report_date": "2026-03-28",
        "description": "10-Q",
        "items": [],
        "primary_document": "aapl-20260328.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/aapl-20260328.htm"
      },
      {
        "form": "8-K",
        "accession": "0000320193-26-000011",
        "filing_date": "2026-04-30",
        "report_date": "2026-04-30",
        "description": "8-K",
        "items": [
          "2.02",
          "9.01"
        ],
        "primary_document": "aapl-20260430.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000011/aapl-20260430.htm"
      },
      {
        "form": "SCHEDULE 13G",
        "accession": "0002100119-26-000139",
        "filing_date": "2026-04-29",
        "report_date": null,
        "description": null,
        "items": [],
        "primary_document": "primary_doc.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210011926000139/primary_doc.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-017175",
        "filing_date": "2026-04-27",
        "report_date": "2026-04-23",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126017175/form4.xml"
      },
      {
        "form": "144",
        "accession": "0001950047-26-003721",
        "filing_date": "2026-04-23",
        "report_date": null,
        "description": null,
        "items": [],
        "primary_document": "primary_doc.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726003721/primary_doc.xml"
      },
      {
        "form": "8-K",
        "accession": "0001140361-26-015711",
        "filing_date": "2026-04-20",
        "report_date": "2026-04-17",
        "description": "8-K",
        "items": [
          "5.02"
        ],
        "primary_document": "ef20071035_8k.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126015711/ef20071035_8k.htm"
      },
      {
        "form": "4",
        "accession": "0001140361-26-015421",
        "filing_date": "2026-04-17",
        "report_date": "2026-04-15",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126015421/form4.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-015420",
        "filing_date": "2026-04-17",
        "report_date": "2026-04-15",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126015420/form4.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-013192",
        "filing_date": "2026-04-03",
        "report_date": "2026-04-01",
        "description": "FORM 4",
        "items": [],
        "primary_document": "form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126013192/form4.xml"
      },
      {
        "form": "4",
        "accession": "0001140361-26-013191",
        "filing_date": "2026-04-03",
        "report_date": "2026-04-01",
        "description": "FORM 4",
        "items": [],
        "primar
… (truncated — call the endpoint for the full response)
GET/api/v1/filing-summary/{ticker}$0.03

AI-structured summary of a 10-K, 10-Q, or 8-K: overview, risk factors, MD&A, guidance

Fetches a company's latest 10-K, 10-Q, or 8-K from SEC EDGAR and returns a structured JSON summary: a plain-language overview, the key risk factors, MD&A highlights, any forward guidance, and an overall sentiment label. Choose the document with `?type=10-K` (also 10-Q, 8-K). Built for agents that need the substance of a filing without parsing hundreds of pages of HTML.

Example request
GET /api/v1/filing-summary/AAPL
Response type (TypeScript)
interface FilingSummaryResponse {
  ticker: string;
  data: {
    form: string;
    accession: string;
    filing_date: string;
    report_date: string;
    filing_url: string;
    summary: string;
    business_overview: string;
    risk_factors: string[];
    mda_highlights: string[];
    guidance: null;
    sentiment: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "form": "10-K",
    "accession": "0000320193-25-000079",
    "filing_date": "2025-10-31",
    "report_date": "2025-09-27",
    "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
    "summary": "Apple Inc.'s 2025 10-K filing outlines various risk factors that could adversely affect its business, including macroeconomic conditions, geopolitical tensions, and competition. The company reported a 6% increase in total net sales for 2025, driven by higher sales of iPhones and services, despite challenges such as new tariffs and fluctuating currency values. Management's discussion highlights the importance of innovation and effective supply chain management in maintaining competitive advantage.",
    "business_overview": "Apple Inc. designs, manufactures, and sells consumer electronics, software, and services, including iPhones, Macs, iPads, and various software platforms.",
    "risk_factors": [
      "Macroeconomic conditions",
      "Geopolitical tensions",
      "Supply chain disruptions",
      "Intense competition",
      "Dependence on third-party developers",
      "Product defects and recalls",
      "Tariffs and trade restrictions",
      "Legal and regulatory challenges"
    ],
    "mda_highlights": [
      "6% increase in total net sales to $416.2 billion in 2025",
      "iPhone sales increased by 4% due to higher Pro model sales",
      "Services revenue grew by 14% driven by advertising and cloud services",
      "Mac sales rose by 12% primarily from laptops and desktops",
      "Operating expenses increased by 8% due to higher R&D and administrative costs",
      "Gross margin percentage for products decreased slightly due to tariff costs",
      "Cash and marketable securities totaled $132.4 billion as of September 27, 2025",
      "New share repurchase program of up to $100 billion announced"
    ],
    "guidance": null,
    "sentiment": "neutral"
  },
  "source": "sec_edgar",
  "as_of": "2025-10-31T00:00:00.000Z"
}
GET/api/v1/filing-search$0.02

Full-text search across all SEC filings since 2001 by keyword, form type, and date

Full-text search across every SEC EDGAR filing since 2001. Find filings mentioning a keyword or exact phrase via ?q=, narrow by ?forms=10-K,8-K, ?ticker=, and ?startdt=/?enddt= dates, and cap with ?limit=. Returns each match's form, filer, date, and a link to the document. Sourced from SEC EDGAR.

Example request
GET /api/v1/filing-search
Response type (TypeScript)
interface FilingSearchResponse {
  source: string;
  as_of: string;
  query: string;
  forms: string;
  ticker: null;
  total_matches: number;
  count: number;
  results: Array<{
    accession: string;
    form: string;
    filing_date: string;
    period_ending: string;
    filer: string;
    cik: string;
    description: string;
    url: string;
  }>;
}
Example response (click to expand)
{
  "source": "sec_edgar",
  "as_of": "2026-06-01T21:38:17.049Z",
  "query": "\"artificial intelligence\"",
  "forms": "10-K",
  "ticker": null,
  "total_matches": 10000,
  "count": 10,
  "results": [
    {
      "accession": "0001161697-21-000289",
      "form": "10-K",
      "filing_date": "2021-06-01",
      "period_ending": "2021-02-28",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "INSIDER TRADING POLICY",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169721000289/ex_99-1.htm"
    },
    {
      "accession": "0001161697-22-000273",
      "form": "10-K/A",
      "filing_date": "2022-05-31",
      "period_ending": "2022-02-28",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K/A AMENDMENT NO. 1 TO ANNUAL REPORT FOR 02-28-2022",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169722000273/form_10-ka.htm"
    },
    {
      "accession": "0001477932-26-002727",
      "form": "10-K/A",
      "filing_date": "2026-05-04",
      "period_ending": "2025-12-31",
      "filer": "Catalyst Crew Technologies Corp.  (CCTC)  (CIK 0001477960)",
      "cik": "0001477960",
      "description": "FORM 10-K/A",
      "url": "https://www.sec.gov/Archives/edgar/data/1477960/000147793226002727/cctc_10ka.htm"
    },
    {
      "accession": "0001161697-21-000289",
      "form": "10-K",
      "filing_date": "2021-06-01",
      "period_ending": "2021-02-28",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K ANNUAL REPORT FOR 02-28-2021",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169721000289/form_10-k.htm"
    },
    {
      "accession": "0001683168-26-002984",
      "form": "10-K",
      "filing_date": "2026-04-15",
      "period_ending": "2025-12-31",
      "filer": "Loan Artificial Intelligence Corp.  (LAAI, VEST)  (CIK 0001594968)",
      "cik": "0001594968",
      "description": "FORM 10-K FOR DEC 2025",
      "url": "https://www.sec.gov/Archives/edgar/data/1594968/000168316826002984/loan_i10k-123125.htm"
    },
    {
      "accession": "0001161697-19-000352",
      "form": "10-K",
      "filing_date": "2019-08-26",
      "period_ending": "2019-02-28",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K ANNUAL REPORT FOR 02-28-2019",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169719000352/form_10-k.htm"
    },
    {
      "accession": "0001161697-20-000345",
      "form": "10-K/A",
      "filing_date": "2020-07-31",
      "period_ending": "2020-02-29",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K/A AMENDMENT NO. 1 TO ANNUAL REPORT FOR 02-29-2020",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169720000345/form_10-k.htm"
    },
    {
      "accession": "0001161697-20-000334",
      "form": "10-K",
      "filing_date": "2020-07-28",
      "period_ending": "2020-02-29",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K ANNUAL REPORT FOR 02-29-2020",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169720000334/form_10-k.htm"
    },
    {
      "accession": "0001493152-19-015506",
      "form": "10-K",
      "filing_date": "2019-10-15",
      "period_ending": "2019-06-30",
      "filer": "MPHASE TECHNOLOGIES INC  (XDSL)  (CIK 0000825322)",
      "cik": "0000825322",
      "description": null,
      "url": "https://www.sec.gov/Archives/edgar/data/825322/000149315219015506/form10-k.htm"
    },
    {
      "accession": "0001161697-19-000466",
      "form": "10-K/A",
      "filing_date": "2019-11-04",
      "period_ending": "2019-02-28",
      "filer": "Artificial Intelligence Technology Solutions Inc.  (AITX)  (CIK 0001498148)",
      "cik": "0001498148",
      "description": "FORM 10-K/A AMENDMENT NO. 2 TO ANNUAL REPORT FOR 02-28-2019",
      "url": "https://www.sec.gov/Archives/edgar/data/1498148/000116169719000466/form_10-k.htm"
    }
  ]
}
GET/api/v1/insider-trades/{ticker}$0.03

Insider transactions from SEC Form 4: who bought or sold, how much, at what price

Recent insider transactions parsed from SEC Form 4 filings: the reporting owner and their role (director, officer, 10% holder), each buy/sell with transaction code, share count, price, and shares held afterward, plus an aggregate net-buying/net-selling signal. Tune how many filings to parse with `?limit=` (default 5, max 25). Sourced live from SEC EDGAR.

Example request
GET /api/v1/insider-trades/AAPL
Response type (TypeScript)
interface InsiderTradesResponse {
  ticker: string;
  data: {
    filings_parsed: number;
    transaction_count: number;
    summary: {
      buys: number;
      sells: number;
      shares_bought: number;
      shares_sold: number;
      net_shares: number;
      signal: string;
    };
    transactions: Array<{
      owner_name: string;
      is_director: boolean;
      is_officer: boolean;
      officer_title: string;
      is_ten_percent_owner: boolean;
      filing_date: string;
      accession: string;
      url: string;
      security: string;
      transaction_date: string;
      code: string;
      code_label: string;
      shares: number;
      price_per_share: number;
      acquired_disposed: string;
      shares_owned_after: number;
      is_derivative: boolean;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "filings_parsed": 5,
    "transaction_count": 13,
    "summary": {
      "buys": 1,
      "sells": 12,
      "shares_bought": 1717,
      "shares_sold": 375417,
      "net_shares": -373700,
      "signal": "net_selling"
    },
    "transactions": [
      {
        "owner_name": "LEVINSON ARTHUR D",
        "is_director": true,
        "is_officer": false,
        "officer_title": null,
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-29",
        "accession": "0001140361-26-023363",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126023363/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-27",
        "code": "S",
        "code_label": "Open-market or private sale",
        "shares": 50000,
        "price_per_share": 311.02,
        "acquired_disposed": "D",
        "shares_owned_after": 3764576,
        "is_derivative": false
      },
      {
        "owner_name": "LEVINSON ARTHUR D",
        "is_director": true,
        "is_officer": false,
        "officer_title": null,
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-29",
        "accession": "0001140361-26-023363",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126023363/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-27",
        "code": "G",
        "code_label": "Bona fide gift",
        "shares": 65000,
        "price_per_share": 0,
        "acquired_disposed": "D",
        "shares_owned_after": 3699576,
        "is_derivative": false
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-12",
        "accession": "0001140361-26-020871",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020871/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-08",
        "code": "S",
        "code_label": "Open-market or private sale",
        "shares": 1274,
        "price_per_share": 290,
        "acquired_disposed": "D",
        "shares_owned_after": 38713,
        "is_derivative": false
      },
      {
        "owner_name": "LEVINSON ARTHUR D",
        "is_director": true,
        "is_officer": false,
        "officer_title": null,
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-08",
        "accession": "0001140361-26-020298",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020298/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-06",
        "code": "S",
        "code_label": "Open-market or private sale",
        "shares": 149527,
        "price_per_share": 284.57,
        "acquired_disposed": "D",
        "shares_owned_after": 3920049,
        "is_derivative": false
      },
      {
        "owner_name": "LEVINSON ARTHUR D",
        "is_director": true,
        "is_officer": false,
        "officer_title": null,
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-08",
        "accession": "0001140361-26-020298",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020298/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-06",
        "code": "S",
        "code_label": "Open-market or private sale",
        "shares": 100473,
        "price_per_share": 285.04,
        "acquired_disposed": "D",
        "shares_owned_after": 3819576,
        "is_derivative": false
      },
      {
        "owner_name": "LEVINSON ARTHUR D",
        "is_director": true,
        "is_officer": false,
        "officer_title": null,
        "is_ten_percent_owner": false,
        "filing_date": "2026-05-08",
        "accession": "0001140361-26-020298",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020298/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-05-06",
        "code": "G",
        "code_label": "Bona fide gift",
        "shares": 5000,
        "price_per_share": 0,
        "acquired_disposed": "D",
        "shares_owned_after": 3814576,
        "is_derivative": false
      },
      {
        "owner_name": "Parekh Kevan",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Senior Vice President, CFO",
        "is_ten_percent_owner": false,
        "filing_date": "2026-04-27",
        "accession": "0001140361-26-017175",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126017175/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-04-23",
        "code": "S",
        "code_label": "Open-market or private sale",
        "shares": 1534,
        "price_per_share": 275,
        "acquired_disposed": "D",
        "shares_owned_after": 13366,
        "is_derivative": false
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-04-17",
        "accession": "0001140361-26-015421",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126015421/form4.xml",
        "security": "Common Stock",
        "transaction_date": "2026-04-15",
        "code": "M",
        "code_label": "Exercise/conversion of derivative",
        "shares": 1717,
        "price_per_share": null,
        "acquired_disposed": "A",
        "shares_owned_after": 40879,
        "is_derivative": false
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-04-17",
        "accession": "00
… (truncated — call the endpoint for the full response)
GET/api/v1/material-events/{ticker}$0.03

Material corporate events from 8-K filings, classified by SEC item code

Recent 8-K material-event filings for a company, each classified by its SEC item code into a human-readable label (e.g. 2.02 Results of Operations, 5.02 Executive Changes, 1.01 Material Agreement). Returns filing date, item labels, and a link to the filing. Cap with `?limit=`. Use to track earnings releases, leadership changes, and material agreements. Sourced from SEC EDGAR.

Example request
GET /api/v1/material-events/AAPL
Response type (TypeScript)
interface MaterialEventsResponse {
  ticker: string;
  data: {
    count: number;
    events: Array<{
      form: string;
      accession: string;
      filing_date: string;
      report_date: string;
      url: string;
      items: Array<{
        code: string;
        label: string;
      }>;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "count": 20,
    "events": [
      {
        "form": "8-K",
        "accession": "0000320193-26-000011",
        "filing_date": "2026-04-30",
        "report_date": "2026-04-30",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000011/aapl-20260430.htm",
        "items": [
          {
            "code": "2.02",
            "label": "Results of Operations and Financial Condition"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-26-015711",
        "filing_date": "2026-04-20",
        "report_date": "2026-04-17",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126015711/ef20071035_8k.htm",
        "items": [
          {
            "code": "5.02",
            "label": "Departure/Election of Directors or Officers; Compensatory Arrangements"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-26-006577",
        "filing_date": "2026-02-24",
        "report_date": "2026-02-24",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126006577/ef20060722_8k.htm",
        "items": [
          {
            "code": "5.07",
            "label": "Submission of Matters to a Vote of Security Holders"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0000320193-26-000005",
        "filing_date": "2026-01-29",
        "report_date": "2026-01-29",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000005/aapl-20260129.htm",
        "items": [
          {
            "code": "2.02",
            "label": "Results of Operations and Financial Condition"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-26-000199",
        "filing_date": "2026-01-02",
        "report_date": "2025-12-30",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126000199/ef20060722_8k.htm",
        "items": [
          {
            "code": "5.02",
            "label": "Departure/Election of Directors or Officers; Compensatory Arrangements"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-25-044561",
        "filing_date": "2025-12-05",
        "report_date": "2025-12-04",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/ef20060722_8k.htm",
        "items": [
          {
            "code": "5.02",
            "label": "Departure/Election of Directors or Officers; Compensatory Arrangements"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0000320193-25-000077",
        "filing_date": "2025-10-30",
        "report_date": "2025-10-30",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000077/aapl-20251030.htm",
        "items": [
          {
            "code": "2.02",
            "label": "Results of Operations and Financial Condition"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0000320193-25-000071",
        "filing_date": "2025-07-31",
        "report_date": "2025-07-31",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000071/aapl-20250731.htm",
        "items": [
          {
            "code": "2.02",
            "label": "Results of Operations and Financial Condition"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-25-027340",
        "filing_date": "2025-07-25",
        "report_date": "2025-07-21",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125027340/ef20052355_8k.htm",
        "items": [
          {
            "code": "5.02",
            "label": "Departure/Election of Directors or Officers; Compensatory Arrangements"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-25-025275",
        "filing_date": "2025-07-09",
        "report_date": "2025-07-08",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125025275/ef20051741_8k.htm",
        "items": [
          {
            "code": "5.02",
            "label": "Departure/Election of Directors or Officers; Compensatory Arrangements"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-25-018400",
        "filing_date": "2025-05-12",
        "report_date": "2025-05-05",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125018400/ef20048691_8k.htm",
        "items": [
          {
            "code": "8.01",
            "label": "Other Events"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0000320193-25-000055",
        "filing_date": "2025-05-01",
        "report_date": "2025-05-01",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000055/aapl-20250501.htm",
        "items": [
          {
            "code": "2.02",
            "label": "Results of Operations and Financial Condition"
          },
          {
            "code": "9.01",
            "label": "Financial Statements and Exhibits"
          }
        ]
      },
      {
        "form": "8-K",
        "accession": "0001140361-25-005876",
        "filing_date": "2025-02-25",
        "report_date
… (truncated — call the endpoint for the full response)
GET/api/v1/concept/{ticker}$0.02

Time series of a single XBRL financial fact straight from SEC filings

The reported time series of one XBRL financial concept (e.g. Revenues, Assets, NetIncomeLoss) for a company, taken directly from its SEC filings. Pass the tag via `?tag=` and optionally `?taxonomy=` (default us-gaap) and `?limit=`. Each point carries the value, period, fiscal year/quarter, source form, and accession. Use for precise, filing-grade fundamentals and quant time series.

Example request
GET /api/v1/concept/AAPL
Response type (TypeScript)
interface ConceptResponse {
  ticker: string;
  data: {
    tag: string;
    taxonomy: string;
    label: string;
    unit: string;
    count: number;
    series: Array<{
      value: number;
      start: string;
      end: string;
      fiscal_year: number;
      fiscal_period: string;
      form: string;
      filed: string;
      frame: string;
      accession: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "tag": "Revenues",
    "taxonomy": "us-gaap",
    "label": "Revenues",
    "unit": "USD",
    "count": 8,
    "series": [
      {
        "value": 62900000000,
        "start": "2018-07-01",
        "end": "2018-09-29",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2018Q3",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 265595000000,
        "start": "2017-10-01",
        "end": "2018-09-29",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2018",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 53265000000,
        "start": "2018-04-01",
        "end": "2018-06-30",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2018Q2",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 61137000000,
        "start": "2017-12-31",
        "end": "2018-03-31",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2018Q1",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 88293000000,
        "start": "2017-10-01",
        "end": "2017-12-30",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2017Q4",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 52579000000,
        "start": "2017-07-02",
        "end": "2017-09-30",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2017Q3",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 229234000000,
        "start": "2016-09-25",
        "end": "2017-09-30",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2017",
        "accession": "0000320193-18-000145"
      },
      {
        "value": 45408000000,
        "start": "2017-04-02",
        "end": "2017-07-01",
        "fiscal_year": 2018,
        "fiscal_period": "FY",
        "form": "10-K",
        "filed": "2018-11-05",
        "frame": "CY2017Q2",
        "accession": "0000320193-18-000145"
      }
    ]
  },
  "source": "sec_edgar",
  "as_of": "2018-11-05T00:00:00.000Z"
}
GET/api/v1/company-facts/{ticker}$0.02

Every reported financial fact for a company, latest value each, straight from SEC XBRL

Every XBRL financial fact a company has reported to the SEC, each collapsed to its latest value: tag, taxonomy, label, unit, the figure, and the period/form/filing it came from. Filter with `?taxonomy=us-gaap|dei`, `?search=revenue`, and `?limit=`. Discover which metrics exist for a ticker before drilling into the full series via /concept. Sourced from SEC EDGAR.

Example request
GET /api/v1/company-facts/AAPL
Response type (TypeScript)
interface CompanyFactsResponse {
  ticker: string;
  data: {
    entity_name: string;
    cik: string;
    taxonomy: string;
    search: null;
    total_facts: number;
    count: number;
    facts: Array<{
      tag: string;
      taxonomy: string;
      label: string;
      unit: string;
      latest_value: number;
      end: string;
      fiscal_year: number;
      fiscal_period: string;
      form: string;
      filed: string;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "entity_name": "Apple Inc.",
    "cik": "0000320193",
    "taxonomy": "all",
    "search": null,
    "total_facts": 505,
    "count": 30,
    "facts": [
      {
        "tag": "EntityCommonStockSharesOutstanding",
        "taxonomy": "dei",
        "label": "Entity Common Stock, Shares Outstanding",
        "unit": "shares",
        "latest_value": 14687356000,
        "end": "2026-04-17",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AccountsPayableCurrent",
        "taxonomy": "us-gaap",
        "label": "Accounts Payable, Current",
        "unit": "USD",
        "latest_value": 57349000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AccountsReceivableNetCurrent",
        "taxonomy": "us-gaap",
        "label": "Accounts Receivable, after Allowance for Credit Loss, Current",
        "unit": "USD",
        "latest_value": 30339000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AccumulatedDepreciationDepletionAndAmortizationPropertyPlantAndEquipment",
        "taxonomy": "us-gaap",
        "label": "Accumulated Depreciation, Depletion and Amortization, Property, Plant, and Equipment",
        "unit": "USD",
        "latest_value": 77441000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AccumulatedOtherComprehensiveIncomeLossNetOfTax",
        "taxonomy": "us-gaap",
        "label": "Accumulated Other Comprehensive Income (Loss), Net of Tax",
        "unit": "USD",
        "latest_value": -5375000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AllocatedShareBasedCompensationExpense",
        "taxonomy": "us-gaap",
        "label": "Share-based Payment Arrangement, Expense",
        "unit": "USD",
        "latest_value": 7122000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "Assets",
        "taxonomy": "us-gaap",
        "label": "Assets",
        "unit": "USD",
        "latest_value": 371082000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AssetsCurrent",
        "taxonomy": "us-gaap",
        "label": "Assets, Current",
        "unit": "USD",
        "latest_value": 144114000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "AssetsNoncurrent",
        "taxonomy": "us-gaap",
        "label": "Assets, Noncurrent",
        "unit": "USD",
        "latest_value": 226968000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CashAndCashEquivalentsAtCarryingValue",
        "taxonomy": "us-gaap",
        "label": "Cash and Cash Equivalents, at Carrying Value",
        "unit": "USD",
        "latest_value": 45572000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalents",
        "taxonomy": "us-gaap",
        "label": "Cash, Cash Equivalents, Restricted Cash and Restricted Cash Equivalents",
        "unit": "USD",
        "latest_value": 45572000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalentsPeriodIncreaseDecreaseIncludingExchangeRateEffect",
        "taxonomy": "us-gaap",
        "label": "Cash, Cash Equivalents, Restricted Cash and Restricted Cash Equivalents, Period Increase (Decrease), Including Exchange Rate Effect",
        "unit": "USD",
        "latest_value": 9638000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CommercialPaper",
        "taxonomy": "us-gaap",
        "label": "Commercial Paper",
        "unit": "USD",
        "latest_value": 1997000000,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CommonStockDividendsPerShareDeclared",
        "taxonomy": "us-gaap",
        "label": "Common Stock, Dividends, Per Share, Declared",
        "unit": "USD/shares",
        "latest_value": 0.52,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CommonStockParOrStatedValuePerShare",
        "taxonomy": "us-gaap",
        "label": "Common Stock, Par or Stated Value Per Share",
        "unit": "USD/shares",
        "latest_value": 0.00001,
        "end": "2026-03-28",
        "fiscal_year": 2026,
        "fiscal_period": "Q2",
        "form": "10-Q",
        "filed": "2026-05-01"
      },
      {
        "tag": "CommonStockSharesAuthorized",
        "taxonomy": "us-gaap",
        "label": "Common Stock, Shares Authorized",
        "unit": "shares",
        "latest
… (truncated — call the endpoint for the full response)
GET/api/v1/frames$0.02

Compare one financial metric across every public company for a single period

One reported XBRL financial fact for every company that disclosed it in a calendar period, for peer screening. Pass ?tag= (e.g. Revenues), ?period= (CY2024, CY2024Q1, or CY2024Q1I for balance-sheet facts), ?taxonomy= (default us-gaap), ?unit= (default USD), and ?limit=. Sorted by value. Sourced from SEC EDGAR.

Example request
GET /api/v1/frames
Response type (TypeScript)
interface FramesResponse {
  source: string;
  as_of: string;
  tag: string;
  taxonomy: string;
  label: string;
  unit: string;
  period: string;
  total_filers: number;
  count: number;
  data: Array<{
    cik: string;
    entity: string;
    value: number;
    start: string;
    end: string;
    accession: string;
  }>;
}
Example response (click to expand)
{
  "source": "sec_edgar",
  "as_of": "2026-06-01T21:38:25.440Z",
  "tag": "Revenues",
  "taxonomy": "us-gaap",
  "label": "Revenues",
  "unit": "USD",
  "period": "CY2023",
  "total_filers": 2666,
  "count": 10,
  "data": [
    {
      "cik": "0000104169",
      "entity": "Walmart Inc.",
      "value": 648125000000,
      "start": "2023-02-01",
      "end": "2024-01-31",
      "accession": "0000104169-26-000055"
    },
    {
      "cik": "0000731766",
      "entity": "UnitedHealth Group Incorporated",
      "value": 371622000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0000731766-26-000062"
    },
    {
      "cik": "0001067983",
      "entity": "BERKSHIRE HATHAWAY INC",
      "value": 364482000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0001193125-26-083899"
    },
    {
      "cik": "0000064803",
      "entity": "CVS HEALTH CORPORATION",
      "value": 357776000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0000064803-26-000010"
    },
    {
      "cik": "0000034088",
      "entity": "Exxon Mobil Corporation",
      "value": 344582000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0000034088-26-000045"
    },
    {
      "cik": "0001652044",
      "entity": "Alphabet Inc.",
      "value": 307394000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0001652044-26-000018"
    },
    {
      "cik": "0001140859",
      "entity": "Cencora, Inc.",
      "value": 262173411000,
      "start": "2022-10-01",
      "end": "2023-09-30",
      "accession": "0001140859-26-000012"
    },
    {
      "cik": "0000909832",
      "entity": "COSTCO WHOLESALE CORP /NEW",
      "value": 242290000000,
      "start": "2022-08-29",
      "end": "2023-09-03",
      "accession": "0000909832-25-000101"
    },
    {
      "cik": "0000721371",
      "entity": "Cardinal Health, Inc.",
      "value": 204979000000,
      "start": "2022-07-01",
      "end": "2023-06-30",
      "accession": "0000721371-25-000079"
    },
    {
      "cik": "0000093410",
      "entity": "Chevron Corp",
      "value": 200949000000,
      "start": "2023-01-01",
      "end": "2023-12-31",
      "accession": "0000093410-26-000078"
    }
  ]
}
GET/api/v1/form-3/{ticker}$0.02

Initial insider ownership from SEC Form 3: holdings reported when an insider role begins

Initial beneficial-ownership holdings parsed from SEC Form 3 filings, the first report an insider files on becoming a director, officer, or 10% holder. Each holding carries the security, shares owned, direct or indirect ownership, and derivative terms. Complements Form 4 transactions. ?limit= filings (default 5). Sourced from SEC EDGAR.

Example request
GET /api/v1/form-3/AAPL
Response type (TypeScript)
interface Form3Response {
  ticker: string;
  data: {
    filings_parsed: number;
    holding_count: number;
    holdings: Array<{
      owner_name: string;
      is_director: boolean;
      is_officer: boolean;
      officer_title: string;
      is_ten_percent_owner: boolean;
      filing_date: string;
      accession: string;
      url: string;
      security: string;
      shares: number;
      direct_or_indirect: string;
      nature_of_ownership: string;
      is_derivative: boolean;
      exercise_price: null;
      exercise_date: null;
      expiration_date: null;
      underlying_security: string;
      underlying_shares: number;
    }>;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "filings_parsed": 5,
    "holding_count": 23,
    "holdings": [
      {
        "owner_name": "Newstead Jennifer",
        "is_director": false,
        "is_officer": true,
        "officer_title": "SVP, GC and Secretary",
        "is_ten_percent_owner": false,
        "filing_date": "2026-03-06",
        "accession": "0001780525-26-000003",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000178052526000003/wk-form3_1772839848.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 301040
      },
      {
        "owner_name": "Newstead Jennifer",
        "is_director": false,
        "is_officer": true,
        "officer_title": "SVP, GC and Secretary",
        "is_ten_percent_owner": false,
        "filing_date": "2026-03-06",
        "accession": "0001780525-26-000003",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000178052526000003/wk-form3_1772839848.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 48871
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Common Stock",
        "shares": 39130,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": false,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": null,
        "underlying_shares": null
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 1080
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 1898
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 2223
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security": "Common Stock",
        "underlying_shares": 2643
      },
      {
        "owner_name": "Borders Ben",
        "is_director": false,
        "is_officer": true,
        "officer_title": "Principal Accounting Officer",
        "is_ten_percent_owner": false,
        "filing_date": "2026-01-02",
        "accession": "0002100523-26-000002",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000210052326000002/wk-form3_1767396618.xml",
        "security": "Restricted Stock Unit",
        "shares": null,
        "direct_or_indirect": "D",
        "nature_of_ownership": null,
        "is_derivative": true,
        "exercise_price": null,
        "exercise_date": null,
        "expiration_date": null,
        "underlying_security
… (truncated — call the endpoint for the full response)
GET/api/v1/fund-holdings/{cik}$0.03

Institutional 13F holdings for a fund by CIK: every position, value, and shares

The latest 13F-HR institutional holdings for a fund or investment manager, looked up by its SEC CIK. Returns every reported position with issuer, CUSIP, market value, share count, option type, and voting authority, plus the portfolio's total value, sorted largest first. ?limit= positions. Sourced from SEC EDGAR.

Example request
GET /api/v1/fund-holdings/0000320193
Response type (TypeScript)
interface FundHoldingsResponse {
  cik: string;
  filer: string;
  source: string;
  as_of: string;
  data: {
    form: string;
    accession: string;
    filing_date: string;
    report_date: string;
    total_positions: number;
    total_value: number;
    count: number;
    holdings: Array<{
      issuer: string;
      title_of_class: string;
      cusip: string;
      value: number;
      shares: number;
      shares_type: string;
      put_call: null;
      investment_discretion: string;
      voting_sole: number;
      voting_shared: number;
      voting_none: number;
    }>;
  };
}
Example response (click to expand)
{
  "cik": "0001067983",
  "filer": "BERKSHIRE HATHAWAY INC",
  "source": "sec_edgar",
  "as_of": "2026-05-15T00:00:00.000Z",
  "data": {
    "form": "13F-HR",
    "accession": "0001193125-26-226661",
    "filing_date": "2026-05-15",
    "report_date": "2026-03-31",
    "total_positions": 90,
    "total_value": 263095703570,
    "count": 10,
    "holdings": [
      {
        "issuer": "AMERICAN EXPRESS CO",
        "title_of_class": "COM",
        "cusip": "025816109",
        "value": 45087984892,
        "shares": 149061045,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 149061045,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "COCA COLA CO",
        "title_of_class": "COM",
        "cusip": "191216100",
        "value": 21501063540,
        "shares": 282722729,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 282722729,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "APPLE INC",
        "title_of_class": "COM",
        "cusip": "037833100",
        "value": 20471924668,
        "shares": 80664820,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 80664820,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "OCCIDENTAL PETE CORP",
        "title_of_class": "COM",
        "cusip": "674599105",
        "value": 17221193015,
        "shares": 264941431,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 264941431,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "APPLE INC",
        "title_of_class": "COM",
        "cusip": "037833100",
        "value": 15618994925,
        "shares": 61542988,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 61542988,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "BANK AMERICA CORP",
        "title_of_class": "COM",
        "cusip": "060505104",
        "value": 15151500000,
        "shares": 310800000,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 310800000,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "CHEVRON CORPORATION",
        "title_of_class": "COM",
        "cusip": "166764100",
        "value": 12052286868,
        "shares": 58251749,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 58251749,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "ALPHABET INC",
        "title_of_class": "CAP STK CL A",
        "cusip": "02079K305",
        "value": 11871367661,
        "shares": 41283098,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 41283098,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "CHUBB LTD SWITZ",
        "title_of_class": "COM",
        "cusip": "H1467J104",
        "value": 11162836215,
        "shares": 34249183,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 34249183,
        "voting_shared": 0,
        "voting_none": 0
      },
      {
        "issuer": "APPLE INC",
        "title_of_class": "COM",
        "cusip": "037833100",
        "value": 8812603960,
        "shares": 34724000,
        "shares_type": "SH",
        "put_call": null,
        "investment_discretion": "DFND",
        "voting_sole": 34724000,
        "voting_shared": 0,
        "voting_none": 0
      }
    ]
  }
}
GET/api/v1/dossier/{ticker}$0.05

SEC filing dossier in one call: recent filings, insider trades, material 8-K events, and Form 3

A company's recent SEC disclosure picture in one call: the filings index, insider transactions from Form 4 with a net buy/sell signal, material 8-K events by item code, and initial holdings from Form 3. The CIK is resolved once and shared across sections (faster than four separate calls), at a lower combined price. From SEC EDGAR; sections degrade independently.

Example request
GET /api/v1/dossier/AAPL

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

Government & policy

Congressional trades disclosed under the STOCK Act.

GET/api/v1/congress-trades$0.03

US congressional stock trades (House & Senate) from STOCK Act disclosures: who traded what, when, and how much

Recent stock trades disclosed by US members of Congress under the STOCK Act, parsed live from official House and Senate Periodic Transaction Reports: per trade the member, chamber, ticker, asset, buy/sell type, date, and disclosed dollar range. ?chamber=house|senate|both, ?ticker=AAPL, ?limit= recent filings per chamber (max 20). From US House & Senate.

Example request
GET /api/v1/congress-trades
Response type (TypeScript)
interface CongressTradesResponse {
  source: string;
  as_of: string;
  chamber: string;
  disclosure: string;
  trade_count: number;
  trades: Array<{
    asset: string;
    ticker: string;
    asset_type: string;
    owner: string;
    transaction_code: string;
    transaction_type: string;
    transaction_date: string;
    notification_date: string;
    amount_range: string;
    amount_min: number;
    amount_max: number;
    chamber: string;
    member: string;
    state: string;
    district: string;
    filing_date: string;
    doc_id: string;
    pdf_url: string;
  }>;
}
Example response (click to expand)
{
  "source": "us_congress",
  "as_of": "2026-05-31T00:00:00.000Z",
  "chamber": "both",
  "disclosure": "stock_act_periodic_transaction_report",
  "trade_count": 78,
  "trades": [
    {
      "asset": "Apple Inc. - Common Stock",
      "ticker": "AAPL",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "P",
      "transaction_type": "purchase",
      "transaction_date": "2026-05-14",
      "notification_date": "2026-05-31",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. Ed Case",
      "state": "HI",
      "district": "HI01",
      "filing_date": "2026-05-31",
      "doc_id": "20034668",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034668.pdf"
    },
    {
      "asset": "Alphabet Inc. - Class A Common Stock",
      "ticker": "GOOGL",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "S",
      "transaction_type": "sale",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$15,001 - $50,000",
      "amount_min": 15001,
      "amount_max": 50000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "Sardinia Ready Mix 401(k) - Dave Alphabet Inc. - Class A Common Stock",
      "ticker": "GOOGL",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "S",
      "transaction_type": "sale",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "1 (Home Grown) Apple Inc. - Common Stock",
      "ticker": "AAPL",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "S",
      "transaction_type": "sale",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "1 (Home Grown) Apple Inc. - Common Stock",
      "ticker": "AAPL",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "S",
      "transaction_type": "sale",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "Sardinia Ready Mix 401(k) - Dave AT&T Inc.",
      "ticker": "T",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "P",
      "transaction_type": "purchase",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "Sardinia Ready Mix 401(k) - Dave AT&T Inc.",
      "ticker": "T",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "P",
      "transaction_type": "purchase",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "Home Depot, Inc.",
      "ticker": "HD",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "P",
      "transaction_type": "purchase",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20034650.pdf"
    },
    {
      "asset": "Sardinia Ready Mix 401(k) - Dave Home Depot, Inc.",
      "ticker": "HD",
      "asset_type": "ST",
      "owner": null,
      "transaction_code": "P",
      "transaction_type": "purchase",
      "transaction_date": "2026-05-15",
      "notification_date": "2026-05-28",
      "amount_range": "$1,001 - $15,000",
      "amount_min": 1001,
      "amount_max": 15000,
      "chamber": "house",
      "member": "Hon. David J. Taylor",
      "state": "OH",
      "district": "OH02",
      "filing_date": "2026-05-28",
      "doc_id": "20034650",
      "pdf_url": "https://dis
… (truncated — call the endpoint for the full response)

US macro

Fed funds, GDP, money supply, inflation (CPI/PCE), the jobs market, market-signal series (VIX, yield-curve & credit spreads, recession odds), and the macro bundle.

GET/api/v1/fed-funds$0.01

Effective federal funds rate (the Fed's policy rate), monthly, with recent history

The effective federal funds rate — the Fed's benchmark policy rate that anchors every other US interest rate — as a monthly average in percent, with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. The rate every rate-sensitive analysis starts from. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/fed-funds
Response type (TypeScript)
interface FedFundsResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-05-01T00:00:00.000Z",
  "series_id": "FEDFUNDS",
  "title": "Effective Federal Funds Rate",
  "unit": "percent",
  "frequency": "monthly",
  "latest": {
    "date": "2026-05-01",
    "value": 3.63
  },
  "prior": {
    "date": "2026-04-01",
    "value": 3.64
  },
  "change": -0.01,
  "change_percent": -0.27,
  "yoy_percent": -16.17,
  "history": [
    {
      "date": "2026-05-01",
      "value": 3.63
    },
    {
      "date": "2026-04-01",
      "value": 3.64
    },
    {
      "date": "2026-03-01",
      "value": 3.64
    },
    {
      "date": "2026-02-01",
      "value": 3.64
    },
    {
      "date": "2026-01-01",
      "value": 3.64
    },
    {
      "date": "2025-12-01",
      "value": 3.72
    },
    {
      "date": "2025-11-01",
      "value": 3.88
    },
    {
      "date": "2025-10-01",
      "value": 4.09
    },
    {
      "date": "2025-09-01",
      "value": 4.22
    },
    {
      "date": "2025-08-01",
      "value": 4.33
    },
    {
      "date": "2025-07-01",
      "value": 4.33
    },
    {
      "date": "2025-06-01",
      "value": 4.33
    },
    {
      "date": "2025-05-01",
      "value": 4.33
    },
    {
      "date": "2025-04-01",
      "value": 4.33
    },
    {
      "date": "2025-03-01",
      "value": 4.33
    },
    {
      "date": "2025-02-01",
      "value": 4.33
    },
    {
      "date": "2025-01-01",
      "value": 4.33
    },
    {
      "date": "2024-12-01",
      "value": 4.48
    },
    {
      "date": "2024-11-01",
      "value": 4.64
    },
    {
      "date": "2024-10-01",
      "value": 4.83
    },
    {
      "date": "2024-09-01",
      "value": 5.13
    },
    {
      "date": "2024-08-01",
      "value": 5.33
    },
    {
      "date": "2024-07-01",
      "value": 5.33
    },
    {
      "date": "2024-06-01",
      "value": 5.33
    }
  ]
}
GET/api/v1/gdp$0.01

US real GDP, quarterly, with quarter-over-quarter and year-over-year change

US real Gross Domestic Product, quarterly, in billions of chained 2017 dollars (seasonally adjusted annual rate), with the latest reading, prior quarter, quarter-over-quarter and year-over-year change, and recent history. No ticker needed. The broad measure of economic output for macro-aware analysis. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/gdp
Response type (TypeScript)
interface GdpResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-01-01T00:00:00.000Z",
  "series_id": "GDPC1",
  "title": "Real Gross Domestic Product",
  "unit": "billions_of_chained_2017_usd_saar",
  "frequency": "quarterly",
  "latest": {
    "date": "2026-01-01",
    "value": 24152.656
  },
  "prior": {
    "date": "2025-10-01",
    "value": 24055.749
  },
  "change": 96.907,
  "change_percent": 0.4,
  "yoy_percent": 2.57,
  "history": [
    {
      "date": "2026-01-01",
      "value": 24152.656
    },
    {
      "date": "2025-10-01",
      "value": 24055.749
    },
    {
      "date": "2025-07-01",
      "value": 24026.834
    },
    {
      "date": "2025-04-01",
      "value": 23770.976
    },
    {
      "date": "2025-01-01",
      "value": 23548.21
    },
    {
      "date": "2024-10-01",
      "value": 23586.542
    },
    {
      "date": "2024-07-01",
      "value": 23478.57
    },
    {
      "date": "2024-04-01",
      "value": 23286.508
    },
    {
      "date": "2024-01-01",
      "value": 23082.119
    },
    {
      "date": "2023-10-01",
      "value": 23033.78
    },
    {
      "date": "2023-07-01",
      "value": 22840.989
    },
    {
      "date": "2023-04-01",
      "value": 22580.499
    },
    {
      "date": "2023-01-01",
      "value": 22439.607
    },
    {
      "date": "2022-10-01",
      "value": 22278.345
    },
    {
      "date": "2022-07-01",
      "value": 22125.625
    },
    {
      "date": "2022-04-01",
      "value": 21967.045
    },
    {
      "date": "2022-01-01",
      "value": 21932.71
    },
    {
      "date": "2021-10-01",
      "value": 21988.737
    },
    {
      "date": "2021-07-01",
      "value": 21617.828
    },
    {
      "date": "2021-04-01",
      "value": 21440.929
    },
    {
      "date": "2021-01-01",
      "value": 21082.134
    },
    {
      "date": "2020-10-01",
      "value": 20791.917
    },
    {
      "date": "2020-07-01",
      "value": 20558.879
    },
    {
      "date": "2020-04-01",
      "value": 19077.992
    }
  ]
}
GET/api/v1/money-supply$0.01

US M2 money supply, monthly, with month-over-month and year-over-year change

US M2 money stock, monthly, in billions of dollars (seasonally adjusted), with the latest value, prior month, month-over-month and year-over-year change, and recent history. No ticker needed. A liquidity gauge watched for inflation and risk-asset context. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/money-supply
Response type (TypeScript)
interface MoneySupplyResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series_id": "M2SL",
  "title": "M2 Money Stock",
  "unit": "billions_of_usd",
  "frequency": "monthly",
  "latest": {
    "date": "2026-04-01",
    "value": 22804.5
  },
  "prior": {
    "date": "2026-03-01",
    "value": 22686.4
  },
  "change": 118.1,
  "change_percent": 0.52,
  "yoy_percent": 4.72,
  "history": [
    {
      "date": "2026-04-01",
      "value": 22804.5
    },
    {
      "date": "2026-03-01",
      "value": 22686.4
    },
    {
      "date": "2026-02-01",
      "value": 22627
    },
    {
      "date": "2026-01-01",
      "value": 22429.3
    },
    {
      "date": "2025-12-01",
      "value": 22353.5
    },
    {
      "date": "2025-11-01",
      "value": 22277.4
    },
    {
      "date": "2025-10-01",
      "value": 22245.1
    },
    {
      "date": "2025-09-01",
      "value": 22170.3
    },
    {
      "date": "2025-08-01",
      "value": 22086.9
    },
    {
      "date": "2025-07-01",
      "value": 22020
    },
    {
      "date": "2025-06-01",
      "value": 21938.8
    },
    {
      "date": "2025-05-01",
      "value": 21834
    },
    {
      "date": "2025-04-01",
      "value": 21775.7
    },
    {
      "date": "2025-03-01",
      "value": 21693.7
    },
    {
      "date": "2025-02-01",
      "value": 21613.5
    },
    {
      "date": "2025-01-01",
      "value": 21548.1
    },
    {
      "date": "2024-12-01",
      "value": 21485.9
    },
    {
      "date": "2024-11-01",
      "value": 21452.2
    },
    {
      "date": "2024-10-01",
      "value": 21331.9
    },
    {
      "date": "2024-09-01",
      "value": 21269.5
    },
    {
      "date": "2024-08-01",
      "value": 21186.8
    },
    {
      "date": "2024-07-01",
      "value": 21095.3
    },
    {
      "date": "2024-06-01",
      "value": 21068.4
    },
    {
      "date": "2024-05-01",
      "value": 21020.7
    }
  ]
}
GET/api/v1/inflation$0.02

US CPI inflation: headline and core index with year-over-year percent

US consumer price inflation from the Bureau of Labor Statistics: the latest headline CPI-U and core (ex food and energy) index levels with year-over-year percent change, plus recent monthly history. No ticker needed. Use for macro-aware analysis without leaving for a separate data source. Sourced from US BLS.

Example request
GET /api/v1/inflation
Response type (TypeScript)
interface InflationResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  headline: {
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  core: {
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  history: Array<{
    date: string;
    period_name: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_bls",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "cpi_u_us_city_average",
  "unit": "index_1982_84=100",
  "headline": {
    "latest_index": 333.02,
    "latest_month": "2026-04",
    "yoy_percent": 3.81
  },
  "core": {
    "latest_index": 335.803,
    "latest_month": "2026-04",
    "yoy_percent": 2.75
  },
  "history": [
    {
      "date": "2026-04",
      "period_name": "April",
      "value": 333.02
    },
    {
      "date": "2026-03",
      "period_name": "March",
      "value": 330.213
    },
    {
      "date": "2026-02",
      "period_name": "February",
      "value": 326.785
    },
    {
      "date": "2026-01",
      "period_name": "January",
      "value": 325.252
    },
    {
      "date": "2025-12",
      "period_name": "December",
      "value": 324.054
    },
    {
      "date": "2025-11",
      "period_name": "November",
      "value": 324.122
    },
    {
      "date": "2025-09",
      "period_name": "September",
      "value": 324.8
    },
    {
      "date": "2025-08",
      "period_name": "August",
      "value": 323.976
    },
    {
      "date": "2025-07",
      "period_name": "July",
      "value": 323.048
    },
    {
      "date": "2025-06",
      "period_name": "June",
      "value": 322.561
    },
    {
      "date": "2025-05",
      "period_name": "May",
      "value": 321.465
    },
    {
      "date": "2025-04",
      "period_name": "April",
      "value": 320.795
    },
    {
      "date": "2025-03",
      "period_name": "March",
      "value": 319.799
    }
  ]
}
GET/api/v1/pce$0.02

PCE inflation (the Fed's preferred gauge): headline and core index with year-over-year

US PCE (Personal Consumption Expenditures) price inflation — the Fed's preferred inflation gauge — with the latest headline and core (ex food and energy) index levels, each with year-over-year percent change, plus recent monthly history. No ticker needed. Complements the CPI endpoint with the measure the Fed actually targets. Sourced from the St. Louis Fed (FRED).

Example request
GET /api/v1/pce
Response type (TypeScript)
interface PceResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  headline: {
    series_id: string;
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  core: {
    series_id: string;
    latest_index: number;
    latest_month: string;
    yoy_percent: number;
  };
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "pce_price_index",
  "unit": "index_2017=100",
  "headline": {
    "series_id": "PCEPI",
    "latest_index": 130.902,
    "latest_month": "2026-04-01",
    "yoy_percent": 3.77
  },
  "core": {
    "series_id": "PCEPILFE",
    "latest_index": 129.63,
    "latest_month": "2026-04-01",
    "yoy_percent": 3.29
  },
  "history": [
    {
      "date": "2026-04-01",
      "value": 130.902
    },
    {
      "date": "2026-03-01",
      "value": 130.381
    },
    {
      "date": "2026-02-01",
      "value": 129.52
    },
    {
      "date": "2026-01-01",
      "value": 129.002
    },
    {
      "date": "2025-12-01",
      "value": 128.576
    },
    {
      "date": "2025-11-01",
      "value": 128.152
    },
    {
      "date": "2025-10-01",
      "value": 127.871
    },
    {
      "date": "2025-09-01",
      "value": 127.625
    },
    {
      "date": "2025-08-01",
      "value": 127.293
    },
    {
      "date": "2025-07-01",
      "value": 126.96
    },
    {
      "date": "2025-06-01",
      "value": 126.743
    },
    {
      "date": "2025-05-01",
      "value": 126.38
    },
    {
      "date": "2025-04-01",
      "value": 126.15
    },
    {
      "date": "2025-03-01",
      "value": 125.941
    },
    {
      "date": "2025-02-01",
      "value": 125.921
    },
    {
      "date": "2025-01-01",
      "value": 125.417
    },
    {
      "date": "2024-12-01",
      "value": 124.979
    },
    {
      "date": "2024-11-01",
      "value": 124.637
    },
    {
      "date": "2024-10-01",
      "value": 124.494
    },
    {
      "date": "2024-09-01",
      "value": 124.164
    },
    {
      "date": "2024-08-01",
      "value": 123.889
    },
    {
      "date": "2024-07-01",
      "value": 123.736
    },
    {
      "date": "2024-06-01",
      "value": 123.539
    },
    {
      "date": "2024-05-01",
      "value": 123.348
    }
  ]
}
GET/api/v1/labor-market$0.02

US labor market: unemployment, participation, payrolls, and wage growth

US labor-market headline indicators from the Bureau of Labor Statistics: the unemployment rate, labor force participation rate, total nonfarm payrolls, and average hourly earnings, each with its latest value and change from the prior month. No ticker needed. Sourced from US BLS.

Example request
GET /api/v1/labor-market
Response type (TypeScript)
interface LaborMarketResponse {
  source: string;
  as_of: string;
  series: string;
  metrics: Array<{
    metric: string;
    unit: string;
    latest_value: number;
    latest_month: string;
    prior_value: number;
    change: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_bls",
  "as_of": "2026-04-01T00:00:00.000Z",
  "series": "us_labor_market_headline",
  "metrics": [
    {
      "metric": "unemployment_rate",
      "unit": "percent",
      "latest_value": 4.3,
      "latest_month": "2026-04",
      "prior_value": 4.3,
      "change": 0
    },
    {
      "metric": "labor_force_participation_rate",
      "unit": "percent",
      "latest_value": 61.8,
      "latest_month": "2026-04",
      "prior_value": 61.9,
      "change": -0.1
    },
    {
      "metric": "nonfarm_payrolls",
      "unit": "thousands_of_jobs",
      "latest_value": 158736,
      "latest_month": "2026-04",
      "prior_value": 158621,
      "change": 115
    },
    {
      "metric": "avg_hourly_earnings",
      "unit": "usd_per_hour",
      "latest_value": 37.41,
      "latest_month": "2026-04",
      "prior_value": 37.35,
      "change": 0.06
    }
  ]
}
GET/api/v1/treasury-yields$0.01

US Treasury par yield curve (1mo to 30yr) for the latest day or a date range

The daily US Treasury par yield curve (Constant Maturity Treasury rates) for every maturity from 1 month to 30 years, in percent. Defaults to the latest published day; pass `?limit=` for more recent days (max 250) and `?year=YYYY`. No ticker needed. Use for the risk-free rate, rate-sensitivity context, and yield-curve inversion in macro-aware analysis.

Example request
GET /api/v1/treasury-yields
Response type (TypeScript)
interface TreasuryYieldsResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  maturities: string[];
  count: number;
  rates: Array<{
    date: string;
    rates: {
      "1mo": number;
      "1.5mo": number;
      "2mo": number;
      "3mo": number;
      "4mo": number;
      "6mo": number;
      "1yr": number;
      "2yr": number;
      "3yr": number;
      "5yr": number;
      "7yr": number;
      "10yr": number;
      "20yr": number;
      "30yr": number;
    };
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-06-01T00:00:00.000Z",
  "series": "daily_treasury_par_yield_curve",
  "unit": "percent",
  "maturities": [
    "1mo",
    "1.5mo",
    "2mo",
    "3mo",
    "4mo",
    "6mo",
    "1yr",
    "2yr",
    "3yr",
    "5yr",
    "7yr",
    "10yr",
    "20yr",
    "30yr"
  ],
  "count": 1,
  "rates": [
    {
      "date": "2026-06-01",
      "rates": {
        "1mo": 3.72,
        "1.5mo": 3.71,
        "2mo": 3.73,
        "3mo": 3.78,
        "4mo": 3.8,
        "6mo": 3.79,
        "1yr": 3.83,
        "2yr": 4.05,
        "3yr": 4.09,
        "5yr": 4.18,
        "7yr": 4.32,
        "10yr": 4.47,
        "20yr": 4.99,
        "30yr": 4.99
      }
    }
  ]
}
GET/api/v1/fred/{series}$0.01

Key market-signal macro series from the Fed (FRED): VIX, yield-curve & credit spreads, breakevens, jobless claims, sentiment, mortgage rate, recession odds

Pull a key market-signal macro series from the Federal Reserve (FRED) by slug: vix, yield-curve-10y-2y, yield-curve-10y-3m, high-yield-spread, ig-spread, breakeven-10y, real-yield-10y, jobless-claims, consumer-sentiment, mortgage-30y, financial-conditions, recession-probability. Each returns the latest value, prior, change, year-over-year, and recent history. No ticker needed.

Example request
GET /api/v1/fred/vix
Response type (TypeScript)
interface FredSeriesResponse {
  source: string;
  as_of: string;
  series_id: string;
  title: string;
  unit: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  yoy_percent: null;
  history: Array<{
    date: string;
    value: number;
  }>;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-06-04T00:00:00.000Z",
  "series_id": "VIXCLS",
  "title": "CBOE Volatility Index (VIX)",
  "unit": "index",
  "frequency": "daily",
  "latest": {
    "date": "2026-06-04",
    "value": 15.4
  },
  "prior": {
    "date": "2026-06-03",
    "value": 16.06
  },
  "change": -0.66,
  "change_percent": -4.11,
  "yoy_percent": null,
  "history": [
    {
      "date": "2026-06-04",
      "value": 15.4
    },
    {
      "date": "2026-06-03",
      "value": 16.06
    },
    {
      "date": "2026-06-02",
      "value": 15.77
    },
    {
      "date": "2026-06-01",
      "value": 16.05
    },
    {
      "date": "2026-05-29",
      "value": 15.32
    },
    {
      "date": "2026-05-28",
      "value": 15.74
    },
    {
      "date": "2026-05-27",
      "value": 16.29
    },
    {
      "date": "2026-05-26",
      "value": 17.01
    },
    {
      "date": "2026-05-25",
      "value": 16.59
    },
    {
      "date": "2026-05-22",
      "value": 16.7
    },
    {
      "date": "2026-05-21",
      "value": 16.76
    },
    {
      "date": "2026-05-20",
      "value": 17.44
    },
    {
      "date": "2026-05-19",
      "value": 18.06
    },
    {
      "date": "2026-05-18",
      "value": 17.82
    },
    {
      "date": "2026-05-15",
      "value": 18.43
    },
    {
      "date": "2026-05-14",
      "value": 17.26
    },
    {
      "date": "2026-05-13",
      "value": 17.87
    },
    {
      "date": "2026-05-12",
      "value": 17.99
    },
    {
      "date": "2026-05-11",
      "value": 18.38
    },
    {
      "date": "2026-05-08",
      "value": 17.19
    },
    {
      "date": "2026-05-07",
      "value": 17.08
    },
    {
      "date": "2026-05-06",
      "value": 17.39
    },
    {
      "date": "2026-05-05",
      "value": 17.38
    },
    {
      "date": "2026-05-04",
      "value": 18.29
    }
  ]
}
GET/api/v1/macro$0.05

US macro dashboard in one call: Fed funds, CPI, PCE, jobs, GDP, and the Treasury yield curve

The US macro backdrop in one call: the federal funds rate, CPI and PCE inflation, the labor market (unemployment, payrolls, wages), real GDP, and the Treasury yield curve. No ticker needed. Replaces six macro calls (fed-funds + inflation + pce + labor-market + gdp + treasury-yields) at a lower combined price. Spans FRED, BLS, Treasury; sections degrade independently.

Example request
GET /api/v1/macro

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

Futures positioning (CFTC)

Weekly Commitments of Traders positioning across equity-index, metal, energy, FX, rates, and crypto futures.

GET/api/v1/cot$0.02

Commitments of Traders snapshot: net futures positioning across major equity-index, metal, energy, FX, rates & crypto markets in one call

The weekly CFTC Commitments of Traders positioning across major futures markets in one call: for each market the open interest, non-commercial (large speculator) net position and weekly change, and commercial (hedger) net position. Covers equity indices, gold/silver, crude/natural gas, major FX, the 10-year note, and bitcoin. No ticker needed. Sourced from the US CFTC.

Example request
GET /api/v1/cot
Response type (TypeScript)
interface CotResponse {
  source: string;
  as_of: string;
  report: string;
  markets: Array<{
    market: string;
    contract_code: string;
    name: string;
    group: string;
    report_date: string;
    open_interest: number;
    open_interest_change: number;
    noncommercial_net: number;
    noncommercial_net_change: number;
    commercial_net: number;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "cftc",
  "as_of": "2026-06-02T00:00:00.000Z",
  "report": "legacy_futures_only",
  "markets": [
    {
      "market": "sp500",
      "contract_code": "13874A",
      "name": "E-Mini S&P 500",
      "group": "equity_index",
      "report_date": "2026-06-02",
      "open_interest": 2149231,
      "open_interest_change": 55610,
      "noncommercial_net": -220768,
      "noncommercial_net_change": -54937,
      "commercial_net": 110074
    },
    {
      "market": "nasdaq",
      "contract_code": "209742",
      "name": "Nasdaq-100 Mini",
      "group": "equity_index",
      "report_date": "2026-06-02",
      "open_interest": 314972,
      "open_interest_change": 11982,
      "noncommercial_net": -14949,
      "noncommercial_net_change": -8864,
      "commercial_net": 13812
    },
    {
      "market": "gold",
      "contract_code": "088691",
      "name": "Gold",
      "group": "metals",
      "report_date": "2026-06-02",
      "open_interest": 326052,
      "open_interest_change": -27437,
      "noncommercial_net": 176020,
      "noncommercial_net_change": 21760,
      "commercial_net": -206345
    },
    {
      "market": "silver",
      "contract_code": "084691",
      "name": "Silver",
      "group": "metals",
      "report_date": "2026-06-02",
      "open_interest": 102809,
      "open_interest_change": 1065,
      "noncommercial_net": 23926,
      "noncommercial_net_change": 1703,
      "commercial_net": -42661
    },
    {
      "market": "crude-oil",
      "contract_code": "067651",
      "name": "WTI Crude Oil",
      "group": "energy",
      "report_date": "2026-06-02",
      "open_interest": 2025180,
      "open_interest_change": 21385,
      "noncommercial_net": 155874,
      "noncommercial_net_change": -5124,
      "commercial_net": -188109
    },
    {
      "market": "natural-gas",
      "contract_code": "023651",
      "name": "Natural Gas (Henry Hub)",
      "group": "energy",
      "report_date": "2026-06-02",
      "open_interest": 1664003,
      "open_interest_change": 23921,
      "noncommercial_net": -186115,
      "noncommercial_net_change": 17066,
      "commercial_net": 173913
    },
    {
      "market": "euro",
      "contract_code": "099741",
      "name": "Euro FX",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 842424,
      "open_interest_change": 18200,
      "noncommercial_net": 48866,
      "noncommercial_net_change": 19440,
      "commercial_net": -69396
    },
    {
      "market": "british-pound",
      "contract_code": "096742",
      "name": "British Pound",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 271147,
      "open_interest_change": -10918,
      "noncommercial_net": -52218,
      "noncommercial_net_change": 9180,
      "commercial_net": 61093
    },
    {
      "market": "japanese-yen",
      "contract_code": "097741",
      "name": "Japanese Yen",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 505555,
      "open_interest_change": 78261,
      "noncommercial_net": -129567,
      "noncommercial_net_change": -14900,
      "commercial_net": 127768
    },
    {
      "market": "swiss-franc",
      "contract_code": "092741",
      "name": "Swiss Franc",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 111432,
      "open_interest_change": 5838,
      "noncommercial_net": -32909,
      "noncommercial_net_change": 2231,
      "commercial_net": 44829
    },
    {
      "market": "us-dollar-index",
      "contract_code": "098662",
      "name": "U.S. Dollar Index",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 43090,
      "open_interest_change": 812,
      "noncommercial_net": 3758,
      "noncommercial_net_change": 2908,
      "commercial_net": -5402
    },
    {
      "market": "10y-note",
      "contract_code": "043602",
      "name": "10-Year U.S. Treasury Note",
      "group": "rates",
      "report_date": "2026-06-02",
      "open_interest": 5323279,
      "open_interest_change": -931193,
      "noncommercial_net": -829575,
      "noncommercial_net_change": -41621,
      "commercial_net": 821742
    },
    {
      "market": "bitcoin",
      "contract_code": "133741",
      "name": "Bitcoin",
      "group": "crypto",
      "report_date": "2026-06-02",
      "open_interest": 19882,
      "open_interest_change": -1743,
      "noncommercial_net": 2458,
      "noncommercial_net_change": 176,
      "commercial_net": -2595
    }
  ],
  "attribution": "Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders"
}
GET/api/v1/cot/{market}$0.01

Commitments of Traders for one futures market: long/short/net by trader group, with weekly changes and history

CFTC Commitments of Traders for one futures market by slug: sp500, nasdaq, gold, silver, crude-oil, natural-gas, euro, british-pound, japanese-yen, swiss-franc, us-dollar-index, 10y-note, bitcoin. Returns open interest and non-commercial, commercial, and non-reportable long/short/net with weekly changes plus net history. `?weeks=` 12 (max 52). From the US CFTC.

Example request
GET /api/v1/cot/gold
Response type (TypeScript)
interface CotMarketResponse {
  source: string;
  as_of: string;
  market: string;
  contract_code: string;
  name: string;
  group: string;
  latest: {
    report_date: string;
    open_interest: number;
    open_interest_change: number;
    noncommercial: {
      long: number;
      short: number;
      spreading: number;
      net: number;
      long_change: number;
      short_change: number;
    };
    commercial: {
      long: number;
      short: number;
      net: number;
      long_change: number;
      short_change: number;
    };
    nonreportable: {
      long: number;
      short: number;
      net: number;
    };
    total_traders: number;
  };
  history: Array<{
    report_date: string;
    open_interest: number;
    noncommercial_net: number;
    commercial_net: number;
  }>;
  report: string;
  attribution: string;
}
Example response (click to expand)
{
  "source": "cftc",
  "as_of": "2026-06-02T00:00:00.000Z",
  "market": "gold",
  "contract_code": "088691",
  "name": "Gold",
  "group": "metals",
  "latest": {
    "report_date": "2026-06-02",
    "open_interest": 326052,
    "open_interest_change": -27437,
    "noncommercial": {
      "long": 206096,
      "short": 30076,
      "spreading": 22449,
      "net": 176020,
      "long_change": 5392,
      "short_change": -16368
    },
    "commercial": {
      "long": 53851,
      "short": 260196,
      "net": -206345,
      "long_change": -20790,
      "short_change": -211
    },
    "nonreportable": {
      "long": 43656,
      "short": 13331,
      "net": 30325
    },
    "total_traders": 258
  },
  "history": [
    {
      "report_date": "2026-06-02",
      "open_interest": 326052,
      "noncommercial_net": 176020,
      "commercial_net": -206345
    },
    {
      "report_date": "2026-05-26",
      "open_interest": 353489,
      "noncommercial_net": 154260,
      "commercial_net": -185766
    },
    {
      "report_date": "2026-05-19",
      "open_interest": 379325,
      "noncommercial_net": 159833,
      "commercial_net": -191629
    },
    {
      "report_date": "2026-05-12",
      "open_interest": 376496,
      "noncommercial_net": 171622,
      "commercial_net": -210258
    },
    {
      "report_date": "2026-05-05",
      "open_interest": 367932,
      "noncommercial_net": 163303,
      "commercial_net": -198935
    },
    {
      "report_date": "2026-04-28",
      "open_interest": 369530,
      "noncommercial_net": 159571,
      "commercial_net": -194813
    },
    {
      "report_date": "2026-04-21",
      "open_interest": 365842,
      "noncommercial_net": 164006,
      "commercial_net": -202940
    },
    {
      "report_date": "2026-04-14",
      "open_interest": 362274,
      "noncommercial_net": 162526,
      "commercial_net": -201082
    },
    {
      "report_date": "2026-04-07",
      "open_interest": 354877,
      "noncommercial_net": 156305,
      "commercial_net": -193751
    },
    {
      "report_date": "2026-03-31",
      "open_interest": 361409,
      "noncommercial_net": 163202,
      "commercial_net": -201640
    },
    {
      "report_date": "2026-03-24",
      "open_interest": 403925,
      "noncommercial_net": 168327,
      "commercial_net": -203828
    },
    {
      "report_date": "2026-03-17",
      "open_interest": 411388,
      "noncommercial_net": 159869,
      "commercial_net": -198648
    }
  ],
  "report": "legacy_futures_only",
  "attribution": "Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders"
}

Treasury & debt

US public debt, average interest rates, and Treasury reporting FX rates.

GET/api/v1/national-debt$0.01

US national debt to the penny: total public debt outstanding with daily change

The total US public debt outstanding to the penny — the headline national-debt figure — split into debt held by the public and intragovernmental holdings, with the latest value, prior business day, day-over-day change, and recent history. No ticker needed. Updates each business day. Sourced from the US Treasury (FiscalData). Pass `?limit=` for more history (default 30, max 250).

Example request
GET /api/v1/national-debt
Response type (TypeScript)
interface NationalDebtResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  latest: {
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  };
  prior: {
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  };
  change: number;
  change_percent: number;
  history: Array<{
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-06-03T00:00:00.000Z",
  "series": "debt_to_penny",
  "unit": "usd",
  "latest": {
    "date": "2026-06-03",
    "total_public_debt_outstanding": 39204974715248.65,
    "debt_held_by_public": 31599703500408.55,
    "intragovernmental_holdings": 7605271214840.1
  },
  "prior": {
    "date": "2026-06-02",
    "total_public_debt_outstanding": 39221984586285.3,
    "debt_held_by_public": 31597886394124.88,
    "intragovernmental_holdings": 7624098192160.42
  },
  "change": -17009871036.65,
  "change_percent": -0.0434,
  "history": [
    {
      "date": "2026-06-03",
      "total_public_debt_outstanding": 39204974715248.65,
      "debt_held_by_public": 31599703500408.55,
      "intragovernmental_holdings": 7605271214840.1
    },
    {
      "date": "2026-06-02",
      "total_public_debt_outstanding": 39221984586285.3,
      "debt_held_by_public": 31597886394124.88,
      "intragovernmental_holdings": 7624098192160.42
    },
    {
      "date": "2026-06-01",
      "total_public_debt_outstanding": 39195502287422.08,
      "debt_held_by_public": 31581373375160.92,
      "intragovernmental_holdings": 7614128912261.16
    },
    {
      "date": "2026-05-29",
      "total_public_debt_outstanding": 39207759598302.62,
      "debt_held_by_public": 31515369798622.98,
      "intragovernmental_holdings": 7692389799679.64
    },
    {
      "date": "2026-05-28",
      "total_public_debt_outstanding": 39176301795549.4,
      "debt_held_by_public": 31466045143781.76,
      "intragovernmental_holdings": 7710256651767.64
    },
    {
      "date": "2026-05-27",
      "total_public_debt_outstanding": 39163302863182.1,
      "debt_held_by_public": 31450452898651.64,
      "intragovernmental_holdings": 7712849964530.46
    },
    {
      "date": "2026-05-26",
      "total_public_debt_outstanding": 39171154946667.59,
      "debt_held_by_public": 31447423137771.69,
      "intragovernmental_holdings": 7723731808895.9
    },
    {
      "date": "2026-05-22",
      "total_public_debt_outstanding": 39112192265187.75,
      "debt_held_by_public": 31400817772622.92,
      "intragovernmental_holdings": 7711374492564.83
    },
    {
      "date": "2026-05-21",
      "total_public_debt_outstanding": 39071200457366.45,
      "debt_held_by_public": 31374788661132.13,
      "intragovernmental_holdings": 7696411796234.32
    },
    {
      "date": "2026-05-20",
      "total_public_debt_outstanding": 39049639932662.87,
      "debt_held_by_public": 31358949739922.2,
      "intragovernmental_holdings": 7690690192740.67
    },
    {
      "date": "2026-05-19",
      "total_public_debt_outstanding": 39070752626994.13,
      "debt_held_by_public": 31359065157830.45,
      "intragovernmental_holdings": 7711687469163.68
    },
    {
      "date": "2026-05-18",
      "total_public_debt_outstanding": 39008999901378.68,
      "debt_held_by_public": 31317917051386.19,
      "intragovernmental_holdings": 7691082849992.49
    },
    {
      "date": "2026-05-15",
      "total_public_debt_outstanding": 38997244508055.09,
      "debt_held_by_public": 31315583263208.62,
      "intragovernmental_holdings": 7681661244846.47
    },
    {
      "date": "2026-05-14",
      "total_public_debt_outstanding": 38954466670318.2,
      "debt_held_by_public": 31277752122232.96,
      "intragovernmental_holdings": 7676714548085.24
    },
    {
      "date": "2026-05-13",
      "total_public_debt_outstanding": 38942623681847.68,
      "debt_held_by_public": 31269241615132.64,
      "intragovernmental_holdings": 7673382066715.04
    },
    {
      "date": "2026-05-12",
      "total_public_debt_outstanding": 38968295059805.35,
      "debt_held_by_public": 31268302404373.3,
      "intragovernmental_holdings": 7699992655432.05
    },
    {
      "date": "2026-05-11",
      "total_public_debt_outstanding": 38946800561409.14,
      "debt_held_by_public": 31262108319021.06,
      "intragovernmental_holdings": 7684692242388.08
    },
    {
      "date": "2026-05-08",
      "total_public_debt_outstanding": 38937475342585.8,
      "debt_held_by_public": 31260345834577.53,
      "intragovernmental_holdings": 7677129508008.27
    },
    {
      "date": "2026-05-07",
      "total_public_debt_outstanding": 38931651718802.09,
      "debt_held_by_public": 31262325604447.63,
      "intragovernmental_holdings": 7669326114354.46
    },
    {
      "date": "2026-05-06",
      "total_public_debt_outstanding": 38918837926582.9,
      "debt_held_by_public": 31263383766000.16,
      "intragovernmental_holdings": 7655454160582.74
    },
    {
      "date": "2026-05-05",
      "total_public_debt_outstanding": 38910619550278.1,
      "debt_held_by_public": 31261787439569.55,
      "intragovernmental_holdings": 7648832110708.55
    },
    {
      "date": "2026-05-04",
      "total_public_debt_outstanding": 38905034125404.78,
      "debt_held_by_public": 31274803442683.56,
      "intragovernmental_holdings": 7630230682721.22
    },
    {
      "date": "2026-05-01",
      "total_public_debt_outstanding": 38882147615630.53,
      "debt_held_by_public": 31271957838023.21,
      "intragovernmental_holdings": 7610189777607.32
    },
    {
      "date": "2026-04-30",
      "total_public_debt_outstanding": 38967833861543.11,
      "debt_held_by_public": 31272489865435.88,
      "intragovernmental_holdings": 7695343996107.23
    },
    {
      "date": "2026-04-29",
      "total_public_debt_outstanding": 38952075248701.65,
      "debt_held_by_public": 31264482575337.52,
      "intragovernmental_holdings": 7687592673364.13
    },
    {
      "date": "2026-04-28",
      "total_public_debt_outstanding": 38951791901141.8,
      "debt_held_by_public": 31266604928934.45,
      "intragovernmental_holdings": 7685186972207.35
    },
    {
      "date": "2026-04-27",
      "total_public_debt_outstanding": 38960955558731.97,
      "debt_held_by_public": 31289756388875.06,
      "intragovernmental_holdings": 7671199169856.91
    },
    {
      "date": "2026-04-24"
… (truncated — call the endpoint for the full response)
GET/api/v1/avg-interest-rates$0.01

Average interest rate the US Treasury pays on its debt, by security type

The average interest rate the US Treasury currently pays on its outstanding debt, broken out by security (Treasury Bills, Notes, Bonds, TIPS, FRNs, savings, and the marketable/total aggregates) for the latest reported month, in percent. No ticker needed. A read on the government's cost of borrowing that complements the /treasury-yields curve. Sourced from the US Treasury (FiscalData).

Example request
GET /api/v1/avg-interest-rates
Response type (TypeScript)
interface AvgInterestRatesResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  record_date: string;
  count: number;
  rates: Array<{
    security_type: string;
    security: string;
    avg_interest_rate: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-05-31T00:00:00.000Z",
  "series": "avg_interest_rates",
  "unit": "percent",
  "record_date": "2026-05-31",
  "count": 16,
  "rates": [
    {
      "security_type": "Marketable",
      "security": "Treasury Bills",
      "avg_interest_rate": 3.69
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Notes",
      "avg_interest_rate": 3.248
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Bonds",
      "avg_interest_rate": 3.413
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Inflation-Protected Securities (TIPS)",
      "avg_interest_rate": 1.079
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Floating Rate Notes (FRN)",
      "avg_interest_rate": 3.563
    },
    {
      "security_type": "Marketable",
      "security": "Federal Financing Bank",
      "avg_interest_rate": 2.389
    },
    {
      "security_type": "Marketable",
      "security": "Total Marketable",
      "avg_interest_rate": 3.386
    },
    {
      "security_type": "Non-marketable",
      "security": "Domestic Series",
      "avg_interest_rate": 7.577
    },
    {
      "security_type": "Non-marketable",
      "security": "Special Purpose Vehicle",
      "avg_interest_rate": 2.781
    },
    {
      "security_type": "Non-marketable",
      "security": "State and Local Government Series",
      "avg_interest_rate": 3.324
    },
    {
      "security_type": "Non-marketable",
      "security": "United States Savings Securities",
      "avg_interest_rate": 3.169
    },
    {
      "security_type": "Non-marketable",
      "security": "United States Savings Inflation Securities",
      "avg_interest_rate": 4.383
    },
    {
      "security_type": "Non-marketable",
      "security": "Government Account Series",
      "avg_interest_rate": 3.194
    },
    {
      "security_type": "Non-marketable",
      "security": "Government Account Series Inflation Securities",
      "avg_interest_rate": 1.349
    },
    {
      "security_type": "Non-marketable",
      "security": "Total Non-marketable",
      "avg_interest_rate": 3.201
    },
    {
      "security_type": "Interest-bearing Debt",
      "security": "Total Interest-bearing Debt",
      "avg_interest_rate": 3.353
    }
  ]
}
GET/api/v1/exchange-rates$0.02

Official US Treasury reporting rates of exchange for ~170 currencies

Official US Treasury reporting rates of exchange — government FX reference rates for ~170 currencies, in units of foreign currency per 1 USD, for the latest quarter. Use for accounting-grade and exotic-currency conversion the market /api/v1/forex feed lacks. Filter with `?currency=Euro`. Updated quarterly. From the US Treasury (FiscalData).

Example request
GET /api/v1/exchange-rates
Response type (TypeScript)
interface ExchangeRatesResponse {
  source: string;
  as_of: string;
  series: string;
  note: string;
  record_date: string;
  count: number;
  rates: Array<{
    country: string;
    currency: string;
    country_currency: string;
    exchange_rate: number;
    effective_date: string;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-03-31T00:00:00.000Z",
  "series": "rates_of_exchange",
  "note": "Official US Treasury reporting rates of exchange — units of foreign currency per 1 USD. Updated quarterly; use for accounting/reference conversion, not live FX (see /api/v1/forex for market rates).",
  "record_date": "2026-03-31",
  "count": 168,
  "rates": [
    {
      "country": "Afghanistan",
      "currency": "Afghani",
      "country_currency": "Afghanistan-Afghani",
      "exchange_rate": 64.77,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Albania",
      "currency": "Lek",
      "country_currency": "Albania-Lek",
      "exchange_rate": 83.3,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Algeria",
      "currency": "Dinar",
      "country_currency": "Algeria-Dinar",
      "exchange_rate": 132.596,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Angola",
      "currency": "Kwanza",
      "country_currency": "Angola-Kwanza",
      "exchange_rate": 912.13,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Antigua & Barbuda",
      "currency": "East Caribbean Dollar",
      "country_currency": "Antigua & Barbuda-East Caribbean Dollar",
      "exchange_rate": 2.7,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Argentina",
      "currency": "Peso",
      "country_currency": "Argentina-Peso",
      "exchange_rate": 1420,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Armenia",
      "currency": "Dram",
      "country_currency": "Armenia-Dram",
      "exchange_rate": 380,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Australia",
      "currency": "Dollar",
      "country_currency": "Australia-Dollar",
      "exchange_rate": 1.453,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Azerbaijan",
      "currency": "Manat",
      "country_currency": "Azerbaijan-Manat",
      "exchange_rate": 1.7,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bahamas",
      "currency": "Dollar",
      "country_currency": "Bahamas-Dollar",
      "exchange_rate": 1,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bahrain",
      "currency": "Dinar",
      "country_currency": "Bahrain-Dinar",
      "exchange_rate": 0.377,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bangladesh",
      "currency": "Taka",
      "country_currency": "Bangladesh-Taka",
      "exchange_rate": 123,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Barbados",
      "currency": "Dollar",
      "country_currency": "Barbados-Dollar",
      "exchange_rate": 2.02,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Belarus",
      "currency": "New Ruble",
      "country_currency": "Belarus-New Ruble",
      "exchange_rate": 2.951,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Belize",
      "currency": "Dollar",
      "country_currency": "Belize-Dollar",
      "exchange_rate": 2,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Benin",
      "currency": "Cfa Franc",
      "country_currency": "Benin-Cfa Franc",
      "exchange_rate": 567,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bermuda",
      "currency": "Dollar",
      "country_currency": "Bermuda-Dollar",
      "exchange_rate": 1,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bolivia",
      "currency": "Boliviano",
      "country_currency": "Bolivia-Boliviano",
      "exchange_rate": 6.86,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bosnia",
      "currency": "Marka",
      "country_currency": "Bosnia-Marka",
      "exchange_rate": 1.702,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Botswana",
      "currency": "Pula",
      "country_currency": "Botswana-Pula",
      "exchange_rate": 13.021,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Brazil",
      "currency": "Real",
      "country_currency": "Brazil-Real",
      "exchange_rate": 5.254,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Brunei",
      "currency": "Dollar",
      "country_currency": "Brunei-Dollar",
      "exchange_rate": 1.289,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Burkina Faso",
      "currency": "Cfa Franc",
      "country_currency": "Burkina Faso-Cfa Franc",
      "exchange_rate": 567,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Burundi",
      "currency": "Franc",
      "country_currency": "Burundi-Franc",
      "exchange_rate": 3000,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cambodia",
      "currency": "Riel",
      "country_currency": "Cambodia-Riel",
      "exchange_rate": 3995,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cameroon",
      "currency": "Cfa Franc",
      "country_currency": "Cameroon-Cfa Franc",
      "exchange_rate": 570.79,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Canada",
      "currency": "Dollar",
      "country_currency": "Canada-Dollar",
      "exchange_rate": 1.393,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cape Verde",
      "currency": "Escudo",
      "country_currency": "Cape Verde-Escudo",
      "exchange_rate": 95.96,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cayman Islands",
      "currency": "Dollar",
      "country_currency": "Cayman Islands-Dollar",
      "exchange_rate": 0.82,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Central African Republic",
      "currency": "Cfa Franc",
      "country_currency": "Central African Republic-Cfa Franc",
      "exchange_rate": 570.79,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Chad",
      "currency": "Cfa Franc",
      "country_currency": "Chad-Cfa Franc",
      "exchange
… (truncated — call the endpoint for the full response)

Energy & global macro

Energy commodity benchmarks and World Bank international indicators.

GET/api/v1/energy$0.02

Energy commodities snapshot: WTI, Brent, natural gas, gasoline prices in one call

Every energy benchmark in one call: WTI and Brent crude oil spot, Henry Hub natural gas spot, and US regular retail gasoline — each with its latest price, prior reading, and change. The catalog's commodities feed (no equity/forex/crypto endpoint carries these). For one benchmark with history use /api/v1/energy/{product}. Source: U.S. Energy Information Administration (EIA).

Example request
GET /api/v1/energy
Response type (TypeScript)
interface EnergyResponse {
  source: string;
  as_of: string;
  series: string;
  products: Array<{
    product: string;
    series_id: string;
    name: string;
    unit: string;
    eia_units: string;
    frequency: string;
    latest: {
      date: string;
      value: number;
    };
    prior: {
      date: string;
      value: number;
    };
    change: number;
    change_percent: number;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "eia",
  "as_of": "2026-06-01T00:00:00.000Z",
  "series": "energy_prices",
  "products": [
    {
      "product": "wti",
      "series_id": "RWTC",
      "name": "WTI Crude Oil — Cushing, OK Spot Price FOB",
      "unit": "usd_per_barrel",
      "eia_units": "$/BBL",
      "frequency": "daily",
      "latest": {
        "date": "2026-06-01",
        "value": 95.96
      },
      "prior": {
        "date": "2026-05-29",
        "value": 91.16
      },
      "change": 4.8,
      "change_percent": 5.27
    },
    {
      "product": "brent",
      "series_id": "RBRTE",
      "name": "Brent Crude Oil — Europe Spot Price FOB",
      "unit": "usd_per_barrel",
      "eia_units": "$/BBL",
      "frequency": "daily",
      "latest": {
        "date": "2026-06-01",
        "value": 98.29
      },
      "prior": {
        "date": "2026-05-29",
        "value": 92.88
      },
      "change": 5.41,
      "change_percent": 5.82
    },
    {
      "product": "natural-gas",
      "series_id": "RNGWHHD",
      "name": "Henry Hub Natural Gas Spot Price",
      "unit": "usd_per_mmbtu",
      "eia_units": "$/MMBTU",
      "frequency": "daily",
      "latest": {
        "date": "2026-06-01",
        "value": 3.07
      },
      "prior": {
        "date": "2026-05-29",
        "value": 3.34
      },
      "change": -0.27,
      "change_percent": -8.08
    },
    {
      "product": "gasoline",
      "series_id": "EMM_EPMR_PTE_NUS_DPG",
      "name": "U.S. Regular All Formulations Retail Gasoline Price",
      "unit": "usd_per_gallon",
      "eia_units": "$/GAL",
      "frequency": "weekly",
      "latest": {
        "date": "2026-06-01",
        "value": 4.305
      },
      "prior": {
        "date": "2026-05-25",
        "value": 4.475
      },
      "change": -0.17,
      "change_percent": -3.8
    }
  ],
  "attribution": "Source: U.S. Energy Information Administration (EIA)"
}
GET/api/v1/energy/{product}$0.01

One energy benchmark price with history: wti, brent, natural-gas, or gasoline

Price history for one energy benchmark — `wti` (WTI crude, $/bbl), `brent` (Brent crude, $/bbl), `natural-gas` (Henry Hub, $/MMBtu), or `gasoline` (US regular retail, $/gal) — with the latest value, prior reading, change, and recent history. Tune with `?limit=` (default 30, max 365). The catalog's commodities feed. Source: U.S. Energy Information Administration (EIA).

Example request
GET /api/v1/energy/wti
Response type (TypeScript)
interface EnergyPriceResponse {
  source: string;
  as_of: string;
  product: string;
  series_id: string;
  name: string;
  unit: string;
  eia_units: string;
  frequency: string;
  latest: {
    date: string;
    value: number;
  };
  prior: {
    date: string;
    value: number;
  };
  change: number;
  change_percent: number;
  history: Array<{
    date: string;
    value: number;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "eia",
  "as_of": "2026-06-01T00:00:00.000Z",
  "product": "wti",
  "series_id": "RWTC",
  "name": "WTI Crude Oil — Cushing, OK Spot Price FOB",
  "unit": "usd_per_barrel",
  "eia_units": "$/BBL",
  "frequency": "daily",
  "latest": {
    "date": "2026-06-01",
    "value": 95.96
  },
  "prior": {
    "date": "2026-05-29",
    "value": 91.16
  },
  "change": 4.8,
  "change_percent": 5.27,
  "history": [
    {
      "date": "2026-06-01",
      "value": 95.96
    },
    {
      "date": "2026-05-29",
      "value": 91.16
    },
    {
      "date": "2026-05-28",
      "value": 92.65
    },
    {
      "date": "2026-05-27",
      "value": 92.35
    },
    {
      "date": "2026-05-26",
      "value": 97.63
    },
    {
      "date": "2026-05-22",
      "value": 100.35
    },
    {
      "date": "2026-05-21",
      "value": 100.2
    },
    {
      "date": "2026-05-20",
      "value": 101.69
    },
    {
      "date": "2026-05-19",
      "value": 112.09
    },
    {
      "date": "2026-05-18",
      "value": 112.25
    },
    {
      "date": "2026-05-15",
      "value": 108.99
    },
    {
      "date": "2026-05-14",
      "value": 104.66
    },
    {
      "date": "2026-05-13",
      "value": 104.52
    },
    {
      "date": "2026-05-12",
      "value": 105.78
    },
    {
      "date": "2026-05-11",
      "value": 101.56
    },
    {
      "date": "2026-05-08",
      "value": 98.87
    },
    {
      "date": "2026-05-07",
      "value": 98.38
    },
    {
      "date": "2026-05-06",
      "value": 98.75
    },
    {
      "date": "2026-05-05",
      "value": 105.66
    },
    {
      "date": "2026-05-04",
      "value": 109.76
    },
    {
      "date": "2026-05-01",
      "value": 105.38
    },
    {
      "date": "2026-04-30",
      "value": 108.64
    },
    {
      "date": "2026-04-29",
      "value": 110.47
    },
    {
      "date": "2026-04-28",
      "value": 103.45
    },
    {
      "date": "2026-04-27",
      "value": 99.89
    },
    {
      "date": "2026-04-24",
      "value": 98.42
    },
    {
      "date": "2026-04-23",
      "value": 99.27
    },
    {
      "date": "2026-04-22",
      "value": 94.76
    },
    {
      "date": "2026-04-21",
      "value": 93.64
    },
    {
      "date": "2026-04-20",
      "value": 91.06
    }
  ],
  "attribution": "Source: U.S. Energy Information Administration (EIA)"
}
GET/api/v1/world-bank/country/{iso}$0.02

Country macro snapshot: GDP, growth, inflation, unemployment, debt and more in one call

A country's macro profile in one call: latest GDP, GDP growth, GDP per capita, inflation, unemployment, population, government debt, current account, exports, and FDI, from the World Bank's World Development Indicators. Pass an ISO country code in the path (e.g. US, CN, IN, DE). International macro the US-only FRED/BLS endpoints don't cover. Source: World Bank (CC BY 4.0).

Example request
GET /api/v1/world-bank/country/US
Response type (TypeScript)
interface WorldBankResponse {
  source: string;
  as_of: string;
  country: {
    code: string;
    name: string;
    iso3: string;
  };
  indicators: Array<{
    indicator: string;
    indicator_code: string;
    indicator_name: string;
    latest: {
      year: string;
      value: number;
    };
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "world_bank",
  "as_of": "2025-12-31T00:00:00.000Z",
  "country": {
    "code": "US",
    "name": "United States",
    "iso3": "USA"
  },
  "indicators": [
    {
      "indicator": "gdp",
      "indicator_code": "NY.GDP.MKTP.CD",
      "indicator_name": "GDP (current US$)",
      "latest": {
        "year": "2024",
        "value": 28750956130731.2
      }
    },
    {
      "indicator": "gdp-growth",
      "indicator_code": "NY.GDP.MKTP.KD.ZG",
      "indicator_name": "GDP growth (annual %)",
      "latest": {
        "year": "2024",
        "value": 2.79300127716779
      }
    },
    {
      "indicator": "gdp-per-capita",
      "indicator_code": "NY.GDP.PCAP.CD",
      "indicator_name": "GDP per capita (current US$)",
      "latest": {
        "year": "2024",
        "value": 84534.0407841548
      }
    },
    {
      "indicator": "inflation",
      "indicator_code": "FP.CPI.TOTL.ZG",
      "indicator_name": "Inflation, consumer prices (annual %)",
      "latest": {
        "year": "2024",
        "value": 2.94952520485207
      }
    },
    {
      "indicator": "unemployment",
      "indicator_code": "SL.UEM.TOTL.ZS",
      "indicator_name": "Unemployment, total (% of total labor force) (modeled ILO estimate)",
      "latest": {
        "year": "2025",
        "value": 4.198
      }
    },
    {
      "indicator": "population",
      "indicator_code": "SP.POP.TOTL",
      "indicator_name": "Population, total",
      "latest": {
        "year": "2024",
        "value": 340110988
      }
    },
    {
      "indicator": "govt-debt",
      "indicator_code": "GC.DOD.TOTL.GD.ZS",
      "indicator_name": "Central government debt, total (% of GDP)",
      "latest": {
        "year": "2024",
        "value": 117.973234857902
      }
    },
    {
      "indicator": "current-account",
      "indicator_code": "BN.CAB.XOKA.GD.ZS",
      "indicator_name": "Current account balance (% of GDP)",
      "latest": {
        "year": "2024",
        "value": -4.12262463415284
      }
    },
    {
      "indicator": "exports",
      "indicator_code": "NE.EXP.GNFS.ZS",
      "indicator_name": "Exports of goods and services (% of GDP)",
      "latest": {
        "year": "2024",
        "value": 11.1074566893674
      }
    },
    {
      "indicator": "fdi",
      "indicator_code": "BX.KLT.DINV.WD.GD.ZS",
      "indicator_name": "Foreign direct investment, net inflows (% of GDP)",
      "latest": {
        "year": "2024",
        "value": 1.03321085618604
      }
    }
  ],
  "attribution": "Source: World Bank, World Development Indicators (CC BY 4.0)"
}
GET/api/v1/world-bank/{indicator}$0.01

One World Bank indicator's annual time series for any country

Annual time series of one World Bank indicator for a country, with latest value, prior year, and change. Indicators: gdp, gdp-growth, gdp-per-capita, inflation, unemployment, population, govt-debt, current-account, exports, fdi. Pick the country with `?country=US` (ISO2/ISO3, default US) and the span with `?limit=` years (default 10). Cross-country macro reference. Source: World Bank (CC BY 4.0).

Example request
GET /api/v1/world-bank/NY.GDP.MKTP.CD
Response type (TypeScript)
interface WorldBankIndicatorResponse {
  source: string;
  as_of: string;
  indicator: string;
  indicator_code: string;
  indicator_name: string;
  country: {
    code: string;
    name: string;
    iso3: string;
  };
  last_updated: string;
  latest: {
    year: string;
    value: number;
  };
  prior: {
    year: string;
    value: number;
  };
  change: number;
  change_percent: number;
  history: Array<{
    year: string;
    value: number;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "world_bank",
  "as_of": "2024-12-31T00:00:00.000Z",
  "indicator": "gdp",
  "indicator_code": "NY.GDP.MKTP.CD",
  "indicator_name": "GDP (current US$)",
  "country": {
    "code": "US",
    "name": "United States",
    "iso3": "USA"
  },
  "last_updated": "2026-04-08",
  "latest": {
    "year": "2024",
    "value": 28750956130731.2
  },
  "prior": {
    "year": "2023",
    "value": 27292170793214.4
  },
  "change": 1458785337516.8008,
  "change_percent": 5.35,
  "history": [
    {
      "year": "2025",
      "value": null
    },
    {
      "year": "2024",
      "value": 28750956130731.2
    },
    {
      "year": "2023",
      "value": 27292170793214.4
    },
    {
      "year": "2022",
      "value": 25604848907611
    },
    {
      "year": "2021",
      "value": 23315080560000
    },
    {
      "year": "2020",
      "value": 21060473613000
    },
    {
      "year": "2019",
      "value": 21380976119000
    },
    {
      "year": "2018",
      "value": 20533057312000
    },
    {
      "year": "2017",
      "value": 19477336549000
    },
    {
      "year": "2016",
      "value": 18695110842000
    }
  ],
  "attribution": "Source: World Bank, World Development Indicators (CC BY 4.0)"
}

Private & pre-IPO

Pre-IPO valuations via PreStocks Solana tokens — the catalog's only private-company feed.

GET/api/v1/private-stocks$0.02

Pre-IPO private company prices: Anthropic, OpenAI, SpaceX, Anduril and more in one call

Live valuations for private, pre-IPO companies — Anthropic, OpenAI, SpaceX, Anduril, Neuralink, Kalshi, Polymarket — in one call, via PreStocks Solana tokens backed 1:1 by SPV exposure. Per company: mark price and valuation, on-chain token price and implied valuation, the token's premium/discount, supply, and contract. The catalog's only pre-IPO feed.

Example request
GET /api/v1/private-stocks

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

GET/api/v1/private-stocks/{symbol}$0.01

One pre-IPO private company's price and valuation (e.g. ANTHROPIC, SPACEX)

The current valuation of one private, pre-IPO company by symbol — e.g. ANTHROPIC, OPENAI, SPACEX, ANDURIL, NEURALINK, KALSHI, POLYMARKET — via its PreStocks Solana token, backed 1:1 by SPV exposure. Returns the SPV mark price and valuation, the on-chain token price and implied valuation, the token's premium/discount, supply, and contract. List them all at /api/v1/private-stocks.

Example request
GET /api/v1/private-stocks/SYMBOL

Example response coming soon — call the endpoint to see the live shape, or check /openapi.json.

Multi-source bundles

One call that replaces a whole sequence, priced below the parts.

GET/api/v1/overview/{ticker}$0.05

Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers

Use when you need a full picture of one US-listed stock without making a dozen calls. Returns company profile, delayed price with OHLCV, fundamentals with computed P/E and margins, dividend yield, splits and corporate events, technical indicators (RSI, SMA, EMA, MACD) with neutral zone labels, recent news, and peers. A `sections` map flags anything unavailable.

Example request
GET /api/v1/overview/AAPL
Response type (TypeScript)
interface OverviewResponse {
  ticker: string;
  source: string;
  as_of: string;
  sections: {
    profile: string;
    price: string;
    fundamentals: string;
    dividends: string;
    corporate_actions: string;
    technicals: string;
    news: string;
    peers: string;
  };
  profile: {
    name: string;
    exchange: string;
    type: string;
    sector: string;
    sic_code: string;
    market_cap: number;
    shares_outstanding: number;
    employees: number;
    list_date: string;
    homepage: string;
    description: string;
    logo_url: string;
  };
  price: {
    last: number;
    change: number;
    change_percent: number;
    day: {
      open: number;
      high: number;
      low: number;
      close: number;
      volume: number;
      vwap: number;
    };
    previous_close: number;
    is_delayed: boolean;
    delayed_by: string;
    timestamp: null;
  };
  fundamentals: {
    period: string;
    fiscal_period: string;
    fiscal_year: null;
    end_date: string;
    revenue: number;
    net_income: number;
    gross_profit: number;
    eps: number;
    pe_ratio: number;
    gross_margin_percent: number;
    net_margin_percent: number;
  };
  dividends: {
    annualized_amount: number;
    yield_percent: null;
    frequency: number;
    last: {
      cash_amount: number;
      ex_dividend_date: string;
      pay_date: string;
    };
    count: number;
  };
  corporate_actions: {
    splits: Array<{
      execution_date: string;
      type: string;
      split_from: number;
      split_to: number;
      ratio: number;
      ratio_text: string;
    }>;
    events: Array<{
      type: string;
      date: string;
      ticker: string;
    }>;
  };
  technicals: {
    rsi_14: {
      value: number;
      zone: string;
    };
    sma_50: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    ema_20: {
      value: number;
      price_vs_percent: number;
      position: string;
    };
    macd: {
      value: number;
      signal: number;
      histogram: number;
      position: string;
    };
  };
  news: Array<{
    title: string;
    url: string;
    publisher: string;
    published_at: string;
    tickers: string[];
  }>;
  peers: string[];
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:30.950Z",
  "sections": {
    "profile": "ok",
    "price": "ok",
    "fundamentals": "ok",
    "dividends": "ok",
    "corporate_actions": "ok",
    "technicals": "ok",
    "news": "ok",
    "peers": "ok"
  },
  "profile": {
    "name": "Apple Inc.",
    "exchange": "XNAS",
    "type": "CS",
    "sector": "ELECTRONIC COMPUTERS",
    "sic_code": "3571",
    "market_cap": 4583336313360,
    "shares_outstanding": 14687356000,
    "employees": 166000,
    "list_date": "1980-12-12",
    "homepage": "https://www.apple.com",
    "description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses. Apple's iPhone makes up a majority of the firm sales, and Apple's other products like Mac, iPad, and Watch are designed around the iPhone as the focal point of an expansive software ecosystem. Apple has progressively worked to add new applications, like streaming video, subscription bundles, and augmented reality. The firm designs its own software and semiconductors while working with subcontractors like Foxconn and TSMC to build its products and chips. Slightly less than half of Apple's sales come directly through its flagship stores, with a majority of sales coming indirectly through partnerships and distribution.",
    "logo_url": "https://api.massive.com/v1/reference/company-branding/YXBwbGUuY29t/images/2025-04-04_logo.svg"
  },
  "price": {
    "last": 0,
    "change": 0,
    "change_percent": 0,
    "day": {
      "open": 0,
      "high": 0,
      "low": 0,
      "close": 0,
      "volume": 0,
      "vwap": 0
    },
    "previous_close": 312.06,
    "is_delayed": true,
    "delayed_by": "15 minutes",
    "timestamp": null
  },
  "fundamentals": {
    "period": "ttm",
    "fiscal_period": "TTM",
    "fiscal_year": null,
    "end_date": "2026-03-28",
    "revenue": 451442000000,
    "net_income": 122575000000,
    "gross_profit": 216071000000,
    "eps": 8.26,
    "pe_ratio": 0,
    "gross_margin_percent": 47.86,
    "net_margin_percent": 27.15
  },
  "dividends": {
    "annualized_amount": 1.08,
    "yield_percent": null,
    "frequency": 4,
    "last": {
      "cash_amount": 0.27,
      "ex_dividend_date": "2026-05-11",
      "pay_date": "2026-05-14"
    },
    "count": 8
  },
  "corporate_actions": {
    "splits": [
      {
        "execution_date": "2020-08-31",
        "type": "forward",
        "split_from": 1,
        "split_to": 4,
        "ratio": 4,
        "ratio_text": "4:1"
      },
      {
        "execution_date": "2014-06-09",
        "type": "forward",
        "split_from": 1,
        "split_to": 7,
        "ratio": 7,
        "ratio_text": "7:1"
      },
      {
        "execution_date": "2005-02-28",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "2000-06-21",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      },
      {
        "execution_date": "1987-06-16",
        "type": "forward",
        "split_from": 1,
        "split_to": 2,
        "ratio": 2,
        "ratio_text": "2:1"
      }
    ],
    "events": [
      {
        "type": "ticker_change",
        "date": "2003-09-10",
        "ticker": "AAPL"
      }
    ]
  },
  "technicals": {
    "rsi_14": {
      "value": 78.56,
      "zone": "overbought"
    },
    "sma_50": {
      "value": 275.2846,
      "price_vs_percent": -100,
      "position": "below"
    },
    "ema_20": {
      "value": 297.8868,
      "price_vs_percent": -100,
      "position": "below"
    },
    "macd": {
      "value": 10.3911,
      "signal": 9.7764,
      "histogram": 0.6147,
      "position": "above_signal"
    }
  },
  "news": [
    {
      "title": "Why This Fund Sold $35 Million of Bristow Group Amid a 40% Stock Surge",
      "url": "https://www.fool.com/coverage/filings/2026/05/31/why-this-fund-sold-usd35-million-of-bristow-group-amid-a-40-stock-surge/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:00:12Z",
      "tickers": [
        "VTOL",
        "AAPL",
        "MSFT",
        "NVDA"
      ]
    },
    {
      "title": "Greg Abel Just Dumped Amazon Stock. Here Are 5 Reasons to Buy It.",
      "url": "https://www.fool.com/investing/2026/05/31/greg-abel-just-dumped-amazon-stock-here-are-5-reas/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T13:05:00Z",
      "tickers": [
        "AMZN",
        "BRK.A",
        "BRK.B",
        "META",
        "AAPL",
        "NVDA"
      ]
    },
    {
      "title": "Apple's AI Future, Stock Surge, Nvidia CEO's New Role And More: This Week In Appleverse",
      "url": "https://www.benzinga.com/markets/tech/26/05/52893985/apples-ai-future-stock-surge-nvidia-ceos-new-role-and-more-this-week-in-appleverse?utm_source=benzinga_taxonomy&utm_medium=rss_feed_free&utm_content=taxonomy_rss&utm_campaign=channel",
      "publisher": "Benzinga",
      "published_at": "2026-05-31T11:01:02Z",
      "tickers": [
        "AAPL",
        "NVDA"
      ]
    },
    {
      "title": "45.7% of Berkshire Hathaway's Portfolio Is Parked in 3 Stocks That Could Pay the Conglomerate $1.6 Billion in Dividends This Year",
      "url": "https://www.fool.com/investing/2026/05/31/457-berkshire-3-stocks-pay-16-billion-dividends/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T10:30:00Z",
      "tickers": [
        "AAPL",
        "AXP",
        "KO",
        "BRK.A",
        "BRK.B"
      ]
    },
    {
      "title": "Wall Street Says the Stock Market's Return Will Crush the Long-Term Average in the Next Year",
      "url": "https://www.fool.com/investing/2026/05/31/stock-market-return-will-crush-long-term-average/?source=iedfolr
… (truncated — call the endpoint for the full response)
GET/api/v1/compare$0.05

Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield

Use to compare 2 to 3 US-listed stocks in one call (peer or watchlist comparisons). For each ticker it returns price and day change, market cap, P/E, EPS, revenue, gross and net margins, and dividend yield, computed from snapshot, fundamentals, and profile data. Pass a comma separated list via `?tickers=AAPL,MSFT,NVDA`.

Example request
GET /api/v1/compare
Response type (TypeScript)
interface CompareResponse {
  source: string;
  as_of: string;
  count: number;
  tickers: string[];
  rows: Array<{
    ticker: string;
    name: string;
    price: number;
    change_percent: number;
    market_cap: number;
    pe_ratio: number;
    eps: number;
    revenue: number;
    gross_margin_percent: number;
    net_margin_percent: number;
    dividend_yield_percent: null;
    available: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:23.966Z",
  "count": 2,
  "tickers": [
    "AAPL",
    "MSFT"
  ],
  "rows": [
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "price": 0,
      "change_percent": 0,
      "market_cap": 4583336313360,
      "pe_ratio": 0,
      "eps": 8.26,
      "revenue": 451442000000,
      "gross_margin_percent": 47.86,
      "net_margin_percent": 27.15,
      "dividend_yield_percent": null,
      "available": "ok"
    },
    {
      "ticker": "MSFT",
      "name": "Microsoft Corp",
      "price": 0,
      "change_percent": 0,
      "market_cap": 3344578441128.96,
      "pe_ratio": 0,
      "eps": 16.79,
      "revenue": 318273000000,
      "gross_margin_percent": 68.31,
      "net_margin_percent": 39.34,
      "dividend_yield_percent": null,
      "available": "ok"
    }
  ]
}
GET/api/v1/market-pulse$0.03

Market movers in one call: top gainers, top losers, market status, news

Use to find the day's biggest movers in one call. Returns the top 10 gainers and top 10 losers by percent move with price, the current US market session status (open, closed, pre, or post), and the latest market news headlines. No ticker needed. Built for agents scanning what is moving today.

Example request
GET /api/v1/market-pulse
Response type (TypeScript)
interface MarketPulseResponse {
  source: string;
  as_of: string;
  market_status: {
    market: string;
    early_hours: boolean;
    after_hours: boolean;
  };
  gainers: unknown[];
  losers: unknown[];
  news: Array<{
    title: string;
    url: string;
    publisher: string;
    published_at: string;
    tickers: string[];
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T15:19:41-04:00",
  "market_status": {
    "market": "closed",
    "early_hours": false,
    "after_hours": false
  },
  "gainers": [],
  "losers": [],
  "news": [
    {
      "title": "What to Know About This Fund's $194 Million Exit From a China Logistics Stock",
      "url": "https://www.fool.com/coverage/filings/2026/05/31/what-to-know-about-this-fund-s-usd194-million-exit-from-a-china-logistics-stock/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:33:16Z",
      "tickers": [
        "YMM",
        "NU",
        "CPNG"
      ]
    },
    {
      "title": "The S&P 500's Dividend Yield Hasn't Been This Low Since the 1800s. That Makes This Top Dividend ETF Even More Enticing.",
      "url": "https://www.fool.com/investing/2026/05/31/the-sp-500s-dividend-yield-hasnt-been-this-low-sin/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:30:00Z",
      "tickers": [
        "SCHD",
        "VOO"
      ]
    },
    {
      "title": "Futu Investor News: If You Have Suffered Losses in Futu Holdings Limited (NASDAQ: FUTU), You Are Encouraged to Contact The Rosen Law Firm About Your Rights",
      "url": "https://www.globenewswire.com/news-release/2026/05/31/3303941/673/en/Futu-Investor-News-If-You-Have-Suffered-Losses-in-Futu-Holdings-Limited-NASDAQ-FUTU-You-Are-Encouraged-to-Contact-The-Rosen-Law-Firm-About-Your-Rights.html",
      "publisher": "GlobeNewswire Inc.",
      "published_at": "2026-05-31T18:27:00Z",
      "tickers": [
        "FUTU",
        "TIGR"
      ]
    },
    {
      "title": "This Is My Best Artificial Intelligence (AI) Stock to Buy in June (Hint: It's Not Micron Technology)",
      "url": "https://www.fool.com/investing/2026/05/31/this-is-my-best-artificial-intelligence-ai-stock-t/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:23:00Z",
      "tickers": [
        "CIEN",
        "MU"
      ]
    },
    {
      "title": "Is This Ultimate High-Yield Stock Actually Going to $0?",
      "url": "https://www.fool.com/investing/2026/05/31/is-this-ultimate-highyield-stock-actually-going-to/?source=iedfolrf0000001",
      "publisher": "The Motley Fool",
      "published_at": "2026-05-31T18:15:00Z",
      "tickers": [
        "CAG"
      ]
    }
  ]
}

News & market

Headlines and free market-status / holiday calendars.

GET/api/v1/news$0.02

Latest news articles, optionally filtered by ticker

Curated stock-market news with ticker tags, source, publisher, image, and timestamps. Pass `?ticker=AAPL` to filter.

Example request
GET /api/v1/news
Response type (TypeScript)
interface NewsResponse {
  source: string;
  as_of: string;
  count: number;
  articles: Array<{
    id: string;
    title: string;
    description: string;
    url: string;
    image_url: string;
    author: string;
    publisher: string;
    publisher_homepage: string;
    published_at: string;
    tickers: string[];
    keywords: string[];
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:20:16.414Z",
  "count": 10,
  "articles": [
    {
      "id": "f0285c3945e98745a6b93c7694b0fd9c353a283ca06db0490a28f1d0a6a6f7e9",
      "title": "Why This Fund Sold $35 Million of Bristow Group Amid a 40% Stock Surge",
      "description": "South Dakota Investment Council sold 801,900 shares of Bristow Group (valued at $35.24 million) in Q1 2026, reducing its stake to 1.8% of reportable assets. Despite the sale, Bristow Group shares have surged 40% over the past year, outperforming the S&P 500's 28% gain. The company reported strong Q1 results with revenue of $388.7 million and maintained its 2026 adjusted EBITDA guidance of $295-$325 million, citing growth opportunities in defense spending, energy security, and electric aircraft.",
      "url": "https://www.fool.com/coverage/filings/2026/05/31/why-this-fund-sold-usd35-million-of-bristow-group-amid-a-40-stock-surge/?source=iedfolrf0000001",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fcdn.content.foolcdn.com%2Fimages%2F1umn9qeh%2Fproduction%2F1a599f395be31e2f508c3aa7decb988f9ce983b7-1401x1251.png%3Fw%3D800%26q%3D75%26fit%3Dmax%26auto%3Dformat&w=1200&op=resize",
      "author": "Jonathan Ponciano",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T18:00:12Z",
      "tickers": [
        "VTOL",
        "AAPL",
        "MSFT",
        "NVDA"
      ],
      "keywords": [
        "fund sale",
        "position reduction",
        "stock surge",
        "aviation services",
        "offshore energy",
        "defense spending",
        "EBITDA guidance"
      ]
    },
    {
      "id": "2e3d51de95c615581f69c8f2e0caa6ee9bda71fb6e8d35e2606bd33c8fc7ef17",
      "title": "Greg Abel Just Dumped Amazon Stock. Here Are 5 Reasons to Buy It.",
      "description": "Despite Berkshire Hathaway's recent sale of Amazon stock, the article argues Amazon remains an attractive buy for retail investors. The company is capitalizing on AI opportunities through AWS, custom chips, and development tools, while maintaining strong e-commerce growth and preparing to launch satellite broadband services. Amazon trades at a P/E of 32, which the author considers attractive given its growth prospects.",
      "url": "https://www.fool.com/investing/2026/05/31/greg-abel-just-dumped-amazon-stock-here-are-5-reas/?source=iedfolrf0000001",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fg.foolcdn.com%2Feditorial%2Fimages%2F871972%2Famazon-driver.jpg&w=1200&op=resize",
      "author": "Jennifer Saibil",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T13:05:00Z",
      "tickers": [
        "AMZN",
        "BRK.A",
        "BRK.B",
        "META",
        "AAPL",
        "NVDA"
      ],
      "keywords": [
        "Amazon",
        "artificial intelligence",
        "AWS",
        "cloud computing",
        "e-commerce",
        "satellite broadband",
        "semiconductor chips",
        "stock valuation"
      ]
    },
    {
      "id": "94cc128e6c62097cc5af6be43cd2b81b7ab44d469aac0283803233cc3d8d196f",
      "title": "Apple's AI Future, Stock Surge, Nvidia CEO's New Role And More: This Week In Appleverse",
      "description": "Apple's stock surged 15% in May, driven by speculation about its position in AI and the 'agentic smartphone opportunity,' with Bank of America raising its price target to $380. Meanwhile, Nvidia CEO Jensen Huang joined the advisory board of Tsinghua University's School of Economics and Management in China.",
      "url": "https://www.benzinga.com/markets/tech/26/05/52893985/apples-ai-future-stock-surge-nvidia-ceos-new-role-and-more-this-week-in-appleverse?utm_source=benzinga_taxonomy&utm_medium=rss_feed_free&utm_content=taxonomy_rss&utm_campaign=channel",
      "image_url": "https://cdn.benzinga.com/cdn-cgi/image/width=1200,height=800,fit=crop/files/images/story/2026/05/31/Apple-logo-is-seen-at-the-Apple-Wangfuji.jpeg",
      "author": "Mohd Haider",
      "publisher": "Benzinga",
      "publisher_homepage": "https://www.benzinga.com/",
      "published_at": "2026-05-31T11:01:02Z",
      "tickers": [
        "AAPL",
        "NVDA"
      ],
      "keywords": [
        "Apple AI",
        "agentic smartphone",
        "stock surge",
        "Nvidia CEO",
        "Tsinghua University",
        "Bank of America price target",
        "valuation driver"
      ]
    },
    {
      "id": "dca90f5ce47b368023c90a0fe0efa4ec0de6443b5d05051ea0e3c39acc927f7b",
      "title": "45.7% of Berkshire Hathaway's Portfolio Is Parked in 3 Stocks That Could Pay the Conglomerate $1.6 Billion in Dividends This Year",
      "description": "Berkshire Hathaway's three largest stock holdings, Apple, American Express, and Coca-Cola, collectively represent 45.7% of its $330 billion portfolio and are expected to generate $1.6 billion in combined dividend payments in 2026. These long-standing positions demonstrate the power of dividend reinvestment and compounding returns under Warren Buffett's investment philosophy, which new CEO Greg Abel is expected to continue.",
      "url": "https://www.fool.com/investing/2026/05/31/457-berkshire-3-stocks-pay-16-billion-dividends/?source=iedfolrf0000001",
      "image_url": "https://g.foolcdn.com/image/?url=https%3A%2F%2Fg.foolcdn.com%2Feditorial%2Fimages%2F872145%2Fa-candid-shot-of-warren-buffett-looking-away-from-the-camera.jpg&w=1200&op=resize",
      "author": "Anthony Di Pizio",
      "publisher": "The Motley Fool",
      "publisher_homepage": "https://www.fool.com/",
      "published_at": "2026-05-31T10:30:00Z",
      "tickers": [
        "AAPL",
        "AXP",
        "KO",
        "BRK.A",
        "BRK.B"
      ],
      "keywords": [
        "Berkshire Hathaway",
        "dividend payments",
        "portfolio concentration",
        "long-term investing",
        "compounding returns",
        "War
… (truncated — call the endpoint for the full response)
GET/api/v1/market-statusfree

Current US market status (open / closed / pre / post)

Free endpoint. Returns whether US equities markets are currently in regular, pre-market, after-hours, or closed sessions.

Example request
GET /api/v1/market-status
Response type (TypeScript)
interface MarketStatusResponse {
  source: string;
  as_of: string;
  market: string;
  early_hours: boolean;
  after_hours: boolean;
  exchanges: {
    nasdaq: string;
    nyse: string;
    otc: string;
  };
  currencies: {
    crypto: string;
    fx: string;
  };
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T19:53:16-04:00",
  "market": "extended-hours",
  "early_hours": false,
  "after_hours": true,
  "exchanges": {
    "nasdaq": "extended-hours",
    "nyse": "extended-hours",
    "otc": "closed"
  },
  "currencies": {
    "crypto": "open",
    "fx": "open"
  }
}
GET/api/v1/market-holidaysfree

Upcoming US market holidays & early closes

Free endpoint. Upcoming market holidays and early-close days per exchange, with date, status, and (for early closes) open/close times.

Example request
GET /api/v1/market-holidays
Response type (TypeScript)
interface MarketHolidaysResponse {
  source: string;
  as_of: string;
  count: number;
  holidays: Array<{
    date: string;
    exchange: string;
    name: string;
    status: string;
    open: string;
    close: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-06-01T23:53:16.954Z",
  "count": 24,
  "holidays": [
    {
      "date": "2026-06-19",
      "exchange": "NYSE",
      "name": "Juneteenth",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-06-19",
      "exchange": "NASDAQ",
      "name": "Juneteenth",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-07-03",
      "exchange": "NASDAQ",
      "name": "Independence Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-07-03",
      "exchange": "NYSE",
      "name": "Independence Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-09-07",
      "exchange": "NASDAQ",
      "name": "Labor Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-09-07",
      "exchange": "NYSE",
      "name": "Labor Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-26",
      "exchange": "NASDAQ",
      "name": "Thanksgiving",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-26",
      "exchange": "NYSE",
      "name": "Thanksgiving",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-11-27",
      "exchange": "NYSE",
      "name": "Thanksgiving",
      "status": "early-close",
      "open": "2026-11-27T14:30:00.000Z",
      "close": "2026-11-27T18:00:00.000Z"
    },
    {
      "date": "2026-11-27",
      "exchange": "NASDAQ",
      "name": "Thanksgiving",
      "status": "early-close",
      "open": "2026-11-27T14:30:00.000Z",
      "close": "2026-11-27T18:00:00.000Z"
    },
    {
      "date": "2026-12-24",
      "exchange": "NASDAQ",
      "name": "Christmas",
      "status": "early-close",
      "open": "2026-12-24T14:30:00.000Z",
      "close": "2026-12-24T18:00:00.000Z"
    },
    {
      "date": "2026-12-24",
      "exchange": "NYSE",
      "name": "Christmas",
      "status": "early-close",
      "open": "2026-12-24T14:30:00.000Z",
      "close": "2026-12-24T18:00:00.000Z"
    },
    {
      "date": "2026-12-25",
      "exchange": "NASDAQ",
      "name": "Christmas",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2026-12-25",
      "exchange": "NYSE",
      "name": "Christmas",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-01",
      "exchange": "NASDAQ",
      "name": "New Years Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-01",
      "exchange": "NYSE",
      "name": "New Years Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-18",
      "exchange": "NASDAQ",
      "name": "Martin Luther King, Jr. Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-01-18",
      "exchange": "NYSE",
      "name": "Martin Luther King, Jr. Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-02-15",
      "exchange": "NYSE",
      "name": "Washington's Birthday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-02-15",
      "exchange": "NASDAQ",
      "name": "Washington's Birthday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-03-26",
      "exchange": "NYSE",
      "name": "Good Friday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-03-26",
      "exchange": "NASDAQ",
      "name": "Good Friday",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-05-31",
      "exchange": "NASDAQ",
      "name": "Memorial Day",
      "status": "closed",
      "open": null,
      "close": null
    },
    {
      "date": "2027-05-31",
      "exchange": "NYSE",
      "name": "Memorial Day",
      "status": "closed",
      "open": null,
      "close": null
    }
  ]
}

More

Additional endpoints.

GET/api/v1/gov-contracts$0.02

Federal contract & grant awards to a company (USAspending.gov)

Federal contract and grant awards to a US company, from USAspending.gov. Pass `?recipient=Lockheed Martin` (required, fuzzy name match) plus optional `?award_type=contracts|grants|all`, `?order=amount|date`, `?limit=` (max 50). Each award carries the award id, amount, awarding agency, period of performance, description, and a usaspending.gov link, with a total. A government-spending catalyst.

Example request
GET /api/v1/gov-contracts
Response type (TypeScript)
interface GovContractsResponse {
  source: string;
  as_of: string;
  recipient: string;
  award_type: string;
  matched_recipients: string[];
  count: number;
  total_awarded: number;
  awards: Array<{
    award_id: string;
    recipient: string;
    amount: number;
    awarding_agency: string;
    awarding_sub_agency: string;
    start_date: string;
    end_date: string;
    description: string;
    url: string;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "usaspending",
  "as_of": "2026-06-05T12:00:00.000Z",
  "recipient": "Lockheed Martin",
  "award_type": "contracts",
  "matched_recipients": [
    "LOCKHEED MARTIN CORP",
    "LOCKHEED MARTIN CORPORATION"
  ],
  "count": 3,
  "total_awarded": 117373237703.48,
  "awards": [
    {
      "award_id": "DEAC0494AL85000",
      "recipient": "LOCKHEED MARTIN CORP",
      "amount": 48063763681.32,
      "awarding_agency": "Department of Energy",
      "awarding_sub_agency": "Department of Energy",
      "start_date": "1993-10-15",
      "end_date": "2017-04-30",
      "description": null,
      "url": "https://www.usaspending.gov/award/CONT_AWD_DEAC0494AL85000_8900_-NONE-_-NONE-"
    },
    {
      "award_id": "N0001917C0001",
      "recipient": "LOCKHEED MARTIN CORPORATION",
      "amount": 35135514910.2,
      "awarding_agency": "Department of Defense",
      "awarding_sub_agency": "Department of the Navy",
      "start_date": "2017-11-17",
      "end_date": "2031-03-31",
      "description": "LRIP LOT 12 ADVANCE ACQUISITION CONTRACT",
      "url": "https://www.usaspending.gov/award/CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-"
    },
    {
      "award_id": "N0001902C3002",
      "recipient": "LOCKHEED MARTIN CORPORATION",
      "amount": 34173959111.96,
      "awarding_agency": "Department of Defense",
      "awarding_sub_agency": "Defense Contract Management Agency",
      "start_date": "2001-10-26",
      "end_date": "2022-12-16",
      "description": "200204!008532!1700!AF600 !NAVAL AIR SYSTEMS COMMAND       !N0001902C3002  !A!N! !N!                   !20011026!20120430!008016958!008016958!834951691!N!LOCKHEED MARTIN CORPORATION   !LOCKHEED BLVD             !FORT WORTH          !TX!76108!27000!439!48!FORT WORTH          !TARRANT               !TEXAS     !+000026000000!N!N!018981928201!AC15!RDTE/AIRCRAFT-ENG/MANUF DEVELOP                   !A1A!AIRFRAMES AND SPARES          !2AMA!JAST/JSF                      !336411!E! !3! ! ! ! ! !99990909!B! ! !A! !A!N!R!2!002!N!1A!A!N!Z!  !  !N!C!N! ! ! !A!A!A!A!000!A!C!N! ! ! !Y!    !N00019!0001!",
      "url": "https://www.usaspending.gov/award/CONT_AWD_N0001902C3002_9700_-NONE-_-NONE-"
    }
  ],
  "attribution": "Source: USAspending.gov (U.S. Department of the Treasury, Bureau of the Fiscal Service)"
}
GET/api/v1/gov-awards$0.02

Latest large new federal awards across all recipients

The latest large NEW federal awards across all recipients, from USAspending.gov — browse what the government is funding right now. Tune `?days=` lookback (max 365), `?award_type=contracts|grants|all`, `?min_amount=` floor, `?order=amount|date`, `?limit=` (max 50). Each award carries recipient, amount, awarding agency, dates, description, and a link. Uses new-award dating, not modifications.

Example request
GET /api/v1/gov-awards
Response type (TypeScript)
interface GovAwardsResponse {
  source: string;
  as_of: string;
  award_type: string;
  window_days: number;
  since: string;
  min_amount: null;
  count: number;
  awards: Array<{
    award_id: string;
    recipient: string;
    amount: number;
    awarding_agency: string;
    awarding_sub_agency: string;
    start_date: string;
    end_date: string;
    description: string;
    url: string;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "usaspending",
  "as_of": "2026-06-05T12:00:00.000Z",
  "award_type": "contracts",
  "window_days": 90,
  "since": "2026-03-07",
  "min_amount": null,
  "count": 3,
  "awards": [
    {
      "award_id": "70B01C26F00000405",
      "recipient": "FISHER SAND & GRAVEL CO",
      "amount": 2594040000,
      "awarding_agency": "Department of Homeland Security",
      "awarding_sub_agency": "U.S. Customs and Border Protection",
      "start_date": "2026-06-03",
      "end_date": "2027-07-27",
      "description": "BORDER BARRIER DESIGN BUILD FOR BBT-5",
      "url": "https://www.usaspending.gov/award/CONT_AWD_70B01C26F00000405_7014_70B01C26D00000012_7014"
    },
    {
      "award_id": "70B01C26F00000345",
      "recipient": "SOUTHWEST VALLEY CONSTRUCTORS CO",
      "amount": 1720040000,
      "awarding_agency": "Department of Homeland Security",
      "awarding_sub_agency": "U.S. Customs and Border Protection",
      "start_date": "2026-05-11",
      "end_date": "2027-05-11",
      "description": "AWARD OF CONSTRUCTION TASK ORDER FOR BORDER WALL IN BIG BEND TEXAS, SEGMENT IDENTIFIED AS BBT-4.",
      "url": "https://www.usaspending.gov/award/CONT_AWD_70B01C26F00000345_7014_70B01C26D00000007_7014"
    },
    {
      "award_id": "70B01C26F00000292",
      "recipient": "BARNARD CONSTRUCTION COMPANY, INCORPORATED",
      "amount": 1585324926,
      "awarding_agency": "Department of Homeland Security",
      "awarding_sub_agency": "U.S. Customs and Border Protection",
      "start_date": "2026-04-24",
      "end_date": "2028-08-31",
      "description": "BORDER WALL CONSTRUCTION FOR EL PASO SECTOR - EPT-5",
      "url": "https://www.usaspending.gov/award/CONT_AWD_70B01C26F00000292_7014_70B01C26D00000006_7014"
    }
  ],
  "attribution": "Source: USAspending.gov (U.S. Department of the Treasury, Bureau of the Fiscal Service)"
}
GET/api/v1/fund-nport/{fund}$0.03

What's inside an ETF or fund: full N-PORT portfolio holdings

What's inside an ETF or mutual fund, from its latest SEC N-PORT filing. Pass an ETF/fund ticker (SPY, ARKK) or CIK in the path. Returns the registrant, net/total assets, report date, and every portfolio holding by value — name, CUSIP, ISIN, shares, USD value, % of net assets, asset/issuer class, country. `?limit=` (max 500). Fund composition the 13F feed doesn't cover.

Example request
GET /api/v1/fund-nport/FUND
Response type (TypeScript)
interface FundNportResponse {
  cik: string;
  registrant: string;
  source: string;
  as_of: string;
  data: {
    series_name: null;
    series_id: null;
    form: string;
    accession: string;
    filing_date: string;
    report_date: string;
    report_period_end: string;
    total_assets: number;
    total_liabilities: number;
    net_assets: number;
    total_positions: number;
    count: number;
    holdings: Array<{
      name: string;
      title: string;
      cusip: string;
      isin: string;
      lei: string;
      balance: number;
      units: string;
      currency: string;
      value_usd: number;
      pct_value: number;
      payoff_profile: string;
      asset_category: string;
      issuer_category: string;
      country: string;
    }>;
  };
}
Example response (click to expand)
{
  "cik": "0000884394",
  "registrant": "State Street(R) SPDR(R) S&P 500(R) ETF Trust",
  "source": "sec_edgar",
  "as_of": "2026-03-31T00:00:00.000Z",
  "data": {
    "series_name": null,
    "series_id": null,
    "form": "NPORT-P",
    "accession": "0001410368-26-055357",
    "filing_date": "2026-05-28",
    "report_date": "2026-03-31",
    "report_period_end": "2026-09-30",
    "total_assets": 653587391058.59,
    "total_liabilities": 1999121111,
    "net_assets": 651588269947.59,
    "total_positions": 503,
    "count": 5,
    "holdings": [
      {
        "name": "NVIDIA Corp",
        "title": "NVIDIA Corp",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "lei": "549300S4KLFTLO7GSQ80",
        "balance": 283112619,
        "units": "NS",
        "currency": "USD",
        "value_usd": 49374840753.6,
        "pct_value": 7.577613507003,
        "payoff_profile": "Long",
        "asset_category": "EC",
        "issuer_category": "CORP",
        "country": "US"
      },
      {
        "name": "Apple Inc",
        "title": "Apple Inc",
        "cusip": "037833100",
        "isin": "US0378331005",
        "lei": "HWUPKR0MPOU8FGXBT394",
        "balance": 171045103,
        "units": "NS",
        "currency": "USD",
        "value_usd": 43409536690.37,
        "pct_value": 6.662111442531,
        "payoff_profile": "Long",
        "asset_category": "EC",
        "issuer_category": "CORP",
        "country": "US"
      },
      {
        "name": "Microsoft Corp",
        "title": "Microsoft Corp",
        "cusip": "594918104",
        "isin": "US5949181045",
        "lei": "INR2EJN1ERAN0W5ZP974",
        "balance": 86512867,
        "units": "NS",
        "currency": "USD",
        "value_usd": 32024467977.39,
        "pct_value": 4.914831873809,
        "payoff_profile": "Long",
        "asset_category": "EC",
        "issuer_category": "CORP",
        "country": "US"
      },
      {
        "name": "Amazon.com Inc",
        "title": "Amazon.com Inc",
        "cusip": "023135106",
        "isin": "US0231351067",
        "lei": "ZXTILKJKG63JELOEG630",
        "balance": 113816227,
        "units": "NS",
        "currency": "USD",
        "value_usd": 23704505597.29,
        "pct_value": 3.63795769362,
        "payoff_profile": "Long",
        "asset_category": "EC",
        "issuer_category": "CORP",
        "country": "US"
      },
      {
        "name": "Alphabet Inc",
        "title": "Alphabet Inc",
        "cusip": "02079K305",
        "isin": "US02079K3059",
        "lei": "5493006MHB84DD0ZWV18",
        "balance": 67828004,
        "units": "NS",
        "currency": "USD",
        "value_usd": 19504620830.24,
        "pct_value": 2.993396555743,
        "payoff_profile": "Long",
        "asset_category": "EC",
        "issuer_category": "CORP",
        "country": "US"
      }
    ]
  }
}
GET/api/v1/calendar$0.02

Upcoming US economic data releases + next FOMC meeting

Upcoming US economic data releases — WHEN the market-moving prints land, not just their latest values. Returns curated high-importance releases (CPI, PPI, PCE, jobs, JOLTS, GDP, retail sales, housing starts, industrial production) within `?days=` (default 30, max 90), each with date and category, plus the next FOMC meeting. `?past=true` includes the last week. Release dates from FRED.

Example request
GET /api/v1/calendar
Response type (TypeScript)
interface EconCalendarResponse {
  source: string;
  as_of: string;
  window_days: number;
  from: string;
  to: string;
  count: number;
  releases: Array<{
    release_id: number;
    name: string;
    category: string;
    date: string;
  }>;
  fomc: {
    next_meeting: string;
    days_until: number;
  };
  attribution: string;
}
Example response (click to expand)
{
  "source": "fred",
  "as_of": "2026-06-05T12:00:00.000Z",
  "window_days": 30,
  "from": "2026-06-05",
  "to": "2026-07-05",
  "count": 15,
  "releases": [
    {
      "release_id": 50,
      "name": "Employment Situation",
      "category": "employment",
      "date": "2026-06-05"
    },
    {
      "release_id": 10,
      "name": "Consumer Price Index (CPI)",
      "category": "inflation",
      "date": "2026-06-10"
    },
    {
      "release_id": 180,
      "name": "Initial Jobless Claims",
      "category": "employment",
      "date": "2026-06-11"
    },
    {
      "release_id": 46,
      "name": "Producer Price Index (PPI)",
      "category": "inflation",
      "date": "2026-06-11"
    },
    {
      "release_id": 13,
      "name": "Industrial Production",
      "category": "growth",
      "date": "2026-06-15"
    },
    {
      "release_id": 27,
      "name": "Housing Starts",
      "category": "housing",
      "date": "2026-06-16"
    },
    {
      "release_id": 9,
      "name": "Retail Sales",
      "category": "consumer",
      "date": "2026-06-17"
    },
    {
      "release_id": 180,
      "name": "Initial Jobless Claims",
      "category": "employment",
      "date": "2026-06-18"
    },
    {
      "release_id": 27,
      "name": "Housing Starts",
      "category": "housing",
      "date": "2026-06-24"
    },
    {
      "release_id": 53,
      "name": "Gross Domestic Product (GDP)",
      "category": "growth",
      "date": "2026-06-25"
    },
    {
      "release_id": 180,
      "name": "Initial Jobless Claims",
      "category": "employment",
      "date": "2026-06-25"
    },
    {
      "release_id": 54,
      "name": "Personal Income & Outlays (PCE)",
      "category": "inflation",
      "date": "2026-06-25"
    },
    {
      "release_id": 192,
      "name": "Job Openings & Labor Turnover (JOLTS)",
      "category": "employment",
      "date": "2026-06-30"
    },
    {
      "release_id": 50,
      "name": "Employment Situation",
      "category": "employment",
      "date": "2026-07-02"
    },
    {
      "release_id": 180,
      "name": "Initial Jobless Claims",
      "category": "employment",
      "date": "2026-07-02"
    }
  ],
  "fomc": {
    "next_meeting": "2026-06-17",
    "days_until": 12
  },
  "attribution": "Economic release dates: Federal Reserve Bank of St. Louis (FRED). FOMC meeting dates: U.S. Federal Reserve."
}
GET/api/v1/calendar/fomc$0.01

FOMC meeting schedule with last & next meeting and days-until

The full FOMC meeting schedule (2025–2027) with the last and next meeting and days-until. Each entry carries the two-day meeting's start and decision date, year, and past/upcoming status. No ticker needed — the rate-decision calendar every macro-aware agent plans around. Source: U.S. Federal Reserve.

Example request
GET /api/v1/calendar/fomc
Response type (TypeScript)
interface FomcCalendarResponse {
  source: string;
  as_of: string;
  last_meeting: {
    date: string;
    days_ago: number;
  };
  next_meeting: {
    date: string;
    days_until: number;
  };
  count: number;
  meetings: Array<{
    start_date: string;
    date: string;
    year: number;
    status: string;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "federal_reserve",
  "as_of": "2026-06-05T12:00:00.000Z",
  "last_meeting": {
    "date": "2026-04-29",
    "days_ago": 37
  },
  "next_meeting": {
    "date": "2026-06-17",
    "days_until": 12
  },
  "count": 24,
  "meetings": [
    {
      "start_date": "2025-01-28",
      "date": "2025-01-29",
      "year": 2025,
      "status": "past"
    },
    {
      "start_date": "2025-03-18",
      "date": "2025-03-19",
      "year": 2025,
      "status": "past"
    },
    {
      "start_date": "2025-05-06",
      "date": "2025-05-07",
      "year": 2025,
      "status": "past"
    },
    {
      "start_date": "2025-06-17",
      "date": "2025-06-18",
      "year": 2025,
      "status": "past"
    },
    {
      "start_date": "2025-07-29",
      "date": "2025-07-30",
      "year": 2025,
      "status": "past"
    },
    {
      "start_date": "2025-09-16",
      "date": "2025-09-17",
      "year": 2025,
      "status": "past"
    }
  ],
  "attribution": "Source: U.S. Federal Reserve, FOMC meeting calendar"
}
GET/api/v1/news-sentiment$0.02

Global news attention & tone for a company or topic (GDELT)

Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds.

Example request
GET /api/v1/news-sentiment
Response type (TypeScript)
interface NewsSentimentResponse {
  source: string;
  venue: string;
  as_of: string;
  query: string;
  timespan: string;
  sentiment: {
    latest_tone: number;
    average_tone: number;
    label: string;
    trend: string;
    scale: string;
  };
  volume: {
    total_articles: number;
    points: number;
  };
  tone_timeline: Array<{
    date: string;
    tone: number;
  }>;
  volume_timeline: Array<{
    date: string;
    articles: number;
    total_monitored: number;
  }>;
  recent_articles: Array<{
    title: string;
    url: string;
    domain: string;
    source_country: string;
    language: string;
    seen: string;
  }>;
  attribution: string;
}
Example response (click to expand)
{
  "source": "x402stock",
  "venue": "gdelt",
  "as_of": "2026-06-06T02:48:00.000Z",
  "query": "Nvidia",
  "timespan": "1w",
  "sentiment": {
    "latest_tone": 1.221,
    "average_tone": 0.001,
    "label": "neutral",
    "trend": "improving",
    "scale": "GDELT average tone, roughly -10 (very negative) to +10 (very positive); 0 is neutral."
  },
  "volume": {
    "total_articles": 4271,
    "points": 167
  },
  "tone_timeline": [
    {
      "date": "2026-05-30T09:00:00Z",
      "tone": -0.249
    },
    {
      "date": "2026-05-30T10:00:00Z",
      "tone": -0.804
    },
    {
      "date": "2026-05-30T11:00:00Z",
      "tone": -1.217
    },
    {
      "date": "2026-05-30T12:00:00Z",
      "tone": 0.755
    },
    {
      "date": "2026-05-30T13:00:00Z",
      "tone": 0.301
    },
    {
      "date": "2026-05-30T14:00:00Z",
      "tone": 1.221
    }
  ],
  "volume_timeline": [
    {
      "date": "2026-06-06T01:00:00Z",
      "articles": 21,
      "total_monitored": 3104
    },
    {
      "date": "2026-06-06T02:00:00Z",
      "articles": 17,
      "total_monitored": 3179
    }
  ],
  "recent_articles": [
    {
      "title": "NVIDIA Is Not the Only AI Chip Winner : Broadcom Forecasts $56 Billion as Custom Silicon Demand Surges",
      "url": "https://www.techtimes.com/articles/317846/20260605/nvidia-not-only-ai-chip-winner-broadcom-forecasts-56-billion-custom-silicon-demand-surges.htm",
      "domain": "techtimes.com",
      "source_country": "United States",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "Broadcom Pivots to Chips Only as AI Guidance Miss Drags Down the Semiconductor Sector",
      "url": "https://www.techtimes.com/articles/317865/20260605/broadcom-pivots-chips-only-ai-guidance-miss-drags-down-semiconductor-sector.htm",
      "domain": "techtimes.com",
      "source_country": "United States",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "Anthropic ( Claude ) May Be the Only $1 Trillion IPO Worth Buying",
      "url": "https://finance.yahoo.com/markets/stocks/articles/anthropic-claude-may-only-1-013100903.html",
      "domain": "finance.yahoo.com",
      "source_country": "United States",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "Stocks slump as Big Tech sinks and a strong May jobs report boosts odds for higher interest rates",
      "url": "https://www.thesunchronicle.com/zz/1/stocks-slump-as-big-tech-sinks-and-a-strong-may-jobs-report-boosts-odds-for/article_19657e96-8b25-597b-a96c-50b417123cfd.html",
      "domain": "thesunchronicle.com",
      "source_country": "United States",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "젠슨 황의  K불금 … 총수들과 삼겹살에 깻잎쌈 , 2차는 치킨 - 국민일보",
      "url": "https://www.kmib.co.kr/article/view.asp?arcid=1780649670&code=11151400&sid1=eco",
      "domain": "kmib.co.kr",
      "source_country": "South Korea",
      "language": "Korean",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "WATCH : Computex 2026 was AI agents , hybrid systems , gaming",
      "url": "https://technology.inquirer.net/147183/watch-computex-2026-was-ai-agents-hybrid-systems-gaming",
      "domain": "technology.inquirer.net",
      "source_country": "Philippines",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "Anthropic Embeds Engineers Inside NSA for Offensive Cyber Ops , Sues Pentagon for Barring Claude",
      "url": "https://www.techtimes.com/articles/317873/20260605/anthropic-embeds-engineers-inside-nsa-offensive-cyber-ops-sues-pentagon-barring-claude.htm",
      "domain": "techtimes.com",
      "source_country": "United States",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z"
    },
    {
      "title": "Yeni Zombi Hayatta Kalma Oyunu Duyuruldu ! Şimdiden Büyük İlgi Görüyor",
      "url": "https://www.tamindir.com/haber/last-harbor-duyuruldu_109572/",
      "domain": "tamindir.com",
      "source_country": "Turkey",
      "language": "Turkish",
      "seen": "2026-06-06T02:15:00Z"
    }
  ],
  "attribution": "Source: The GDELT Project (https://www.gdeltproject.org/)"
}