Skip to content

One wallet's swaps through Chord's router

GET
/agent/router/wallet/{address}
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.

address
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/

The sender of the router swap (the wallet that called the router).

days
integer
default: 30 >= 1 <= 90

Window in days of 24 h, ending now.

Media typeapplication/json
object
wallet

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
days
integer
since

Unix seconds: the start of the window.

integer
swaps

Swaps through the router in the window.

integer
volumeUsd

USD of the priced swaps.

number
pricedBy
object
stable

Valued by a dollar-stable leg.

integer
coin

Valued by the chain coin’s leg at today’s price.

integer
unpriced

Swaps with neither leg: counted in swaps, worth $0 here.

integer
lastSwapAt

Unix seconds of the latest swap.

integer | null
byChain

Largest volume first.

Array<object>
object
chain
integer
key
string
swaps
integer
volumeUsd
number
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, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
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.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
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.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
"error": "INVALID_PARAMS",
"message": "amount must be an integer string in the token's smallest unit"
}