Wallet activity API

GET/wallets/:chain/:address/activity

Every transaction of a wallet, newest first, with what it did: swaps, liquidity adds and removes, and transfers; on Solana complete, read from the chain.

Parameters

Name	In	Type	Default	Allowed values
`chain`	path	string	required	`evm:56` (BSC), `solana`, `evm:8453` (Base), `evm:4663` (Robinhood Chain) or `evm:1` (Ethereum)
`address`	path	string	required	Wallet address (BSC) or account (Solana)
`type`	query	string	all	`swap`, `liquidity` or `transfer`: only those actions
`limit`	query	integer	`50`	1–100 transactions
`cursor`	query	string	first page	The previous page's `next`: `time.block.txIndex` on BSC, a signature on Solana

Response

Field	Type	Meaning
`chain`, `wallet`, `labels`, `indexedSince`	string, string, string[], number	As in every wallet answer.
`covers`, `note`	string[], string	What is listed, and what is not, in words.
`transfersSince`	number \| null	BSC: from when transfers are listed, unix ms (kept 30 days).
`coverage`	{ listedAt, start, stopped }	Solana: when the wallet's transaction list was read, whether it reaches its first transaction, and where a read bound stopped.
`transactions[]`	array	Newest first: `tx`, `time`, `block`, `txIndex`, `actions`. Solana adds `failed`, `fee` (SOL the wallet paid; null when another paid) and `changes` (the wallet's exact balance change per token: `{ token, amount, amountRaw }`).
`actions[] (swap)`	object	`type: "swap"`, `eventIndex`, `protocol`, `pool`; `tokenIn` and `amountIn` (what the wallet paid), `tokenOut` and `amountOut` (what it received), `amountUsd`.
`actions[] (liquidity)`	object	`type: "liquidity"`, `kind` (`add`, `remove`), `eventIndex`, `protocol`, `pool`, `token0`, `amount0`, `token1`, `amount1`, `valueUsd`.
`actions[] (transfer)`	object	`type: "transfer"`, `eventIndex`, `direction` (`in`, `out`, `self`), `token`, `amount` (null for a token Aurelia never stored), `amountRaw`, `from`, `to` (null for a mint or a burn), `labels` (the counterparty's).
`next`	string \| null	Cursor for the next older page. `null` at the end.

Example

Captured 2026-09-28 18:03 UTC on a test instance, trimmed to 2 transactions.

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/wallets/evm:56/0x3304e22ddaa22bcdc5fca2269b418046ae7b566a/activity?limit=2'

{
  "chain": "evm:56",
  "wallet": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
  "labels": [
    "sniper",
    "fresh"
  ],
  "indexedSince": 1790546261920,
  "transfersSince": 1790546861000,
  "covers": [
    "swaps",
    "liquidity",
    "transfers"
  ],
  "note": "Swaps and liquidity events the index decoded, ERC-20 transfers and native transfers sent as a transaction's value (transfers kept 30 days: see transfersSince). Internal native transfers and gas are not indexed. A transfer of a token swapped or pooled in the same transaction is part of that action, and is not listed again.",
  "transactions": [
    {
      "tx": "0x2b170741f16da7ea4287bbd163e3365f89c73c4face2b6ed032487c0dd9b0cb4",
      "time": 1790618578665,
      "block": 1000750,
      "txIndex": 0,
      "actions": [
        {
          "type": "swap",
          "eventIndex": 4,
          "protocol": "pancakeswap-v2",
          "pool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
          "tokenIn": {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "symbol": "WBNB",
            "name": "Wrapped BNB",
            "decimals": 18
          },
          "amountIn": "0.5",
          "tokenOut": {
            "address": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777",
            "symbol": "TAX",
            "name": "Tax Token",
            "decimals": 18
          },
          "amountOut": "50000",
          "amountUsd": 300
        }
      ]
    },
    {
      "tx": "0xcd32103a902cba28b871741adf595a6b209ce0b66d6849cc8a603842adb07729",
      "time": 1790618554904,
      "block": 1000749,
      "txIndex": 0,
      "actions": [
        {
          "type": "swap",
          "eventIndex": 4,
          "protocol": "pancakeswap-v2",
          "pool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
          "tokenIn": {
            "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
            "symbol": "WBNB",
            "name": "Wrapped BNB",
            "decimals": 18
          },
          "amountIn": "0.5",
          "tokenOut": {
            "address": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777",
            "symbol": "TAX",
            "name": "Tax Token",
            "decimals": 18
          },
          "amountOut": "50000",
          "amountUsd": 300
        }
      ]
    }
  ],
  "next": "1790618554904.1000749.0"
}

Notes

BSC, from the index: swaps, liquidity events, every ERC-20 transfer and BNB sent as a transaction's value. Internal BNB transfers and gas are not indexed. A transfer of a token swapped or pooled in the same transaction is a leg of that action, and is not listed again. One database query a page.
Solana, from the chain: every transaction that names the wallet, with its exact balance changes; swaps and liquidity events from the index (with USD values) and the System Program and SPL Token transfers the node parsed. A token received by a transaction that does not name the wallet is not listed: Solana lists a transaction under the addresses it names. A request reads at most 40 transactions; 503 while the chain's read budget is spent, 502 when it cannot be read.
A page holds at most limit transactions, fewer when type leaves some without actions or a read bound stops it: follow next until it is null. Cached 5 s.

Try it in the interactive docs Create a free account