{"openapi":"3.1.0","info":{"title":"Blockchain IQ x402 API","version":"1.0.0","description":"Pay-per-call crypto market data for AI agents and software: coin prices, price history, global market, US macro indicators, tokenized real-world assets, sector indices and analytics dashboards. Paid per request in USDC on Base over the x402 protocol (HTTP 402). No account, no API key.","x-guidance":"Start with the free catalog at /api/x402/v1 (every resource, price and response example) and the free sample at /api/x402/v1/sample. Every other operation is a paid GET: an unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header (x402 protocol version 2); pay the stated amount in USDC on Base with any x402 client and repeat the request. No account and no API key. MCP clients can use the same catalog as tools through the MCP server: npx -y blockchainiq-x402-mcp. Coin ids are CoinGecko ids, for example bitcoin, ethereum, ripple. History takes ?days=1..730 (default 365) and its price scales with the range. Index slugs come from the indices list (/api/x402/v1/indices); dashboard slugs are listed in the dashboard operation's description. A 404 or an error is never charged. Responses are market data and analysis, not investment advice. Terms: https://www.blockchainiq.co/terms","contact":{"name":"Blockchain IQ","email":"team@blockchainiq.co","url":"https://www.blockchainiq.co/agents"},"termsOfService":"https://www.blockchainiq.co/terms"},"servers":[{"url":"https://www.blockchainiq.co"}],"externalDocs":{"description":"Guide for agents and developers","url":"https://www.blockchainiq.co/agents"},"paths":{"/api/x402/v1":{"get":{"operationId":"getCatalog","summary":"Catalog","description":"This resource list, prices, and price classes.","tags":["free"],"security":[],"responses":{"200":{"description":"Catalog — JSON envelope with source, disclaimer, terms and data (A list of resources, each with id, method, path, price class, price, title, description, what it returns, parameters and an example response).","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/x402/v1/sample":{"get":{"operationId":"getSample","summary":"Free sample","description":"Bitcoin's current market data, unpaid — to test the integration before paying.","tags":["free"],"security":[],"responses":{"200":{"description":"Free sample — JSON envelope with source, disclaimer, terms and data (One coin's market fields, the same as the price resource (plus a top-level note)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","note":"Free sample. Paid resources require x402 payment — see /api/x402/v1.","data":{"coinId":"bitcoin","symbol":"BTC","name":"Bitcoin","price":86414,"marketCap":1736261722111,"marketCapRank":1,"totalVolume":39214680897,"change24h":3.06608,"change7d":2.037,"change30d":12.4963,"ath":126080,"refreshedAt":"2026-10-02T11:31:18.324+00:00"}}}}}}}},"/api/x402/v1/price/{coinId}":{"get":{"operationId":"getPrice","summary":"Crypto Coin Price & Market Data","description":"Crypto price lookup: live USD price for one coin by CoinGecko id (bitcoin, ethereum, solana, ripple for XRP and 280+ others), with 24h, 7d and 30d change, market cap, market-cap rank, 24h volume and all-time high. Use when you need to answer what a coin is worth right now or how it has moved. Refreshed every minute. JSON, no API key, no account. $0.002 per call. Blockchain IQ.","tags":["crypto","price","bitcoin","ethereum","market-cap"],"parameters":[{"name":"coinId","in":"path","required":true,"description":"CoinGecko coin id, e.g. 'bitcoin'","schema":{"type":"string"},"example":"bitcoin"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Coin price — JSON envelope with source, disclaimer, terms and data (One coin's market fields: coinId, symbol, name, price, marketCap, marketCapRank, totalVolume, change24h, change7d, change30d, ath, refreshedAt).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","data":{"coinId":"bitcoin","symbol":"BTC","name":"Bitcoin","price":86414,"marketCap":1736261722111,"marketCapRank":1,"totalVolume":39214680897,"change24h":3.06608,"change7d":2.037,"change30d":12.4963,"ath":126080,"refreshedAt":"2026-10-02T11:31:18.324+00:00"}}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/prices":{"get":{"operationId":"getPrices","summary":"Crypto Market Snapshot - Top 250","description":"Bulk crypto prices in one call: live USD price, market cap, rank, 24h volume, 24h/7d/30d change and all-time high for the top 250 coins by market cap plus the smaller names we track (280+ coins). Use for screening, ranking, top gainers and losers, portfolio valuation or building a market table without hundreds of single lookups. Refreshed every minute. JSON, no API key. $0.02 per call. Blockchain IQ.","tags":["crypto","prices","market-cap","top-coins","ranking"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Market snapshot — JSON envelope with source, disclaimer, terms and data (A list of coins, each with the same market fields as the price resource (plus a top-level count)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","count":283,"data":[{"coinId":"bitcoin","symbol":"BTC","name":"Bitcoin","price":86414,"marketCap":1736261722111,"marketCapRank":1,"totalVolume":39214680897,"change24h":3.06608,"change7d":2.037,"change30d":12.4963,"ath":126080,"refreshedAt":"2026-10-02T11:31:18.324+00:00"}]}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/history/{coinId}":{"get":{"operationId":"getHistory","summary":"Crypto Price History - Daily","description":"Historical crypto prices: daily USD price series for one coin by CoinGecko id (bitcoin, ethereum, solana, ripple for XRP and more), from 1 to 730 days back via ?days=. Use for charts, returns, volatility, drawdown, moving averages and backtests. Returns date and price per day as JSON. No API key. From $0.01 per call, scaling with the range requested and capped at $0.05. Blockchain IQ.","tags":["crypto","price-history","historical-data","bitcoin","ethereum"],"parameters":[{"name":"coinId","in":"path","required":true,"description":"CoinGecko coin id","schema":{"type":"string"},"example":"ethereum"},{"name":"days","in":"query","required":false,"description":"Days of daily history to return, 1 to 730 (default 365). The price scales with the range.","schema":{"type":"integer","minimum":1,"maximum":730,"default":365},"example":30}],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"0.05"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Price history — JSON envelope with source, disclaimer, terms and data (A list of { date, price } points, one per day, oldest first (plus top-level coinId, days, count)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","coinId":"ethereum","days":2,"count":2,"data":[{"date":"2026-10-01","price":2684.708553282074},{"date":"2026-10-02","price":2709.044298151576}]}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/global":{"get":{"operationId":"getGlobal","summary":"Global Crypto Market Overview","description":"Global crypto market snapshot in one call: total crypto market cap, 24h trading volume, 24h market-cap change, Bitcoin dominance, Ethereum dominance and the number of active cryptocurrencies. Use for whole-market context behind any single coin move, risk-on/risk-off checks and market summaries. Not ticker-specific. JSON, no API key. $0.02 per call. Blockchain IQ.","tags":["crypto","market-cap","dominance","bitcoin","market-overview"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Global market — JSON envelope with source, disclaimer, terms and data (Whole-market fields: totalMarketCap, totalVolume, btcDominance, ethDominance, activeCryptocurrencies, marketCapChange24h, refreshedAt).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","data":{"totalMarketCap":2949237366520.713,"totalVolume":108385729409.95929,"btcDominance":58.748313520632344,"ethDominance":11.40752735037174,"activeCryptocurrencies":21777,"marketCapChange24h":-0.07435654143781016,"refreshedAt":"2026-10-02T08:34:15.154+00:00"}}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/macro":{"get":{"operationId":"getMacro","summary":"US Macro Indicators for Crypto","description":"US macroeconomic indicators in one call: real GDP growth, CPI inflation, core PCE, unemployment rate, nonfarm payrolls, Fed funds rate, 2-year and 10-year Treasury yields, Japan 10-year yield, WTI crude oil, gold and silver. Each with latest value, prior value and as-of date. Use for the macro backdrop to crypto and risk assets. Sourced from FRED and futures data. JSON, no API key. $0.02 per call. Blockchain IQ.","tags":["macro","economy","inflation","interest-rates","commodities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"US macro indicators — JSON envelope with source, disclaimer, terms and data (A list of indicators, each with seriesId, label, category, value, unit, asOf, priorValue, priorAsOf, position, refreshedAt (plus a top-level count)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","count":12,"data":[{"seriesId":"CPIAUCSL","label":"CPI inflation (y/y)","category":"Inflation","value":3.4,"unit":"%","asOf":"2026-08-01","priorValue":3.3,"priorAsOf":"2026-07-01","position":2,"refreshedAt":"2026-10-02T02:34:12.663+00:00"}]}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/rwa":{"get":{"operationId":"getRwa","summary":"Tokenized Real-World Assets Data","description":"Tokenized real-world assets (RWA) market data: total tokenized market cap, breakdown by asset type and the largest tokenized assets with their market caps. Use to size the RWA and tokenization market or compare tokenized products. JSON, no API key. $0.02 per call. Blockchain IQ.","tags":["rwa","tokenization","tokenized-treasuries","stablecoins","crypto"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Tokenized RWAs — JSON envelope with source, disclaimer, terms and data ({ summary, assets } (plus a top-level count): summary has totalMarketCap, assetCount, a categories breakdown by asset type and refreshedAt; assets is a list of tokenized assets with rwaId, symbol, name, assetType, marketCapRank, price, marketCap, totalVolume, change24h, refreshedAt).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","count":250,"data":{"summary":{"totalMarketCap":9398636392,"assetCount":250,"categories":[{"type":"commodity","label":"Commodities","count":2,"marketCap":6256651229,"share":0.6656977638081182}],"refreshedAt":"2026-10-02T02:34:12.664+00:00"},"assets":[{"rwaId":"gold","symbol":"XAU","name":"Gold","assetType":"commodity","marketCapRank":1,"price":4164.45,"marketCap":6029540014,"totalVolume":334215065,"change24h":0.17999,"refreshedAt":"2026-10-02T02:34:12.664+00:00"}]}}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/indices":{"get":{"operationId":"getIndices","summary":"Crypto Sector Indices - List","description":"List of analyst-curated crypto sector indices and thematic baskets, each with slug, name, description and number of member coins. Use to find which coins belong to a crypto sector or narrative, then fetch one index for its members and prices. JSON, no API key. $0.02 per call. Blockchain IQ.","tags":["crypto","index","sectors","narratives","baskets"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Indices list — JSON envelope with source, disclaimer, terms and data ({ id, slug, name, description, coinCount }[] (plus a top-level count)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","count":24,"data":[{"id":"21d4e2c1-b314-4eb6-99a2-99605a6b912c","slug":"ai-agents","name":"AI Agents","description":"AI Agents","coinCount":5}]}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/indices/{slug}":{"get":{"operationId":"getIndex","summary":"Crypto Sector Index - Members","description":"One analyst-curated crypto sector index by slug: its full list of member coins with live USD price, market cap, rank, 24h volume and 24h/7d/30d change for every constituent. Use to analyse a crypto sector or narrative as a basket, compare its members or track sector performance. JSON, no API key. $0.25 per call. Blockchain IQ.","tags":["crypto","index","sector","constituents","market-data"],"parameters":[{"name":"slug","in":"path","required":true,"description":"index slug, e.g. 'ai-agents'","schema":{"type":"string"},"example":"ai-agents"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Index analytics — JSON envelope with source, disclaimer, terms and data ({ index, members } (plus a top-level coinCount): index has id, slug, name, description, createdAt; members are coins with the same market fields as the price resource, and a member with no market data comes back as { coinId, market: null }).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","coinCount":2,"data":{"index":{"id":"21d4e2c1-b314-4eb6-99a2-99605a6b912c","slug":"ai-agents","name":"AI Agents","description":"AI Agents","createdAt":"2026-09-20T20:38:03.359863+00:00"},"members":[{"coinId":"fetch-ai","symbol":"FET","name":"Artificial Superintelligence Alliance","price":0.231509,"marketCap":535134666,"marketCapRank":113,"totalVolume":154761387,"change24h":-0.91613,"change7d":-1.3295,"change30d":52.8926,"ath":3.45,"refreshedAt":"2026-10-02T11:31:18.324+00:00"},{"coinId":"example-unpriced-coin","market":null}]}}}}},"402":{"description":"Payment Required"}}}},"/api/x402/v1/dashboards/{slug}":{"get":{"operationId":"getDashboard","summary":"Crypto Analytics Dashboards","description":"Crypto analytics dashboard data with an analyst read on each chart. Pick one by slug: market-overview, on-chain-metrics, defi-tvl-and-yields, stablecoin-story, tokenized-rwas, leverage-and-derivatives, liquidity-and-venues, volatility-and-execution, corporate-treasuries, crypto-fundraising, exploit-losses, xrp-ledger, bitcoin-network, ethereum-network, base-network, arbitrum-network, aptos-network, provenance-network. Every panel as JSON. $0.25 per call. Blockchain IQ.","tags":["crypto","analytics","on-chain","defi","stablecoins"],"parameters":[{"name":"slug","in":"path","required":true,"description":"dashboard slug, e.g. 'market-overview'","schema":{"type":"string"},"example":"market-overview"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Analytics dashboard — JSON envelope with source, disclaimer, terms and data ({ dashboard, panels } (plus a top-level panelCount): dashboard has slug, title, blurb, tier, live; each panel has panelSlug, title, subtitle, kind, data (series or bars, with a unit), sourceView, refreshedAt and analyst_read (text, or null)).","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"Blockchain IQ","disclaimer":"Market data and analysis, not investment advice.","terms":"https://www.blockchainiq.co/terms","panelCount":1,"data":{"dashboard":{"slug":"market-overview","title":"Market Overview","blurb":"Total market capitalization, BTC and ETH dominance, DeFi's share of the market, the sectors holding the most capital, and which coins keep appearing in the trending list.","tier":"analyst","live":true},"panels":[{"panelSlug":"total-market-cap","title":"Total crypto market cap","subtitle":"Whole-market capitalisation trend","kind":"time_series","data":{"unit":"usd","series":[{"name":"Total market cap","points":[{"t":"2026-09-27T00:00:00.000Z","v":3900000000000}]}]},"sourceView":"cg_global_market","refreshedAt":"2026-09-27T13:00:00.000Z","analyst_read":"The market's overall size over time — the backdrop every other chart sits against. Sustained expansion signals broad risk appetite; a rolling top often leads the rest of the market lower."}]}}}}},"402":{"description":"Payment Required"}}}}}}