A wallet's swaps

GET

/chains/solana/wallet/{address}/trades

const url = 'https://api.getchord.xyz/v1/chains/solana/wallet/example/trades?limit=50';
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/chains/solana/wallet/example/trades?limit=50'

The 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 from now).

Chord’s own Solana tape, read-only. No key needed.

What it reads. The swap events of 11 venues: PumpSwap, the pump.fun bonding curve, Meteora DBC, Meteora DAMM v2, Meteora DLMM, Meteora pools (dynamic AMM v1), Raydium CLMM, Raydium CPMM, Raydium AMM v4, Raydium LaunchLab and Orca Whirlpool. Each swap is checked against the pool vaults’ balance changes in the same transaction.
What it does not read. Prop AMMs (SolFi, HumidiFi and the like) and order books. SOL/USDC and other major pairs therefore show far less volume than the whole market; the numbers are accurate for pump.fun, Meteora and Raydium style tokens. Transfers are not seen either: wallet PnL is average cost inside the window.
History. Live since 2026-10-03 12:01 UTC, plus a backfill of the days before. coverageSince on /chains/solana/overview says from when totals are complete: quote that field, not a date.
Addresses are base58 and case-sensitive. Never lower-case a mint or a wallet: a lower-cased mint is a different string, refused with 400 BAD_ADDRESS when it stops being base58 (an L becomes l) and answered 404 TOKEN_NOT_FOUND otherwise. Solana has no numeric chain id here: the path segment is the literal solana.
Units. Token amounts are whole tokens (decimals already applied), quoteAmount is whole units of the pool’s quote (SOL, USDC, USDT or the other token), prices and *Usd fields are US dollars. Timestamps, updatedAt included, are Unix seconds.
Names are untrusted. symbol, name and image are whatever the token’s creator wrote; many mints share a symbol and there are no wash or impostor flags. Identify a token by its mint.
Errors. 400 BAD_* for a bad parameter; 400 UNSUPPORTED_CHAIN if Solana is not public on the deployment and the request has no X-API-Key; 503 CHAIN_DATA_UNAVAILABLE when the Solana store cannot be read in time and 503 CHAIN_NOT_ENABLED when the lane is off: retry later, never read either as “no trades”.

Parameters

Path Parameters

address

required

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

string

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

Wallet address, base58, exactly as it appears on-chain.

Query Parameters

limit

integer

default: 50 >= 1 <= 200

Newest rows.

before

integer

<= 4000000000

Exclusive cursor, Unix seconds: rows strictly older than it. Pass the last row’s ts for the next page. Several swaps can share a second, so a page boundary can skip the rest of that second: overlap with ts + 1 and drop rows whose tx you already have.

Responses

200

application/json

object

chain

string

Allowed value: solana

wallet

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

string

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

trades

Array<object>

object

Unix time, seconds, UTC.

integer

slot

integer

side

string

Allowed values: buy sell

token

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

string

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

symbol

string | null

name

string | null

tokenAmount

Whole tokens.

number

quoteAmount

Whole units of the pool’s quote.

number

usd

number | null

priceUsd

number | null

dex

Venue id: pumpswap · pumpfun (bonding curve) · meteora_dbc · meteora_damm_v2 · meteora_dlmm · meteora_pools (dynamic AMM v1) · raydium_clmm · raydium_cpmm · raydium_v4 · raydium_launchlab · orca (Whirlpool).

string

pool

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

string | null

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

Transaction signature, base58.

string

/^[1-9A-HJ-NP-Za-km-z]{64,88}$/

updatedAt

Unix time, SECONDS, when the Solana box built this answer. Unlike the rest of the API (milliseconds).

integer

Example

{
  "chain": "solana",
  "wallet": "3QZv9xcDELwLqB8SggDJHfVhMTn5YhKtXMCaKUucutm3",
  "trades": [
    {
      "ts": 1791151147,
      "slot": 453384173,
      "side": "buy",
      "token": "7VertkgF9KLhxxJXHX6uaWuoYZTP9LdGj2bWmVXVpump",
      "symbol": "Agency",
      "name": "Agency",
      "tokenAmount": 2879.134063,
      "quoteAmount": 0.295798607,
      "usd": 35.812234413351845,
      "priceUsd": 0.012401339509037218,
      "dex": "pumpswap",
      "pool": "CyJwKnLiiY4fmiwqMCSWFSHxo7T9Ubshgs2uRAuJCrk5",
      "tx": "Vz2VPQCo2j82g6mowse5961MnUEM6koE7VSaVhtVHQKsvkCHZ9HGVMTgbw92vDSJw1ThSDiVGkwn16EucjAK6Ny"
    },
    {
      "ts": 1791141717,
      "slot": 453349000,
      "side": "buy",
      "token": "DoVAVzViX8Bjy3r15nwikSaSbzE6dV4ovd28aWpJpump",
      "symbol": "HIGGS",
      "name": "Higgspad",
      "tokenAmount": 2231.366315,
      "quoteAmount": 0.040323739,
      "usd": 4.90003471839652,
      "priceUsd": 0.0021763918544292736,
      "dex": "pumpswap",
      "pool": "BFrSZakeqNzVtM3EFhroo4eRhagmmWN8BRntiQKFH6Ru",
      "tx": "5yzFpQRh11MNX9dVWZsNGkHN4nD1XW7KQqWXD931tsYnc2rYggjaNkzZ4bCvddXoEama9pz1hqo2DH1f8i9UBVTr"
    }
  ],
  "updatedAt": 1791166571
}

400

BAD_ADDRESS / BAD_LIMIT / BAD_CURSOR, or UNSUPPORTED_CHAIN (Solana is not public on this deployment and the request has no X-API-Key).

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

429

Over the per-minute limit (RATE_LIMIT_EXCEEDED). Read X-RateLimit-Reset and back off.

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

503

CHAIN_DATA_UNAVAILABLE (the Solana store did not answer in time) or CHAIN_NOT_ENABLED (the lane is off on this deployment). Retry later; do not treat it as an empty answer.

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