Chord API
Chord is a non-custodial trading app and on-chain data index. The API has three kinds of endpoint: Trade: /quote finds the best route across every venue on…
Finance & banking#cryptocurrency
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Chord is a non-custodial trading app and on-chain data index. The API has three kinds of endpoint:
- Trade:
/quotefinds the best route across every venue on the chain;/swapturns it into a transaction you sign yourself. Chord never holds funds or keys. - Read: every swap on the chain, rolled up by token, venue and hour, from Chord's own index — tokens, launches, holders, top wallets, portfolio PnL, liquidity positions and pools. No key needed. Avalanche, Base, BNB Chain, Arbitrum One and Ethereum have the same rollups under
/chains/{chain}/*; Solana has its own data family under/chains/solana/*(base58 addresses, case-sensitive) and its swaps under/sol/trade/*. - Agent: the analyst (
/ask) and the streams.
Amounts are decimal strings in the token's smallest unit. Timestamps are Unix seconds unless the field is updatedAt (milliseconds). GET /portfolio/{wallet} and /portfolio/{wallet}/activity differ on both: amounts there are in whole tokens and every time is in milliseconds. Reads answer anonymous callers at 60 requests a minute per IP; an X-API-Key header raises that to your plan. Every non-2xx body is { error, message }.
Endpoints 141
Quote and swap
- GETBest route for a swap
/quote?inputMint=string&outputMint=string&amount=stringQuotes every venue on the chain in parallel, splits the order across venues when that improves the output, composes a two-hop route through the chain's… - POSTBuild an unsigned swap transaction
/swapTurns a quote into a transaction against the Chord router. You sign it and broadcast it; Chord never sees a key and never holds funds. Notes Send the /quote… - GETQuote and build in one call
/swap/calldata?tokenIn=string&tokenOut=string&amountIn=stringFor contracts and bots that call the router directly: routes and encodes in a single request. The output goes to msg.sender; the caller approves the router… - POSTSimulate a built transaction before signing
/swap/simulateeth_calls the built calldata from the user's address and estimates gas, so a revert is caught before the wallet opens. Known selectors are decoded (NotRouter,…
Agents and status
- GETEvery chain and the route of each capability
/chainsThe directory an agent starts from. One entry per chain Chord serves, with its constants (native asset, wrapped native, dollar anchors with real decimals,… - GETHealth of every chain, one generic row each
/health/chainsWhat the status page is built from, readable directly. quotes.engine is the routing engine's own state (ok, starting after a deploy, stale when its pool sync… - GETUptime history, measured from outside Chord's servers
/statusServed by Cloudflare, not by the API's own servers, so it answers while they do not. A probe runs every minute: it reads GET /health/chains and requests one… - GETAgent traffic per chain
/agent/statsHow much programmatic traffic a chain sees through Chord, by the surface it came through: mcp (the hosted MCP), api (an API key), x402 and wallet (not live… - GETOne wallet's swaps through Chord's router
/agent/router/wallet/:addressWhat one address swapped through Chord's router contract in the last days × 24 h (rolling), read from the router's own Swap events: count and USD volume, in… - POSTHosted MCP server
/mcpModel Context Protocol over stateless Streamable HTTP: POST one JSON-RPC message (or a batch of up to 20), get JSON back. Methods: initialize, ping,… - GETThe MCP tools as a function-calling manifest
/mcp/tools.jsonThe same tool list as OpenAI-style function definitions, for frameworks that take a manifest instead of speaking MCP. Always current: it is printed from the…
Meta aggregator
- GETQuote on any chain: Chord first, a fallback only when it fails
/meta/quote?chain=string&tokenIn=string&tokenOut=string&amount=stringOne call that ends in a route you can sign or an honest "no route anywhere". Without taker it is a price; with taker it also returns the unsigned transaction,… - POSTUnsigned transaction on any chain: Chord first, a fallback only when it fails
/meta/swapThe same answer as /meta/quote with a taker required: an UNSIGNED transaction, simulated as the taker. Chord never signs and never holds funds. Send the pair… - GETFallback order and breaker state per chain
/meta/providersWhich aggregators stand behind Chord's router on each chain, in the order they are tried, and whether each one's circuit breaker is closed. first is always…
Arc data
- GETIndex freshness and depth
/arc/statusIs the Arc rollup fresh, how far back it reaches, and the state of the pool index and the holder ledger. Check this before trusting a quiet number. Served… - GETChain totals
/arc/overviewLast 24 hours (volume, swaps, tokens), venue share, 24 hourly buckets and up to 30 daily rows. The numbers on Chord's landing page come from this call. Served… - GETVenue share over a window
/arc/venuesPer-venue volume, trades and share for 1–180 days, with a daily series per venue. Venue ids are listed under Resources → Venue ids. Served from Chord's rollup… - GETEvery token traded in the last 24 hours
/arc/tokensThe Markets board: price, change, volume split, trade counts, attributed traders, market cap, pool counts per venue and honesty flags for every token that… - GETSearch tokens
/arc/tokens/search?q=stringSymbol, name or address over every token traded in the last 24 hours. Exact symbol first, then prefix, then name, then substring; listed tokens and volume… - GETMovers of the last two hours
/arc/trendingTokens scored on volume and trade acceleration over the last two hours, from the hourly rollup. Each row is a full token row plus the score and its inputs. - GETNew launches
/arc/graduatedTokens whose first pool on Arc was created inside the window, routable by the engine today and screened: impostor symbols, launch farms (one creator, many… - GETWho is creating pools
/arc/launchersLauncher contracts on Arc (Uniswap V4 direct, Uniswap Liquidity Launcher, aka.fun, Argus, Minara.fun, Rapid Launch, …): the pool shapes each one creates,… - GETWhat people on Chord are looking at
/arc/attentionTokens ranked by attention on Chord itself — searches, token-page views, Ask questions and watchlist adds — over 1–7 days. A demand signal, not a price signal. - GETOne token: hourly tape and venue split
/arc/token/:addressThe token row plus an hourly series (1–720 hours) and the venue split for the window. Feeds Chord's token page header, volume bars and venue table. A token… - GETEvery indexed pool for a token
/arc/token/:address/poolsV2 pairs, V3 pools and V4 pool ids (with hooks) that hold the token, with the creation block. For LP-oriented ranking use /lp/token/{address}/pools. - GETHolder ledger
/arc/token/:address/holdersTop balances from Chord's own Transfer-log ledger, each tagged wallet / pool / burn, with the holder count, the share of supply outside pools and burn sinks,… - GETLatest prints
/arc/token/:address/tradesThe last N swaps of one token straight from Chord's own Arc tape (newest first): venue, side, size, USD, price, wallet (null until resolved) and pool. Bounded…
Tokens and charts
- GETCurated token list
/tokens?chain=143Metadata for the tokens Chord routes and labels: address, symbol, name, decimals, logo, tags. On Arc the list leads with the USDC predeploy (the gas token's… - GETPrice map
/tokens/market?chain=4663Price, 24-hour change, volume and trade count for every priced token in Chord's index of the chain (thousands of rows, not just the curated list), in one… - GETSearch tokens on a chain
/tokens/search?q=stringSymbol, name or address. What it searches depends on chain: 4663 Robinhood Chain: the curated list (verified: true, stocks tagged stock) plus every token that… - GETCandles
/tokens/chart/:addressOHLCV candles from Chord's own tape, address-keyed — one call serves Arc and Robinhood Chain tokens (addresses cannot collide). 200 candles per page; before… - GETCandles (data API)
/candles?token=stringOHLCV for any token Chord indexes on Arc, Robinhood Chain, Avalanche, Base, BNB Chain, Arbitrum, Ethereum or Monad, built only from Chord's own index — never… - GETTrade tape
/tokens/trades/:addressRecent swaps of a token, newest first, with the venue, side, size, price and the attributed wallet. Filter by side, venue, minimum size or wallet; page with… - GETWindowed stats
/tokens/stats/:addressDexScreener-style windows (5 m, 1 h, 6 h, 24 h): change, transactions, buys/sells, buy/sell volume, makers, buyers, sellers — plus all-time high, 24-hour… - GETToken logo
/logo/:chain/:addressA 128 px WebP of the token's logo, fetched once from the upstream source and cached on disk. A placeholder image (200) when there is none — never a 404, so an…
Top wallets
- GETWallets ranked by Smart Score
/smart-money/top?chain=143&source=onchainWhich wallets make money on the chain, from the tape, ranked by a skill-adjusted score rather than raw profit (realized-weighted, luck-corrected,…
Portfolio
- GETHoldings and PnL on every chain
/portfolio/:walletWhat one wallet holds on Chord's eight EVM chains, and on Solana when you pass its Solana address, with its PnL over the last 24 hours, 7 days and 30 days.… - GETSwaps on every chain
/portfolio/:wallet/activityThe wallet's swaps on every chain in scope, merged newest first, one keyset page at a time. Each item is one side of a swap seen from the wallet: buy = it… - GETAverage buy and exits per token
/portfolio/:wallet/positionsWhat each token a wallet holds cost it, and what each token it sold made, over all the swap history Chord's index holds for the wallet (not a 30-day window),… - GETRealized and open PnL per token
/portfolio/:wallet/pnlAverage-cost PnL for one wallet from the tape: realized on sells, unrealized on what is still held at current prices, ROI, and the untracked balance that… - GETHoldings on every chain
/wallet/:wallet/balancesWhat a wallet holds right now on Chord's six chains (Monad, Robinhood Chain, Arc, Avalanche, Base, BNB Chain), read on-chain: the native coin plus every token… - GETTrade history
/portfolio/:wallet/tradesThe wallet's buys and sells on the chain, newest first — the markers on a portfolio chart. Portfolio routes answer an empty 200 shape rather than a 5xx when… - GETRealized PnL by day
/portfolio/:wallet/pnl-calendarDay-by-day realized PnL (UTC days) with the trade count, from the same average-cost model as /pnl, so the day sums reconcile with realized by construction.…
Liquidity
- GETLiquidity headline
/lp/overview?chain=5042The pools page pulse: fees paid to LPs in 24 hours (top 100 pools by fees), the best real yield (≥ 25 traders, not suspect), dollars added and removed,… - GETPools ranked for a liquidity provider
/lp/pools?chain=5042Every indexed pool with volume by window, fees (volume × the pool's fee tier), TVL, fee/TVL and an annualised yardstick, LP adds / removes / providers in 24… - GETOne pool
/lp/pools/:pool?chain=5042The pool row plus its hourly series (the last 168 hours by default; hours up to 720), the top providers over 7 days, the health score with its parts and… - GETOpen positions in a pool
/lp/pools/:pool/positions?chain=5042Managed positions (V3 NPM / V4 PositionManager NFTs) open in the pool, largest first, valued live. - GETA pool's providers by profit
/lp/pools/:pool/lps?chain=5042The wallets that provided to one pool, most profitable first. Profit is the wallet board's: value out + fees − value in on closed positions, plus the fees of… - GETOne wallet's LP record
/lp/wallet/:address?chain=5042Everything the wallet board knows about one wallet, whether it is ranked or not: win rate, fees, profit, expected value per position, average invested / age /… - GETA wallet's positions
/lp/positions?chain=5042&owner=stringEvery managed position a wallet holds or held: dollars in and out, fees collected, live value and uncollected fees (V3), in-range, PnL on the liquidity leg,… - GETOne position
/lp/position/:chain/:manager/:idA position by its NFT: the valued row, its events, and a hold-instead comparison (what the same tokens would be worth unpooled). native carries the same… - GETBest liquidity providers
/lp/leaderboard?chain=5042LP wallets from the ledger: win rate, fees, pools, expected value per position, average age / invested / monthly profit, profit over 7 / 30 days / all time,… - GETLiquidity events
/lp/events?chain=5042Adds, removes and fee collects on one token, wallet or pool, newest first, each valued in dollars where the pool has an anchor side. One of token, wallet or… - GETLiquidity flow for a token
/lp/token/:address?chain=5042Adds, removes and net dollars over the window, one-sided (token-only) events counted but not valued, just-in-time liquidity (same-transaction add and remove)… - GETA token's pools by health
/lp/token/:address/pools?chain=5042The token's pools ranked by the 0–100 health score with the reasons behind it, and launch facts on Arc (launcher, its share of the liquidity, when it last… - GETPlan a position
/lp/plan?chain=5042&token=stringRange bands for a token from its own volatility (tight / balanced / wide, with the share of the last seven days each range would have stayed inside) and each… - GETBacktest one range
/lp/simulate?chain=5042&token=string&lower=0.0&upper=0.0One explicit price range replayed over the last days of candles in the token's pool: fees earned at the pool's real tier and the position's share, impermanent… - GETWatch state and alert inbox
/lp/watch?chain=5042&wallet=stringWhether the wallet's positions are watched, how many Telegram chats receive its alerts, the alert thresholds, the last alerts, and the pools on its watchlist. - POSTWatch a wallet's positions
/lp/watchTurns on in-app alerts for the wallet's positions (out of range, fees to collect, pool draining) and returns a one-hour Telegram deep link that routes the… - DELETEStop watching a wallet
/lp/watch - POSTWatch a pool
/lp/watch/poolAdds a pool to the wallet's watchlist — drain alerts without holding a position. - DELETEStop watching a pool
/lp/watch/pool - POSTSet a take-profit / stop-loss alert on a position
/lp/watch/markA mark on one open position: when its PnL (percent of the dollars that went in, live value and fees included) crosses the take-profit or the stop-loss, one… - POSTFollow a liquidity provider
/lp/watch/followAlerts for wallet when target opens or closes a position, from now on (a follow does not replay the wallet's past). An "opened" alert links to the same pool… - GETLiquidity lane state
/lp/statusPer-chain cursors, heads, last tick, pool-stat floors and ledger cursors for the liquidity indexer — the freshness check for everything under /lp. The row…
Points
- GETPoints program rules
/points/rulesSeason, current week, points per dollar, the weekly pool, the daily cap, streak multipliers, referral bonuses and the tiers — and the plain-English rules of… - GETWeekly or season leaderboard
/points/leaderboardWallets ranked by points for one week or the whole season, with base points, referral and streak bonuses, volume, trades, days active and tier. 503… - GETOne wallet's standing
/points/wallet/:addressSeason and current-week points, rank, tier and volume for a wallet.
Ask agent
- GETIs the analyst on
/ask/statusWhether Ask is enabled, whether guest sessions are open, and today's token budget. - POSTAsk the analyst
/askChord's analyst over the Arc index and the router — 40+ tools (trending, a token's flow, holders and risk, support and resistance, top traders on a token, a… - GETAsk Picks board
/ask/picksThe analyst's current picks (rebuilt every four hours over tokens with real activity): side, score, confidence, the reasons for and against, and the facts… - POSTBuild a research note
/ask/reportBuilds Chord's three-page research note for a token (HTML → PDF in the browser, plus Markdown) and returns links good for seven days. - POSTAttach an image
/ask/imageUploads one image for a question (PNG, JPEG, WebP, GIF first frame; ≤ 12 MB). It is re-encoded as a JPEG no wider or taller than 2048 px, with its metadata… - GETFetch an attached image
/ask/image/:idThe stored JPEG. Public by unguessable id (an <img> sends no bearer), 30 days. - GETFetch a report
/ask/report/:idThe note as HTML, or Markdown with a .md suffix. Public by unguessable id, seven days. - GETFetch a CSV export
/ask/export/:idA table the analyst exported, as CSV (one hour).
Token safety
- GETIs a token safe
/security/token/:chain/:addressChord's safety report for one token: the same report the Ask analyst, the trade dock and the trade card read. What runs: on the EVM chains, Chord's own…
Bridge
- GETCCTP chain table
/bridge2/configCircle CCTP V2 fast transfer to and from Arc: the chains and domains, USDC addresses, the TokenMessenger / MessageTransmitter contracts, and the Arc-side… - GETCCTP fee
/bridge2/fee?src=0&dst=0Circle's minimum fee for a fast and a standard transfer between two domains, in basis points. - GETAttestation status
/bridge2/status?srcDomain=0&tx=stringIris status for a burn transaction: not_found, pending or complete with the message and attestation when ready. - POSTRelay the Arc mint
/bridge2/relayOnce attested, Chord's relayer submits receiveMessage on Arc so the recipient needs no gas there. 409 NOT_ATTESTED until Iris completes; 429 DAILY_CAP; 503… - POSTCross-chain swap plan
/xswap/planQuotes a token on one chain into a token on another two ways at once — composed (Chord's router on the origin → USDC/USDG rail → Chord's router on the… - POSTComposed cross-chain quote
/xswap/quoteThe composed path only (see /xswap/plan). - GETAdvance and read an order
/xswap/order?id=stringAsks the bridge where the money is and, once it landed, returns a fresh destination-leg quote (destQuote) to sign. Polling this is what moves the order. - POSTRegister a cross-chain order
/xswap/orderQuotes and records the order the wallet is about to sign so it can be resumed after a refresh: the server tracks the bridge (Relay status or Circle… - GETA wallet's in-flight orders
/xswap/orders?user=stringNewest first — how a client recovers cross-chain state it never held locally. - GETBridge providers and chains
/crosschain/configWhether the provider is enabled, its app fee, the origin chains this deployment offers, and the destination chains with display names, native symbols,… - GETBridgeable tokens on a chain
/crosschain/currencies?chainId=0Tokens the provider can move on a chain, filtered by a search term. - POSTBridge quote
/crosschain/quoteA cross-chain quote from the provider: the steps, fees and the transactions to sign on the origin chain (an approve step is added when the origin token is an… - POSTSubmit a signed permit deposit
/crosschain/permitHands a signed signature step from a usePermit quote back to the provider (Relay only): send the step's post.body fields plus the EIP-712 signature. Then poll… - GETBridge status
/crosschain/status?requestId=stringStatus of a bridge by its request id or deposit hash: waiting · depositing · pending · submitted · success · delayed · refund · failure · unknown.
Robinhood Chain data
- GETRollup freshness
/rh/statusChain 4663 only; takes no chain parameter. Served from Chord's rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run. - GETChain totals
/rh/overviewLast 24 hours, venue share, 24 hourly buckets and up to 30 daily rows. Chain 4663 only; takes no chain parameter. Served from Chord's rollup tables, never… - GETVenue share over a window
/rh/venuesChain 4663 only; takes no chain parameter. Served from Chord's rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run. - GETEvery token traded in the last 24 hours
/rh/tokensPrice, change, volume split, trade counts and attributed traders. Unlisted tokens (no curated metadata or logo) are hidden unless asked for. Chain 4663 only;… - GETOne token: hourly tape and venue split
/rh/token/:addressChain 4663 only; takes no chain parameter. Served from Chord's rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run. - GETTokenized stocks
/rh/stocksEvery tokenized stock and ETF on chain 4663 with its 24-hour tape, NAV basis where the issuer publishes a rate, and the share of the last seven days that…
Avalanche, Base, BNB Chain
- GETRollup freshness and coverage
/chains/:chain/statusIs the chain's rollup fresh, how far back it reaches, whether the tape and the public flag are on, where the raw tape is cut, and the ingest floor. Answers… - GETChain totals
/chains/:chain/overviewLast 24 hours (volume, swaps, tokens, venues), distinct wallets per UTC day, venue share, 24 hourly buckets and up to 14 daily rows. Chain-keyed data for… - GETEvery token traded in the last 24 hours
/chains/:chain/tokensThe chain's 24-hour board: price on the busiest venue, change, volume split, trade counts and the dominant venue for every token that traded, with symbol,… - GETLatest prints across the chain
/chains/:chain/printsThe newest swaps of tokens on the chain's 24-hour board, newest first: a ticker, not a tape. It looks back ten minutes, skips trades under $1, keeps at most… - GETOne token: hourly tape and venue split
/chains/:chain/token/:addressThe token's identity (read from the contract), 24-hour stats, an hourly series (1–720 hours) and the venue split for the window. 404 UNKNOWN_TOKEN when the… - GETReference price from CoinGecko
/chains/:chain/token/:address/ref-priceCoinGecko's price and 24-hour change for a token by contract address, for a token Chord's index has not seen trade (or to cross-check one it has). Not Chord's… - GETTrade tape
/chains/:chain/token/:address/tradesThe token's swaps straight from the raw tape, newest first: venue, side, size, USD, price, block, wallet (null for a router or an unattributed trade, never a… - GETLiquidity adds and removes
/chains/:chain/token/:address/liquidityLiquidity added to and removed from the token's busiest V2 / V3-style pools of the day (up to 8), newest first, read live from the chain's Mint and Burn logs:… - GETVenue share over a window
/chains/:chain/venuesPer-venue volume, trades and share for 1–30 UTC days, with a daily series per venue. The first day of a young tape is partial. Chain-keyed data for Avalanche… - GETA wallet's swaps
/chains/:chain/wallet/:address/tradesThe wallet's swaps on the chain, newest first, each with the token and its symbol. Keyset-paged: pass nextBefore back as before for the next page; nextBefore… - GETOne wallet's swaps and PnL
/chains/:chain/wallet/:addressA wallet's swaps on the chain and an average-cost PnL over them. The window is short: the database keeps the raw tape for a few days on these chains (about 3…
Solana data
- GETIs the tape following the chain
/chains/solana/statusThe ingest's own health: the last slot written, how far behind the chain it is, the age of the newest block it has written, swaps per minute, and per-venue… - GETChain totals
/chains/solana/overviewLast 24 hours on the venues the tape reads: volume, trades, buys, tokens traded, venue share and hourly buckets, plus coverageSince. The window never starts… - GETEvery token traded in the last 24 hours
/chains/solana/tokensThe 24-hour board. volume ranks the 600 most traded tokens and trades the 300 with the most trades; change (24-hour price change) and new (first seen in the… - GETFind a token by mint, symbol or name
/chains/solana/search?q=stringA mint returns that token (when the tape has seen it trade). Anything else is an exact, case-insensitive match on symbol or name among the tokens the tape has… - GETOne token: stats, pools and hourly tape
/chains/solana/token/:addressIdentity (from the token's metadata), price on the main pool with 1-hour and 24-hour change, fully diluted market cap, liquidity summed over the pools that… - GETTrade tape
/chains/solana/token/:address/tradesThe token's newest swaps across up to 30 of its pools, newest first: side, both amounts, USD, price, venue, pool, wallet and the transaction signature. Each… - GETCandles
/chains/solana/token/:address/candlesOHLCV of ONE pool of the token, in USD: the main pool (traded in the last hour first, then the deepest) unless pool names another. Not a volume-weighted blend… - GETWho traded the token
/chains/solana/token/:address/tradersThe wallets that traded the token over the window, biggest USD volume first (the top 100; limit slices them): bought, sold, net, trades, and an average-cost… - GETThe day's traders
/chains/solana/tradersWallets ranked by realized PnL or by volume over today's UTC day (days=2 adds yesterday), across every token the tape reads. Bots are left out by rule… - GETSmart traders
/chains/solana/smart-tradersThe wallets that made repeated, verifiable profit over the last 1, 3 or 7 UTC days (today included): bots, launch wallets and lucky one-offs removed by named… - GETOne wallet's tokens and PnL
/chains/solana/wallet/:addressWhat a wallet bought and sold per token over the last days UTC days (today included), with an average-cost PnL: realized on the sold part, unrealized on what… - GETA wallet's swaps
/chains/solana/wallet/:address/tradesThe wallet's newest swaps on the venues the tape reads, newest first, with the token and its symbol. Each page looks back at most seven days from before (or… - GETLiquidity pools by LP activity
/chains/solana/lp/poolsEvery pool where liquidity moved in the window, ranked: fees (claimed fees, default), deposits, withdrawals, net (net inflow), lps (distinct LPs), tvl or… - GETLP wallets
/chains/solana/lp/topWallets ranked over the LP positions active in the window: fees (claimed, default), deposits or pnl (realized). Many leaders are vaults and rebalancing bots;… - GETOne pool's liquidity
/chains/solana/lp/pool/:addressDeposits, withdrawals, net flow and claimed fees over the window, and by hour; open positions and their owners; the pair with decimals, TVL estimate and swap… - GETA pool's positions
/chains/solana/lp/pool/:address/positionsThe pool's positions, most recently active first. Cached 20 seconds. Liquidity on Solana from Chord's own tape: adds, removes, fee claims, position opens and… - GETA wallet's LP positions
/chains/solana/lp/wallet/:addressThe wallet's positions as owner (DLMM: the position's owner, not an operator acting for it), most recently active first, with totals over every position of… - GETA pool's liquidity events
/chains/solana/lp/pool/:address/eventsAdds, removes, fee claims, opens and closes, newest first. A close row of a DLMM close_position2 or a Raydium CLMM position has no pool: the instruction does… - GETA wallet's liquidity events
/chains/solana/lp/wallet/:address/eventsAdds, removes, fee claims, opens and closes, newest first (the wallet as the position's owner). A close row of a DLMM close_position2 or a Raydium CLMM… - GETOne position's events
/chains/solana/lp/position/:address/eventsAdds, removes, fee claims, opens and closes, newest first. A close row of a DLMM close_position2 or a Raydium CLMM position has no pool: the instruction does…
Solana swaps
- GETMay this caller trade
/sol/trade/configenabled = the lane is on in this deployment, open = open to everyone, allowed = open to the caller who asks (a beta account, or everyone once open). Never… - GETBest quote: Chord's route or Jupiter's
/sol/trade/quote?mint=string&side=buy&amount=string&wallet=stringThe quote of the route that leaves the wallet with the most, its unsigned transaction, and what every route offered (compared). ok: false with quote: null and… - POSTSend the signed quote
/sol/trade/sendRelays a transaction Chord quoted in the last three minutes, signed by the wallet it was quoted for — anything else is refused. Chord sends it to several RPC… - GETStatus of a sent swap
/sol/trade/tx/:signaturepending until the transaction is in a block, then confirmed / finalized with receivedOut, or failed / expired (its blockhash ran out; an RFQ order unseen for… - GETA wallet's SOL and one token
/sol/trade/balances?wallet=string&mint=stringFor a swap form: lamports, and the token in the wallet's associated account (amount, what a sell spends) and in all its accounts of that mint (total). Open to… - GETA wallet's SOL and tokens
/sol/trade/holdings?wallet=stringSOL and every token the wallet holds (both token programs, accounts summed), at most 50 by value; more = left out. Name, image and price from Chord's tape…
Backtests
- GETBacktest a strategy
/backtestOne bar-close strategy replayed over stored candles of a Hyperliquid perp or an FX pair / metal. Simulated: nothing is traded. Model (the same text comes back… - GETFX store coverage
/fx/lakeHow far the FX / metal candle store behind /backtest is filled, per symbol: the last month of 1h bars and the last day of 1m bars. state is running while a…
Streaming
- GETServer-sent events: prices
/stream/marketOne text/event-stream feed, no key, EventSource-friendly with automatic reconnect. Events: rh-ticker (fresh prices for chain 4663, about every 10 s, only… - GETWebSocket: live candles, trades and board feeds
/ws/liveUpgrade to a WebSocket. No key needed, rate-limit exempt, up to 8 channels per connection. With an API key (X-API-Key, or ?apiKey= from a browser) the…
Account and health
- GETRelayer gas health
/relayersFor each chain Chord's relayer pays gas on (Monad gasless swaps, Robinhood Permit2 swaps, Arc CCTP mints): its address, native balance, current gas price and… - GETYour key's plan and usage
/meThe limits Chord applies to an API key and the calls counted against them. Keys are made at getchord.xyz/ask under Settings, API. Not metered, and answered… - GETService health
/healthEngine, cache and pool-sync state. 503 when the routing engine is unreachable.
API details
- Base URL
https://api.getchord.xyz/v1- Authentication
- An API key in the X-API-Key header
A bearer token in the Authorization header - Operations
- 141 operations on 137 pathsGET 121POST 18DELETE 2
- Main resources
- Liquidity 22Solana data 20Bridge 14Arc data 13Avalanche, Base, BNB Chain 11Ask agent 8Tokens and charts 8Agents and status 7Portfolio 7Robinhood Chain data 6
- Response formats
application/jsonimage/jpegimage/webptext/csv- Description format
- OpenAPI 3.1.0, API version
2026-10-05 - Links
- OpenAPI document · Support
- Listed from
- Getchord's published OpenAPI description
How to test the Chord API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Chord API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Best route for a swap” (GET /quote?inputMint=string&outputMint=string&amount=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Chord API?
Chord is a non-custodial trading app and on-chain data index. The API has three kinds of endpoint: Trade: /quote finds the best route across every venue on… It is listed under Finance & banking and has 141 endpoints.
Who publishes the Chord API?
It is listed from Getchord's public API description (an OpenAPI document), not published by Getchord on Swastik Codes. Anyone who controls getchord.xyz can claim the profile by adding a DNS TXT record.
What is the base URL of the Chord API?
Requests go to https://api.getchord.xyz/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Chord API?
It accepts 2 methods: an API key in the X-API-Key header; A bearer token in the Authorization header.
How many endpoints does the Chord API have?
141 operations on 137 paths (121 GET, 18 POST, 2 DELETE). The largest groups are Liquidity, Solana data, Bridge, Arc data.
Is forking the Chord API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.