Skip to content

Swaps on every chain

GET
/portfolio/{wallet}/activity
curl --request GET \
--url 'https://api.getchord.xyz/v1/portfolio/example/activity?chains=all&limit=50'

The 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 received token, sell = it gave it.

Notes

  • Pass the page’s cursor back as cursor for the next page; cursor: null = nothing older. One transaction’s rows stay on one page, so a page can hold fewer than limit items.
  • A chain that could not be read for a page is listed in unavailable and keeps its place: the next page asks it again. items: [] with unavailable set is an outage, not an empty history.
  • How far back: Monad, Robinhood Chain and Arc, their raw tape (45 days); Avalanche, Base, BNB Chain, Arbitrum One and Ethereum, their raw tape and then, where Chord’s history lake holds older days, up to 5,000 older swaps; Solana, 45 days. EVM swaps under $0.10 are left out.
  • ts is in milliseconds.
  • Pages are not cached: without an API key (or an Ask session) each page counts against the budget it shares with GET /portfolio/{wallet} (10 new reads per IP every 10 minutes, a limited number a minute for every such caller together); past it 429 RATE_LIMITED or 503 BUSY with Retry-After.
wallet
required

EVM address, hex, case-insensitive.

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

Solana address, base58, case-sensitive. Never lower-case it.

string
/^[1-9A-HJ-NP-Za-km-z]{32,44}$/

The wallet’s Solana address. Adds Solana to the default scope.

chains
string
default: all

all = the eight EVM chains, plus Solana when sol is given. Or a comma list of chain ids (143, 4663, 5042, 43114, 8453, 56, 42161, 1) and solana (which needs sol). Answered in registry order, Solana last. This route does not read chain: chain=5042 on its own still answers for every chain, so send chains=5042 for Arc alone.

cursor
string

The cursor of the previous page.

limit
integer
default: 50 >= 1 <= 100

Items per page.

Media typeapplication/json
object
items
required

Newest first, every chain in scope merged.

Array<object>

One side of one swap.

object
ts

Unix time, milliseconds.

integer
chain

EVM chain id, or solana.

integer | string
side

buy = the wallet received token; sell = it gave it.

string
Allowed values: buy sell
token
object
address

EVM token, lower-case. Null on a Solana row.

string | null
mint

Solana only, case kept.

string
symbol
string
name
string | null
logo
string | null
amount

Whole tokens, decimal string.

string
valueUsd
number | null
priceUsd
number | null
tx

Transaction hash, or the Solana signature (case kept).

string
explorer

The transaction on the chain’s explorer.

string | null
venue

Venue display name.

string | null
cursor
required

Opaque. Pass it back for the next page; null = nothing older.

string | null
unavailable

Present only when a chain could not be read for this page.

Array<object>
object
chain

EVM chain id, or solana.

integer | string
reason
string
Example
{
"items": [
{
"side": "buy"
}
]
}

INVALID_ADDRESS, INVALID_SOL_ADDRESS, BAD_CHAINS, SOL_REQUIRED, BAD_LIMIT (1 to 100) or BAD_CURSOR (not a cursor of this route).

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

RATE_LIMITED: without an API key, this IP started its 10 new portfolio reads of the last 10 minutes, pages included (Retry-After). Or RATE_LIMIT_EXCEEDED, the per-minute limit of every route.

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

BUSY: too many new portfolio reads are running for callers without a key right now (Retry-After). UNAVAILABLE: the page itself could not be built (a chain that cannot be read is listed in unavailable inside a 200).

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