Chaconne API alpha

Premium history, liquidity grades, and asset lists for tokenized US stocks — free, application-based. For market makers, researchers, media. Indicative only, not advice; attribution to Chaconne required.

Auth

Send on every request:

x-api-key: ck_your_key

Default 60 req/min. Data cached ~30s.

Machine-readable description (OpenAPI 3.1): /openapi.json

Endpoints

'Public' endpoints need no key (short cache — please don't poll aggressively); 'key' endpoints require an application. Field tables and samples reflect live responses as of 2026-09-21; values are illustrative. All bps are 1/10,000 (100 bps = 1%).

GET /api/v1/assetskeyfields & sample ▾

All tokenized stocks (issuer / chain / contract address / liquidity grade)

Response fields

attribution	string	Attribution string (constant)
count	number	Number of assets
assets[].symbol	string	Token symbol, e.g. TSLAx
assets[].underlying	string	Underlying ticker, e.g. TSLA
assets[].name_en / name_cn	string	English / Chinese names
assets[].issuer	string	Issuer: xstocks / ondo / bstocks
assets[].chain	string	Chain: solana / bnb
assets[].address	string	Token contract (mint) address
assets[].tags	string[]	Tags (sector etc.)
assets[].grade	'A'\|'B'\|'C'\|'D'\|null	Liquidity grade (null if unrated)

Sample response

{"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"}]}

Errors

401 missing_api_key — x-api-key header missing
403 invalid_api_key / revoked_api_key / key_pending_approval — Key invalid / revoked / pending approval
429 rate_limited — Over the per-minute limit (default 60)
503 unavailable — Database unavailable

GET /api/v1/liquidity-scoreskeyfields & sample ▾

Liquidity grades A/B/C/D with $1k / $10k price impact (7-day rolling median)

Response fields

methodology	string	Grading methodology (constant text)
scores[].symbol	string	Token symbol
scores[].grade	'A'\|'B'\|'C'\|'D'	A≤50 / B≤150 / C≤500 bps @ $10k; D >500 or no route
scores[].impact_1k_bps / impact_10k_bps	number\|null	Adverse impact buying $1k / $10k (bps); null when no route
scores[].sample_n	number	Samples in the 7-day window (treat <3 as insufficient)
scores[].updated_at	ISO datetime	Last update (UTC)

Sample response

{"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"}]}

Errors

401 / 403 / 429 / 503 — As above

GET /api/v1/premium-history?symbol=NVDAx&days=30keyfields & sample ▾

Hourly premium history for one asset (bps, up to 90 days)

Parameters

symbol	string（必填，1–12 位字母数字）	Token symbol
days	number（1–90，默认 30）	Look-back days

Response fields

symbol / days	string / number	Echoed parameters
points[].ts	ISO datetime	Hour bucket start (UTC)
points[].premium_bps	number\|null	Hour-close premium (positive = on-chain above stock); null when no reference

Sample response

{"attribution":"Chaconne — chaconne.xyz","symbol":"NVDAx","days":30,"points":[{"ts":"2026-09-19T14:00:00.000Z","premium_bps":-42}]}

Errors

400 bad_symbol — Invalid symbol
401 / 403 / 429 / 503 — As above

GET /api/market-overview?days=90publicfields & sample ▾

Market totals: live 24h volume / liquidity / asset count plus self-collected daily snapshots (market / issuer / chain)

Parameters

days

number（1–365，默认 90）

History window

Response fields

live.vol24Usd / liquidityUsd	number\|null	Live 24h DEX volume / liquidity (USD)
live.assetCount	number	Tokens listed (same definition as the statistics page and /api/v1/assets count)
live.tokensWithDexData	number	Of those, tokens with DEX volume / liquidity data (none on X Layer yet)
series[].day	YYYY-MM-DD	Snapshot day (UTC)
series[].scope	string	all / issuer:xstocks / chain:solana …
series[].vol / liq / cnt	number	Day's 24h volume / liquidity (USD) / tokens with DEX data

Sample response

{"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}}

Errors

200 {series:[],live:null} — Empty payload when the database is unavailable (no error)

GET /api/premium/history?symbol=GLDx&days=7publicfields & sample ▾

Hourly premium + net-edge history for one asset (with hourly min / max)

Parameters

symbol	string（必填）	Token symbol
days	number（1–30，默认 7）	Look-back days

Response fields

points[].t	number（Unix 秒）	Hour bucket start
points[].premium / lo / hi	number\|null（bps）	Hour close / min / max premium
points[].net_edge	number\|null（bps）	Net edge after platform fee and $1k impact (negative = pricier than the stock)

Sample response

{"symbol":"GLDx","days":7,"points":[{"t":1789992000,"premium":-38,"lo":-55,"hi":-12,"net_edge":-102}]}

Errors

200 {points:[]} — No data / database unavailable

GET /api/basis/history?underlying=TSLA&days=7publicfields & sample ▾

Hourly spot–perp basis history (as on /basis), with annualized funding

Parameters

underlying	string（必填，股票代码）	Underlying, e.g. TSLA
days	number（1–30，默认 7）	Look-back days

Response fields

points[].t	number（Unix 秒）	Hour bucket start
points[].basis / lo / hi	number\|null（bps）	Hour close / min / max basis
points[].funding_annual	number\|null（bps）	Annualized funding (hour close)

Sample response

{"underlying":"TSLA","days":7,"points":[{"t":1789992000,"basis":12,"lo":-4,"hi":31,"funding_annual":820}]}

Errors

200 {points:[]} — No basis data for this underlying (perp source not covering it)

# key 端点
curl https://chaconne.xyz/api/v1/liquidity-scores \
  -H "x-api-key: ck_your_key"
# 公开端点
curl "https://chaconne.xyz/api/premium/history?symbol=GLDx&days=7"

The verification & constrained-execution API for agents (reports / plans / mandates / evidence bundles) is documented at verify.chaconne.xyz/developers.

Auth

Endpoints

Apply for a key (free)