{"openapi":"3.1.0","info":{"title":"Chaconne data API (alpha)","version":"alpha","description":"Tokenized US stock data from Chaconne: premiums vs the real stock, liquidity grades, market totals and history. Endpoints marked with the apiKey requirement need a free key (apply at /developers); the others are public. Default rate limit 60 requests per minute; data is cached about 30 seconds. Attribution required: \"Chaconne — chaconne.xyz\". Methodology: https://chaconne.xyz/methodology"},"servers":[{"url":"https://chaconne.xyz"}],"externalDocs":{"description":"Human-readable documentation","url":"https://chaconne.xyz/developers"},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/assets":{"get":{"summary":"All tokenized stocks (issuer / chain / contract address / liquidity grade)","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"All tokenized stocks (issuer / chain / contract address / liquidity grade)\n\n- `attribution` (string): Attribution string (constant)\n- `count` (number): Number of assets\n- `assets[].symbol` (string): Token symbol, e.g. TSLAx\n- `assets[].underlying` (string): Underlying ticker, e.g. TSLA\n- `assets[].name_en / name_cn` (string): English / Chinese names\n- `assets[].issuer` (string): Issuer: xstocks / ondo / bstocks\n- `assets[].chain` (string): Chain: solana / bnb\n- `assets[].address` (string): Token contract (mint) address\n- `assets[].tags` (string[]): Tags (sector etc.)\n- `assets[].grade` ('A'|'B'|'C'|'D'|null): Liquidity grade (null if unrated)","content":{"application/json":{"example":{"attribution":"Chaconne — chaconne.xyz","count":243,"assets":[{"symbol":"TSLAx","underlying":"TSLA","name_en":"Tesla xStock","name_cn":"特斯拉","issuer":"xstocks","chain":"solana","address":"XsDoVfqeBukxuZHWZ…","tags":["auto"],"grade":"A"}]}}}},"401":{"description":"missing_api_key — x-api-key header missing"},"403":{"description":"invalid_api_key / revoked_api_key / key_pending_approval — Key invalid / revoked / pending approval"},"429":{"description":"rate_limited — Over the per-minute limit (default 60)"},"503":{"description":"unavailable — Database unavailable"}}}},"/api/v1/liquidity-scores":{"get":{"summary":"Liquidity grades A/B/C/D with $1k / $10k price impact (7-day rolling median)","security":[{"apiKey":[]}],"parameters":[],"responses":{"200":{"description":"Liquidity grades A/B/C/D with $1k / $10k price impact (7-day rolling median)\n\n- `methodology` (string): Grading methodology (constant text)\n- `scores[].symbol` (string): Token symbol\n- `scores[].grade` ('A'|'B'|'C'|'D'): A≤50 / B≤150 / C≤500 bps @ $10k; D >500 or no route\n- `scores[].impact_1k_bps / impact_10k_bps` (number|null): Adverse impact buying $1k / $10k (bps); null when no route\n- `scores[].sample_n` (number): Samples in the 7-day window (treat <3 as insufficient)\n- `scores[].updated_at` (ISO datetime): Last update (UTC)","content":{"application/json":{"example":{"attribution":"Chaconne — chaconne.xyz","methodology":"7-day rolling median price impact at $1k/$10k; A<=50/B<=150/C<=500 bps@10k, D>500 or no route","scores":[{"symbol":"NVDAx","grade":"A","impact_1k_bps":6,"impact_10k_bps":21,"sample_n":168,"updated_at":"2026-09-21T08:00:00.000Z"}]}}}},"401":{"description":"/ 403 / 429 / 503 — As above"}}}},"/api/v1/premium-history":{"get":{"summary":"Hourly premium history for one asset (bps, up to 90 days)","security":[{"apiKey":[]}],"parameters":[{"name":"symbol","in":"query","description":"Token symbol (string（必填，1–12 位字母数字）)","schema":{"type":"string"},"example":"NVDAx"},{"name":"days","in":"query","description":"Look-back days (number（1–90，默认 30）)","schema":{"type":"number"},"example":"30"}],"responses":{"200":{"description":"Hourly premium history for one asset (bps, up to 90 days)\n\n- `symbol / days` (string / number): Echoed parameters\n- `points[].ts` (ISO datetime): Hour bucket start (UTC)\n- `points[].premium_bps` (number|null): Hour-close premium (positive = on-chain above stock); null when no reference","content":{"application/json":{"example":{"attribution":"Chaconne — chaconne.xyz","symbol":"NVDAx","days":30,"points":[{"ts":"2026-09-19T14:00:00.000Z","premium_bps":-42}]}}}},"400":{"description":"bad_symbol — Invalid symbol"},"401":{"description":"/ 403 / 429 / 503 — As above"}}}},"/api/market-overview":{"get":{"summary":"Market totals: live 24h volume / liquidity / asset count plus self-collected daily snapshots (market / issuer / chain)","security":[],"parameters":[{"name":"days","in":"query","description":"History window (number（1–365，默认 90）)","schema":{"type":"number"},"example":"90"}],"responses":{"200":{"description":"Market totals: live 24h volume / liquidity / asset count plus self-collected daily snapshots (market / issuer / chain)\n\n- `live.vol24Usd / liquidityUsd` (number|null): Live 24h DEX volume / liquidity (USD)\n- `live.assetCount` (number): Tokens listed (same definition as the statistics page and /api/v1/assets count)\n- `live.tokensWithDexData` (number): Of those, tokens with DEX volume / liquidity data (none on X Layer yet)\n- `series[].day` (YYYY-MM-DD): Snapshot day (UTC)\n- `series[].scope` (string): all / issuer:xstocks / chain:solana …\n- `series[].vol / liq / cnt` (number): Day's 24h volume / liquidity (USD) / tokens with DEX data","content":{"application/json":{"example":{"days":90,"series":[{"day":"2026-09-20","scope":"all","vol":"71234567.12","liq":"43876543.10","cnt":243}],"live":{"vol24Usd":77489938.29,"liquidityUsd":44184814.89,"assetCount":284,"tokensWithDexData":243}}}}}}}},"/api/premium/history":{"get":{"summary":"Hourly premium + net-edge history for one asset (with hourly min / max)","security":[],"parameters":[{"name":"symbol","in":"query","description":"Token symbol (string（必填）)","schema":{"type":"string"},"example":"GLDx"},{"name":"days","in":"query","description":"Look-back days (number（1–30，默认 7）)","schema":{"type":"number"},"example":"7"}],"responses":{"200":{"description":"Hourly premium + net-edge history for one asset (with hourly min / max)\n\n- `points[].t` (number（Unix 秒）): Hour bucket start\n- `points[].premium / lo / hi` (number|null（bps）): Hour close / min / max premium\n- `points[].net_edge` (number|null（bps）): Net edge after platform fee and $1k impact (negative = pricier than the stock)","content":{"application/json":{"example":{"symbol":"GLDx","days":7,"points":[{"t":1789992000,"premium":-38,"lo":-55,"hi":-12,"net_edge":-102}]}}}}}}},"/api/basis/history":{"get":{"summary":"Hourly spot–perp basis history (as on /basis), with annualized funding","security":[],"parameters":[{"name":"underlying","in":"query","description":"Underlying, e.g. TSLA (string（必填，股票代码）)","schema":{"type":"string"},"example":"TSLA"},{"name":"days","in":"query","description":"Look-back days (number（1–30，默认 7）)","schema":{"type":"number"},"example":"7"}],"responses":{"200":{"description":"Hourly spot–perp basis history (as on /basis), with annualized funding\n\n- `points[].t` (number（Unix 秒）): Hour bucket start\n- `points[].basis / lo / hi` (number|null（bps）): Hour close / min / max basis\n- `points[].funding_annual` (number|null（bps）): Annualized funding (hour close)","content":{"application/json":{"example":{"underlying":"TSLA","days":7,"points":[{"t":1789992000,"basis":12,"lo":-4,"hi":31,"funding_annual":820}]}}}}}}}}}