# API reference

> Every endpoint of the Chord REST API, grouped as in the docs. Base URL https://api.getchord.xyz/v1. Machine-readable contract: https://getchord.xyz/docs/openapi.json

Source: https://getchord.xyz/docs/api-reference/

## Quote and swap

Best-route quotes across every venue on the chain, and the unsigned transaction to execute them.

- [Best route for a swap](https://getchord.xyz/docs/api-reference/operations/getquote.md): `GET /quote`
- [Build an unsigned swap transaction](https://getchord.xyz/docs/api-reference/operations/buildswap.md): `POST /swap`
- [Quote and build in one call](https://getchord.xyz/docs/api-reference/operations/swapcalldata.md): `GET /swap/calldata`
- [Simulate a built transaction before signing](https://getchord.xyz/docs/api-reference/operations/simulateswap.md): `POST /swap/simulate`

## Agents and status

What an agent starts from: the chain directory (which capability lives on which route, per chain), the hosted MCP server, per-chain health, the public status history, and how much agent traffic each chain sees.

- [Every chain and the route of each capability](https://getchord.xyz/docs/api-reference/operations/chainsdirectory.md): `GET /chains`
- [Health of every chain, one generic row each](https://getchord.xyz/docs/api-reference/operations/chainhealth.md): `GET /health/chains`
- [Uptime history, measured from outside Chord's servers](https://getchord.xyz/docs/api-reference/operations/statussummary.md): `GET /status`
- [Agent traffic per chain](https://getchord.xyz/docs/api-reference/operations/agentstats.md): `GET /agent/stats`
- [Hosted MCP server](https://getchord.xyz/docs/api-reference/operations/mcp.md): `POST /mcp`
- [The MCP tools as a function-calling manifest](https://getchord.xyz/docs/api-reference/operations/mcptools.md): `GET /mcp/tools.json`

## Meta aggregator

One quote and one unsigned transaction on any Chord chain, for agents. Chord's own router answers first; a third-party aggregator (KyberSwap, Monorail, LI.FI, Relay) only when Chord fails, never for a better price. Every answer names the provider, and a fallback transaction is returned only when its router is on Chord's allowlist and it passed a simulation run as the taker.

- [Quote on any chain: Chord first, a fallback only when it fails](https://getchord.xyz/docs/api-reference/operations/metaquote.md): `GET /meta/quote`
- [Unsigned transaction on any chain: Chord first, a fallback only when it fails](https://getchord.xyz/docs/api-reference/operations/metaswap.md): `POST /meta/swap`
- [Fallback order and breaker state per chain](https://getchord.xyz/docs/api-reference/operations/metaproviders.md): `GET /meta/providers`

## Arc data

Arc (chain 5042): chain totals, every token traded, launches, launchers, holders — from Chord's own rollup and index tables.

- [Index freshness and depth](https://getchord.xyz/docs/api-reference/operations/arcstatus.md): `GET /arc/status`
- [Chain totals](https://getchord.xyz/docs/api-reference/operations/arcoverview.md): `GET /arc/overview`
- [Venue share over a window](https://getchord.xyz/docs/api-reference/operations/arcvenues.md): `GET /arc/venues`
- [Every token traded in the last 24 hours](https://getchord.xyz/docs/api-reference/operations/arctokens.md): `GET /arc/tokens`
- [Search tokens](https://getchord.xyz/docs/api-reference/operations/arcsearch.md): `GET /arc/tokens/search`
- [Movers of the last two hours](https://getchord.xyz/docs/api-reference/operations/arctrending.md): `GET /arc/trending`
- [New launches](https://getchord.xyz/docs/api-reference/operations/arcgraduated.md): `GET /arc/graduated`
- [Who is creating pools](https://getchord.xyz/docs/api-reference/operations/arclaunchers.md): `GET /arc/launchers`
- [What people on Chord are looking at](https://getchord.xyz/docs/api-reference/operations/arcattention.md): `GET /arc/attention`
- [One token: hourly tape and venue split](https://getchord.xyz/docs/api-reference/operations/arctoken.md): `GET /arc/token/{address}`
- [Every indexed pool for a token](https://getchord.xyz/docs/api-reference/operations/arctokenpools.md): `GET /arc/token/{address}/pools`
- [Holder ledger](https://getchord.xyz/docs/api-reference/operations/arctokenholders.md): `GET /arc/token/{address}/holders`
- [Latest prints](https://getchord.xyz/docs/api-reference/operations/arctokentrades.md): `GET /arc/token/{address}/trades`

## Tokens and charts

Curated lists, candles, trade tapes, windowed stats and logos. Address-keyed routes serve both chains.

- [Curated token list](https://getchord.xyz/docs/api-reference/operations/listtokens.md): `GET /tokens`
- [Price map](https://getchord.xyz/docs/api-reference/operations/marketmap.md): `GET /tokens/market`
- [Search tokens on a chain](https://getchord.xyz/docs/api-reference/operations/searchtokens.md): `GET /tokens/search`
- [Candles](https://getchord.xyz/docs/api-reference/operations/tokenchart.md): `GET /tokens/chart/{address}`
- [Candles (data API)](https://getchord.xyz/docs/api-reference/operations/candles.md): `GET /candles`
- [Trade tape](https://getchord.xyz/docs/api-reference/operations/tokentrades.md): `GET /tokens/trades/{address}`
- [Windowed stats](https://getchord.xyz/docs/api-reference/operations/tokenstats.md): `GET /tokens/stats/{address}`
- [Token logo](https://getchord.xyz/docs/api-reference/operations/tokenlogo.md): `GET /logo/{chain}/{address}`

## Top wallets

Wallets ranked from the tape by a skill-adjusted score, with routers and bots removed.

- [Wallets ranked by Smart Score](https://getchord.xyz/docs/api-reference/operations/smartmoneytop.md): `GET /smart-money/top`

## Portfolio

Average-cost PnL, trade history and a daily calendar for any wallet.

- [Realized and open PnL per token](https://getchord.xyz/docs/api-reference/operations/walletpnl.md): `GET /portfolio/{wallet}/pnl`
- [Holdings on every chain](https://getchord.xyz/docs/api-reference/operations/walletbalances.md): `GET /wallet/{wallet}/balances`
- [Trade history](https://getchord.xyz/docs/api-reference/operations/wallettrades.md): `GET /portfolio/{wallet}/trades`
- [Realized PnL by day](https://getchord.xyz/docs/api-reference/operations/walletpnlcalendar.md): `GET /portfolio/{wallet}/pnl-calendar`

## Liquidity

Liquidity: events, pools ranked for providers, positions valued live, LP leaderboard, range planning and backtests, alerts.

- [Liquidity headline](https://getchord.xyz/docs/api-reference/operations/lpoverview.md): `GET /lp/overview`
- [Pools ranked for a liquidity provider](https://getchord.xyz/docs/api-reference/operations/lppools.md): `GET /lp/pools`
- [One pool](https://getchord.xyz/docs/api-reference/operations/lppool.md): `GET /lp/pools/{pool}`
- [Open positions in a pool](https://getchord.xyz/docs/api-reference/operations/lppoolpositions.md): `GET /lp/pools/{pool}/positions`
- [A pool's providers by profit](https://getchord.xyz/docs/api-reference/operations/lppoollps.md): `GET /lp/pools/{pool}/lps`
- [One wallet's LP record](https://getchord.xyz/docs/api-reference/operations/lpwallet.md): `GET /lp/wallet/{address}`
- [A wallet's positions](https://getchord.xyz/docs/api-reference/operations/lppositions.md): `GET /lp/positions`
- [One position](https://getchord.xyz/docs/api-reference/operations/lpposition.md): `GET /lp/position/{chain}/{manager}/{id}`
- [Best liquidity providers](https://getchord.xyz/docs/api-reference/operations/lpleaderboard.md): `GET /lp/leaderboard`
- [Liquidity events](https://getchord.xyz/docs/api-reference/operations/lpevents.md): `GET /lp/events`
- [Liquidity flow for a token](https://getchord.xyz/docs/api-reference/operations/lptoken.md): `GET /lp/token/{address}`
- [A token's pools by health](https://getchord.xyz/docs/api-reference/operations/lptokenpools.md): `GET /lp/token/{address}/pools`
- [Plan a position](https://getchord.xyz/docs/api-reference/operations/lpplan.md): `GET /lp/plan`
- [Backtest one range](https://getchord.xyz/docs/api-reference/operations/lpsimulate.md): `GET /lp/simulate`
- [Watch state and alert inbox](https://getchord.xyz/docs/api-reference/operations/lpwatchstatus.md): `GET /lp/watch`
- [Watch a wallet's positions](https://getchord.xyz/docs/api-reference/operations/lpwatch.md): `POST /lp/watch`
- [Stop watching a wallet](https://getchord.xyz/docs/api-reference/operations/lpunwatch.md): `DELETE /lp/watch`
- [Watch a pool](https://getchord.xyz/docs/api-reference/operations/lpwatchpool.md): `POST /lp/watch/pool`
- [Stop watching a pool](https://getchord.xyz/docs/api-reference/operations/lpunwatchpool.md): `DELETE /lp/watch/pool`
- [Set a take-profit / stop-loss alert on a position](https://getchord.xyz/docs/api-reference/operations/lpwatchmark.md): `POST /lp/watch/mark`
- [Follow a liquidity provider](https://getchord.xyz/docs/api-reference/operations/lpwatchfollow.md): `POST /lp/watch/follow`
- [Liquidity lane state](https://getchord.xyz/docs/api-reference/operations/lpstatus.md): `GET /lp/status`

## Points

The Chord points program on Arc.

- [Points program rules](https://getchord.xyz/docs/api-reference/operations/pointsrules.md): `GET /points/rules`
- [Weekly or season leaderboard](https://getchord.xyz/docs/api-reference/operations/pointsleaderboard.md): `GET /points/leaderboard`
- [One wallet's standing](https://getchord.xyz/docs/api-reference/operations/pointswallet.md): `GET /points/wallet/{address}`

## Ask agent

The analyst agent over the Arc index, its picks and research notes.

- [Is the analyst on](https://getchord.xyz/docs/api-reference/operations/askstatus.md): `GET /ask/status`
- [Ask the analyst](https://getchord.xyz/docs/api-reference/operations/ask.md): `POST /ask`
- [Ask Picks board](https://getchord.xyz/docs/api-reference/operations/askpicks.md): `GET /ask/picks`
- [Build a research note](https://getchord.xyz/docs/api-reference/operations/askreport.md): `POST /ask/report`
- [Attach an image](https://getchord.xyz/docs/api-reference/operations/askimageupload.md): `POST /ask/image`
- [Fetch an attached image](https://getchord.xyz/docs/api-reference/operations/askimage.md): `GET /ask/image/{id}`
- [Fetch a report](https://getchord.xyz/docs/api-reference/operations/askreportget.md): `GET /ask/report/{id}`
- [Fetch a CSV export](https://getchord.xyz/docs/api-reference/operations/askexport.md): `GET /ask/export/{id}`

## Bridge

Circle CCTP fast transfer to Arc, and LI.FI routes from 60+ chains.

- [CCTP chain table](https://getchord.xyz/docs/api-reference/operations/bridge2config.md): `GET /bridge2/config`
- [CCTP fee](https://getchord.xyz/docs/api-reference/operations/bridge2fee.md): `GET /bridge2/fee`
- [Attestation status](https://getchord.xyz/docs/api-reference/operations/bridge2status.md): `GET /bridge2/status`
- [Relay the Arc mint](https://getchord.xyz/docs/api-reference/operations/bridge2relay.md): `POST /bridge2/relay`
- [Cross-chain swap plan](https://getchord.xyz/docs/api-reference/operations/xswapplan.md): `POST /xswap/plan`
- [Composed cross-chain quote](https://getchord.xyz/docs/api-reference/operations/xswapquote.md): `POST /xswap/quote`
- [Advance and read an order](https://getchord.xyz/docs/api-reference/operations/xswaporderget.md): `GET /xswap/order`
- [Register a cross-chain order](https://getchord.xyz/docs/api-reference/operations/xswaporder.md): `POST /xswap/order`
- [A wallet's in-flight orders](https://getchord.xyz/docs/api-reference/operations/xswaporders.md): `GET /xswap/orders`
- [Bridge providers and chains](https://getchord.xyz/docs/api-reference/operations/crosschainconfig.md): `GET /crosschain/config`
- [Bridgeable tokens on a chain](https://getchord.xyz/docs/api-reference/operations/crosschaincurrencies.md): `GET /crosschain/currencies`
- [Bridge quote](https://getchord.xyz/docs/api-reference/operations/crosschainquote.md): `POST /crosschain/quote`
- [Submit a signed permit deposit](https://getchord.xyz/docs/api-reference/operations/crosschainpermit.md): `POST /crosschain/permit`
- [Bridge status](https://getchord.xyz/docs/api-reference/operations/crosschainstatus.md): `GET /crosschain/status`

## Robinhood Chain data

Robinhood Chain (chain 4663): chain totals, tokens and tokenized stocks from the rollup tables.

- [Rollup freshness](https://getchord.xyz/docs/api-reference/operations/rhstatus.md): `GET /rh/status`
- [Chain totals](https://getchord.xyz/docs/api-reference/operations/rhoverview.md): `GET /rh/overview`
- [Venue share over a window](https://getchord.xyz/docs/api-reference/operations/rhvenues.md): `GET /rh/venues`
- [Every token traded in the last 24 hours](https://getchord.xyz/docs/api-reference/operations/rhtokens.md): `GET /rh/tokens`
- [One token: hourly tape and venue split](https://getchord.xyz/docs/api-reference/operations/rhtoken.md): `GET /rh/token/{address}`
- [Tokenized stocks](https://getchord.xyz/docs/api-reference/operations/rhstocks.md): `GET /rh/stocks`

## Avalanche, Base, BNB Chain

Avalanche C-Chain (43114), Base (8453), BNB Chain (56), Arbitrum One (42161) and Ethereum (1): chain totals, the 24-hour token board, prints, one token's tape, venue share and a wallet's PnL, from Chord's own index of every swap on those chains. One set of routes, the chain in the path.

- [Rollup freshness and coverage](https://getchord.xyz/docs/api-reference/operations/chainstatus.md): `GET /chains/{chain}/status`
- [Chain totals](https://getchord.xyz/docs/api-reference/operations/chainoverview.md): `GET /chains/{chain}/overview`
- [Every token traded in the last 24 hours](https://getchord.xyz/docs/api-reference/operations/chaintokens.md): `GET /chains/{chain}/tokens`
- [Latest prints across the chain](https://getchord.xyz/docs/api-reference/operations/chainprints.md): `GET /chains/{chain}/prints`
- [One token: hourly tape and venue split](https://getchord.xyz/docs/api-reference/operations/chaintoken.md): `GET /chains/{chain}/token/{address}`
- [Reference price from CoinGecko](https://getchord.xyz/docs/api-reference/operations/chaintokenrefprice.md): `GET /chains/{chain}/token/{address}/ref-price`
- [Trade tape](https://getchord.xyz/docs/api-reference/operations/chaintokentrades.md): `GET /chains/{chain}/token/{address}/trades`
- [Venue share over a window](https://getchord.xyz/docs/api-reference/operations/chainvenues.md): `GET /chains/{chain}/venues`
- [A wallet's swaps](https://getchord.xyz/docs/api-reference/operations/chainwallettrades.md): `GET /chains/{chain}/wallet/{address}/trades`
- [One wallet's swaps and PnL](https://getchord.xyz/docs/api-reference/operations/chainwallet.md): `GET /chains/{chain}/wallet/{address}`

## Solana data

Solana, read-only: chain totals, the 24-hour token board, search, one token's stats, prints, candles and traders, the day's trader board, a wallet's PnL, and liquidity (LP pools, positions, events, LP wallets on Meteora DLMM / DAMM v2, Raydium CLMM and PumpSwap), from Chord's own tape of the swap events of 11 Solana venues (PumpSwap, pump.fun, Meteora, Raydium, Orca). Prop AMMs and order books are not read. Addresses are base58 and case-sensitive; the path segment is the literal `solana`. Read the notes on each operation before comparing these numbers with an all-market source.

- [Is the tape following the chain](https://getchord.xyz/docs/api-reference/operations/solstatus.md): `GET /chains/solana/status`
- [Chain totals](https://getchord.xyz/docs/api-reference/operations/soloverview.md): `GET /chains/solana/overview`
- [Every token traded in the last 24 hours](https://getchord.xyz/docs/api-reference/operations/soltokens.md): `GET /chains/solana/tokens`
- [Find a token by mint, symbol or name](https://getchord.xyz/docs/api-reference/operations/solsearch.md): `GET /chains/solana/search`
- [One token: stats, pools and hourly tape](https://getchord.xyz/docs/api-reference/operations/soltoken.md): `GET /chains/solana/token/{address}`
- [Trade tape](https://getchord.xyz/docs/api-reference/operations/soltokentrades.md): `GET /chains/solana/token/{address}/trades`
- [Candles](https://getchord.xyz/docs/api-reference/operations/soltokencandles.md): `GET /chains/solana/token/{address}/candles`
- [Who traded the token](https://getchord.xyz/docs/api-reference/operations/soltokentraders.md): `GET /chains/solana/token/{address}/traders`
- [The day's traders](https://getchord.xyz/docs/api-reference/operations/soltraders.md): `GET /chains/solana/traders`
- [Smart traders](https://getchord.xyz/docs/api-reference/operations/solsmarttraders.md): `GET /chains/solana/smart-traders`
- [One wallet's tokens and PnL](https://getchord.xyz/docs/api-reference/operations/solwallet.md): `GET /chains/solana/wallet/{address}`
- [A wallet's swaps](https://getchord.xyz/docs/api-reference/operations/solwallettrades.md): `GET /chains/solana/wallet/{address}/trades`
- [Liquidity pools by LP activity](https://getchord.xyz/docs/api-reference/operations/sollppools.md): `GET /chains/solana/lp/pools`
- [LP wallets](https://getchord.xyz/docs/api-reference/operations/sollptop.md): `GET /chains/solana/lp/top`
- [One pool's liquidity](https://getchord.xyz/docs/api-reference/operations/sollppool.md): `GET /chains/solana/lp/pool/{address}`
- [A pool's positions](https://getchord.xyz/docs/api-reference/operations/sollppoolpositions.md): `GET /chains/solana/lp/pool/{address}/positions`
- [A wallet's LP positions](https://getchord.xyz/docs/api-reference/operations/sollpwallet.md): `GET /chains/solana/lp/wallet/{address}`
- [A pool's liquidity events](https://getchord.xyz/docs/api-reference/operations/sollppoolevents.md): `GET /chains/solana/lp/pool/{address}/events`
- [A wallet's liquidity events](https://getchord.xyz/docs/api-reference/operations/sollpwalletevents.md): `GET /chains/solana/lp/wallet/{address}/events`
- [One position's events](https://getchord.xyz/docs/api-reference/operations/sollppositionevents.md): `GET /chains/solana/lp/position/{address}/events`

## Solana swaps

Solana swaps, open to everyone: every quote builds Chord's own route (Raydium, Orca, Meteora, pump.fun, PumpSwap) and Jupiter's for the wallet, simulates them, and returns the one that leaves the wallet with the most; you sign and send it back.

- [May this caller trade](https://getchord.xyz/docs/api-reference/operations/soltradeconfig.md): `GET /sol/trade/config`
- [Best quote: Chord's route or Jupiter's](https://getchord.xyz/docs/api-reference/operations/soltradequote.md): `GET /sol/trade/quote`
- [Send the signed quote](https://getchord.xyz/docs/api-reference/operations/soltradesend.md): `POST /sol/trade/send`
- [Status of a sent swap](https://getchord.xyz/docs/api-reference/operations/soltradetx.md): `GET /sol/trade/tx/{signature}`
- [A wallet's SOL and one token](https://getchord.xyz/docs/api-reference/operations/soltradebalances.md): `GET /sol/trade/balances`
- [A wallet's SOL and tokens](https://getchord.xyz/docs/api-reference/operations/soltradeholdings.md): `GET /sol/trade/holdings`

## Backtests

Bar-close strategy backtests over Chord's stored candles: any Hyperliquid perp, 13 FX pairs and metals. Simulated, nothing is traded.

- [Backtest a strategy](https://getchord.xyz/docs/api-reference/operations/backtest.md): `GET /backtest`
- [FX store coverage](https://getchord.xyz/docs/api-reference/operations/fxlake.md): `GET /fx/lake`

## Streaming

Server-sent events and the public WebSocket.

- [Server-sent events: prices](https://getchord.xyz/docs/api-reference/operations/streammarket.md): `GET /stream/market`
- [WebSocket: live candles, trades and board feeds](https://getchord.xyz/docs/api-reference/operations/wslive.md): `GET /ws/live`

## Account and health

Your key, and the service's own health.

- [Relayer gas health](https://getchord.xyz/docs/api-reference/operations/relayers.md): `GET /relayers`
- [Your key's plan and usage](https://getchord.xyz/docs/api-reference/operations/me.md): `GET /me`
- [Service health](https://getchord.xyz/docs/api-reference/operations/health.md): `GET /health`