One wallet's swaps through Chord's router
const url = 'https://api.getchord.xyz/v1/agent/router/wallet/example?days=30';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.getchord.xyz/v1/agent/router/wallet/example?days=30'What 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 total and per chain. A swap with a dollar-stable leg is worth that leg; one with the chain’s own coin (native or wrapped) on a leg is worth that amount at CoinGecko’s price now; anything else is unpriced and counts for $0. MoltNode (moltnode.ag/quest) sizes RPC keys from volumeUsd. Public: router events are public chain data. Cached 60 s.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”EVM address, hex, case-insensitive.
The sender of the router swap (the wallet that called the router).
Query Parameters
Section titled “Query Parameters”Window in days of 24 h, ending now.
Responses
Section titled “ Responses ”object
EVM address, hex, case-insensitive.
Unix seconds: the start of the window.
Swaps through the router in the window.
USD of the priced swaps.
object
Valued by a dollar-stable leg.
Valued by the chain coin’s leg at today’s price.
Swaps with neither leg: counted in swaps, worth $0 here.
Unix seconds of the latest swap.
Largest volume first.
object
Example
{ "wallet": "0x0f1171209dad379af0e486f2c77d275d6e0a4f79", "days": 30, "since": 1789587369, "swaps": 297, "volumeUsd": 974.44, "pricedBy": { "stable": 279, "coin": 18 }, "unpriced": 0, "lastSwapAt": 1792094831, "byChain": [ { "chain": 1, "key": "ethereum", "swaps": 58, "volumeUsd": 284.1 }, { "chain": 42161, "key": "arbitrum", "swaps": 51, "volumeUsd": 156.87 }, { "chain": 56, "key": "bnb", "swaps": 40, "volumeUsd": 144.68 }, { "chain": 4663, "key": "robinhood", "swaps": 15, "volumeUsd": 104.93 }, { "chain": 8453, "key": "base", "swaps": 30, "volumeUsd": 100.98 }, { "chain": 143, "key": "monad", "swaps": 23, "volumeUsd": 65.9 }, { "chain": 43114, "key": "avalanche", "swaps": 53, "volumeUsd": 63.45 }, { "chain": 5042, "key": "arc", "swaps": 27, "volumeUsd": 53.52 } ]}Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}Over the per-minute limit (RATE_LIMIT_EXCEEDED). Read X-RateLimit-Reset and back off.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}