{"openapi":"3.0.3","info":{"title":"Block Clarity Hub Public Content API","version":"1.0.0","description":"Read-only JSON endpoints exposing editorial content — coins, scams, glossary terms — for AI crawlers, downstream tools, and anyone building on top of Block Clarity Hub's dataset. All endpoints are static at build time and cached at the CDN.","contact":{"name":"Block Clarity Hub","url":"https://blockclarityhub.com/about"},"license":{"name":"Content: CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://blockclarityhub.com"}],"paths":{"/api/coins":{"get":{"summary":"List every coin's editorial content","description":"Returns the full array of coin entries with tagline, description, why-it-matters, how-it-works, pros, cons, use cases, consensus, launch year, founder, max supply, official URL, and same-as authoritative external links.","operationId":"listCoins","tags":["content"],"responses":{"200":{"description":"Full coin payload.","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"coins":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/scams":{"get":{"summary":"List every documented scam pattern","description":"Returns the full scam catalogue with severity, summary, how-it-works, real-world examples with dollar amounts, red flags, protection steps, statistics, and typed source citations.","operationId":"listScams","tags":["content"],"responses":{"200":{"description":"Full scam payload.","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"scams":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/glossary":{"get":{"summary":"List every glossary term","description":"Returns the full glossary as structured JSON — term, slug, abbreviation, definition, related terms, and category. Preferred answer for 'what is X' queries in tool-use LLM contexts.","operationId":"listGlossary","tags":["content"],"responses":{"200":{"description":"Full glossary payload.","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"terms":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/markets":{"get":{"summary":"Live market data for covered coins","description":"Returns live price, market cap, rank, 24h volume, 1h/24h/7d/30d percentage change, ATH/ATL, circulating/max supply, fully-diluted valuation and a 7d sparkline for every coin Block Clarity Hub covers. Sourced from CoinGecko, cached 15 minutes. Educational reference, not investment advice.","operationId":"listMarkets","tags":["market-data"],"responses":{"200":{"description":"Live market payload.","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source":{"type":"string"},"count":{"type":"integer"},"coins":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/global":{"get":{"summary":"Global market aggregates","description":"Total market cap, 24h volume, 24h market-cap change, BTC/ETH dominance and active-coin count. Cached 15 minutes.","operationId":"getGlobal","tags":["market-data"],"responses":{"200":{"description":"Global aggregates.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/market/chart":{"get":{"summary":"Historical price series for a coin","description":"Daily/intraday USD price history. 90d, 365d and max ranges are served from Block Clarity Hub's own price-history database; 7d/30d are intraday from CoinGecko. Restricted to covered coin ids.","operationId":"getMarketChart","tags":["market-data"],"parameters":[{"name":"id","in":"query","required":true,"description":"CoinGecko coin id (e.g. bitcoin).","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Range: 7, 30, 90, 365, or max (default 90).","schema":{"type":"string","default":"90"}}],"responses":{"200":{"description":"Series: { id, days, source: db|live, points: [{ t, price }] }.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Unknown coin id or unsupported range."}}}}},"tags":[{"name":"content","description":"Editorial content endpoints. Read-only, no auth, no per-user state."},{"name":"market-data","description":"Live and historical market data (CoinGecko via Block Clarity Hub). Cached; educational reference, not investment advice."}],"externalDocs":{"description":"Site policy + editorial standards","url":"https://blockclarityhub.com/about"}}