{"openapi":"3.1.0","info":{"title":"TKX Public Data API","version":"1.4.0","description":"The data authority for the AI token & compute market. Free with attribution to tkx.org. All endpoints are static JSON refreshed hourly by the TKX collector. v1.4: spot/{market,models}.json expose the DC-GPU hardware spot board (catalog + export-control class + fee tiers + listings/RFQs + TKX-SPI). v1.3: constituents/{ttpi,ttv-or}.json expose full index constituents + sha256 (third-party recompute without DB access); price-ohlc.json adds per-model daily price OHLC (real cheapest-blended prices); meta.json adds board.sortBasis (+usageStale when the usage source is carried forward); aggregators rows may carry priceCheck and volume24h.stale. v1.2: rankings rows carry usage {tokens, tokensPaid, tokensFree, share, rank, usd(est.), volChgPct, spendChgPct(day-over-day %)}; indices add TTV-OR (est. daily token traded value); usage.json adds estSpendUsd. Additive only — no fields removed.","contact":{"email":"echo@minax.io","url":"https://tkx.org/standard/"}},"servers":[{"url":"https://tkx.org"}],"paths":{"/api/v1/rankings.json":{"get":{"summary":"Model rankings: sorted by est. 24h traded value first (usage.usd = paid tokens × list rate; free traffic never priced), then measured routed volume, then provider spread; cheapest offer, 30d price spark","responses":{"200":{"description":"OK"}}}},"/api/v1/models/{id}.json":{"get":{"summary":"Per-model detail: all provider offers, prices, evidence","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Unknown model"}}}},"/api/v1/providers.json":{"get":{"summary":"Provider trust board: coverage, cheapest-wins, uptime/latency medians, precision floor","responses":{"200":{"description":"OK"}}}},"/api/v1/providers/{key}.json":{"get":{"summary":"Per-provider detail","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/aggregators.json":{"get":{"summary":"Router board (45 tracked), sorted by 24h token volume first (Deng 2026-07-21: volume is the primary ranking; coverage/wins as tiebreak): tier live|listed, measured coverage (+modelsChg d/d), markup vs list (+markupChgPp d/d), uptime, evidence; volume24h {tokens, usd est., volChgPct, spendChgPct} where publicly measured (OpenRouter) or {tokens, date, selfReported:true} where self-reported via the TKX Standard usage endpoint (validated, labeled, never mixed into indices)","responses":{"200":{"description":"OK"}}}},"/api/v1/indices.json":{"get":{"summary":"TTPI token price index, TTV-OR est. daily token traded value (paid traffic at list rates), GPU spot indices (intl live / cn curated) — all with daily history","responses":{"200":{"description":"OK"}}}},"/api/v1/changes.json":{"get":{"summary":"24h price-change events (>2% day-over-day per-model cheapest blended)","responses":{"200":{"description":"OK"}}}},"/api/v1/trending.json":{"get":{"summary":"Top movers (30d) and trending apps","responses":{"200":{"description":"OK"}}}},"/api/v1/usage.json":{"get":{"summary":"Real per-model token usage/share + est. spend (OpenRouter rankings-daily; paid/free split; est. at list rates; OpenRouter slice, not global)","responses":{"200":{"description":"OK"}}}},"/api/v1/apps.json":{"get":{"summary":"Apps & agents token-usage board (attributed to OpenRouter)","responses":{"200":{"description":"OK"}}}},"/api/v1/gpu-clouds.json":{"get":{"summary":"GPU cloud supplier price table (curated + Vast live)","responses":{"200":{"description":"OK"}}}},"/api/v1/history/ttpi.json":{"get":{"summary":"TTPI daily history (30d window)","responses":{"200":{"description":"OK"}}}},"/api/v1/history/gpu.json":{"get":{"summary":"GPU price daily history by source|card (30d window)","responses":{"200":{"description":"OK"}}}},"/api/v1/constituents/ttpi.json":{"get":{"summary":"TTPI full constituents for today's point + sha256 — recompute/audit the index without database access","responses":{"200":{"description":"OK"}}}},"/api/v1/constituents/ttv-or.json":{"get":{"summary":"TTV-OR full constituents (per-model est. spend) + sha256 for today's point","responses":{"200":{"description":"OK"}}}},"/api/v1/price-ohlc.json":{"get":{"summary":"Per-model daily price OHLC (cheapest blended, 90d) — real prices, candles gain intraday range as hourly buckets accumulate","responses":{"200":{"description":"OK"}}}},"/api/v1/meta.json":{"get":{"summary":"Collection metadata: counts, source status incl. aux (dev/apps/gpu)","responses":{"200":{"description":"OK"}}}},"/api/v1/spot/market.json":{"get":{"summary":"DC-GPU hardware spot board: model catalog with export-control class, brokerage fee tiers, active listings and RFQs, TKX-SPI settled-price index (collecting until real settled deals exist). Prototype flag is true while listings are demo-only; demo rows never carry prices.","responses":{"200":{"description":"OK"}}}},"/api/v1/spot/models.json":{"get":{"summary":"DC-GPU model catalog only: id, forms, export-control class (open|controlled), basis. TKX's reading of public BIS rules — verified=false on every row, not legal advice.","responses":{"200":{"description":"OK"}}}}}}