curl -X POST 'https://api.serialized.xyz/v1/wallet/swaps' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"wallet":"0x41f26df3bebc317cc07b43cfd6950e9e1d5bc4d4","chain":"evm:8453"},{"wallet":"4YFpz3g8AJ11fxxi8w4EUmGDa83scByRaMoM3hqNMPBr","chain":"solana"}],"limit":1,"to":1791057737000}'
{
"data": [
{
"data": [
{
"id": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"at": 1791057737000,
"chain": "evm:8453",
"txHash": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"block": 52134195,
"sent": [
{
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 125.139974
}
],
"received": [
{
"tokenAddress": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"name": "Native Token",
"decimals": 18,
"amount": 0.04658273783960646
}
],
"volumeNative": 0.04658273783960646,
"volumeUsd": 125.12006926873696,
"feesNative": null,
"route": [
{
"poolAddress": "0xaf15cd1f9c3874bbcfddfc2b544544612c9de8c8bae28ba21c129c6b286c1e19",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 73.292855
},
"received": {
"tokenAddress": "0x0000000000000000000000000000000000000000",
"amount": 0.027281798642902547
}
},
{
"poolAddress": "0x2f9175276740364e50932fc6932e329f014fce73ee03d2c5780cc491e3ac939d",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 51.847119
},
"received": {
"tokenAddress": "0x4200000000000000000000000000000000000006",
"amount": 0.019300939196703913
}
}
]
}
],
"hasMore": true,
"nextCursor": "MTc5MTA1NzczN3w1MjEzNDE5NXw0MTB8MHgzODliN2QyNzg4MTNlOGEzNTQ0YWY5Mzg4ZGZjZmFhMWZlY2EwNGQwZGQyNjYzNGNiZWI0NmVjNzIzMzgxZjE0",
"oldestAt": 1791057737000
},
{
"data": [
{
"id": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"at": 1791056268000,
"chain": "solana",
"txHash": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"block": 453029751,
"sent": [
{
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"symbol": "USELESS",
"name": "USELESS COIN",
"decimals": 6,
"amount": 14.550249
}
],
"received": [
{
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 3.422499
}
],
"volumeNative": 0.02859042,
"volumeUsd": 3.422363300972725,
"feesNative": 0.000382217,
"route": [
{
"poolAddress": "Q2sPHPdUWFMg7M7wwrQKLrn619cAucfRsmhVJffodSp",
"poolType": "RAYDIUM_CPMM",
"sent": {
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"amount": 14.550249
},
"received": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
},
{
"poolAddress": "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
"poolType": "BISONFI",
"sent": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"received": {
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 3.422499
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"hasMore": true,
"usdBasis": "trade",
"nextCursor": "MTc5MTA1NjI2OHwzSnUzUk5rZTg5RzFUQUhzMllueGpxcXZQWGRnZFdYMW1ydVZzb1lnZTd2Y2F2UFM4NGljSjFoZFNwUnN2ZENickQ5VndwbzlYNHkzRlJVek5LaHBkamV1",
"oldestAt": 1791056268000
}
],
"meta": {
"asOf": 1791064128697
}
}
Wallet Trades
Wallet Swaps: batch
Batch twin: up to 20 wallets per call, EVM and Solana mixed freely, response array in input order. Each slot is { data, hasMore, nextCursor, oldestAt, usdBasis }, the body of the single GET for that wallet, or { error } when that wallet failed, so one wallet never fails the others. Every item names its chain (the swap history is per chain) and may carry its own cursor: each wallet paginates independently with the nextCursor of its slot. limit, from, to, beforeAt and fromAt apply to every wallet of the call. Billed per wallet.
POST
/
v1
/
wallet
/
swaps
curl -X POST 'https://api.serialized.xyz/v1/wallet/swaps' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"wallet":"0x41f26df3bebc317cc07b43cfd6950e9e1d5bc4d4","chain":"evm:8453"},{"wallet":"4YFpz3g8AJ11fxxi8w4EUmGDa83scByRaMoM3hqNMPBr","chain":"solana"}],"limit":1,"to":1791057737000}'
{
"data": [
{
"data": [
{
"id": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"at": 1791057737000,
"chain": "evm:8453",
"txHash": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"block": 52134195,
"sent": [
{
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 125.139974
}
],
"received": [
{
"tokenAddress": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"name": "Native Token",
"decimals": 18,
"amount": 0.04658273783960646
}
],
"volumeNative": 0.04658273783960646,
"volumeUsd": 125.12006926873696,
"feesNative": null,
"route": [
{
"poolAddress": "0xaf15cd1f9c3874bbcfddfc2b544544612c9de8c8bae28ba21c129c6b286c1e19",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 73.292855
},
"received": {
"tokenAddress": "0x0000000000000000000000000000000000000000",
"amount": 0.027281798642902547
}
},
{
"poolAddress": "0x2f9175276740364e50932fc6932e329f014fce73ee03d2c5780cc491e3ac939d",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 51.847119
},
"received": {
"tokenAddress": "0x4200000000000000000000000000000000000006",
"amount": 0.019300939196703913
}
}
]
}
],
"hasMore": true,
"nextCursor": "MTc5MTA1NzczN3w1MjEzNDE5NXw0MTB8MHgzODliN2QyNzg4MTNlOGEzNTQ0YWY5Mzg4ZGZjZmFhMWZlY2EwNGQwZGQyNjYzNGNiZWI0NmVjNzIzMzgxZjE0",
"oldestAt": 1791057737000
},
{
"data": [
{
"id": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"at": 1791056268000,
"chain": "solana",
"txHash": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"block": 453029751,
"sent": [
{
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"symbol": "USELESS",
"name": "USELESS COIN",
"decimals": 6,
"amount": 14.550249
}
],
"received": [
{
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 3.422499
}
],
"volumeNative": 0.02859042,
"volumeUsd": 3.422363300972725,
"feesNative": 0.000382217,
"route": [
{
"poolAddress": "Q2sPHPdUWFMg7M7wwrQKLrn619cAucfRsmhVJffodSp",
"poolType": "RAYDIUM_CPMM",
"sent": {
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"amount": 14.550249
},
"received": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
},
{
"poolAddress": "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
"poolType": "BISONFI",
"sent": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"received": {
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 3.422499
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"hasMore": true,
"usdBasis": "trade",
"nextCursor": "MTc5MTA1NjI2OHwzSnUzUk5rZTg5RzFUQUhzMllueGpxcXZQWGRnZFdYMW1ydVZzb1lnZTd2Y2F2UFM4NGljSjFoZFNwUnN2ZENickQ5VndwbzlYNHkzRlJVek5LaHBkamV1",
"oldestAt": 1791056268000
}
],
"meta": {
"asOf": 1791064128697
}
}
POST /v1/wallet/swaps · 1 credit per wallet
Batch twin: up to 20 wallets per call, EVM and Solana mixed freely, response array in input order. Each slot is { data, hasMore, nextCursor, oldestAt, usdBasis }, the body of the single GET for that wallet, or { error } when that wallet failed, so one wallet never fails the others. Every item names its chain (the swap history is per chain) and may carry its own cursor: each wallet paginates independently with the nextCursor of its slot. limit, from, to, beforeAt and fromAt apply to every wallet of the call. Billed per wallet.
A slot’s
data, hasMore, nextCursor, oldestAt and usdBasis are exactly what GET /v1/wallet/swaps returns for that wallet with the same options; see that page for the row fields and the pagination contract (hasMore: false means the wallet’s history is fully served).Time window.
from and to (unix milliseconds, both inclusive) are shared by every wallet of the call; fromAt and beforeAt remain supported, one name per bound.curl -X POST 'https://api.serialized.xyz/v1/wallet/swaps' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"wallet":"0x41f26df3bebc317cc07b43cfd6950e9e1d5bc4d4","chain":"evm:8453"},{"wallet":"4YFpz3g8AJ11fxxi8w4EUmGDa83scByRaMoM3hqNMPBr","chain":"solana"}],"limit":1,"to":1791057737000}'
{
"data": [
{
"data": [
{
"id": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"at": 1791057737000,
"chain": "evm:8453",
"txHash": "0x389b7d278813e8a3544af9388dfcfaa1feca04d0dd26634cbeb46ec723381f14",
"block": 52134195,
"sent": [
{
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 125.139974
}
],
"received": [
{
"tokenAddress": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"name": "Native Token",
"decimals": 18,
"amount": 0.04658273783960646
}
],
"volumeNative": 0.04658273783960646,
"volumeUsd": 125.12006926873696,
"feesNative": null,
"route": [
{
"poolAddress": "0xaf15cd1f9c3874bbcfddfc2b544544612c9de8c8bae28ba21c129c6b286c1e19",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 73.292855
},
"received": {
"tokenAddress": "0x0000000000000000000000000000000000000000",
"amount": 0.027281798642902547
}
},
{
"poolAddress": "0x2f9175276740364e50932fc6932e329f014fce73ee03d2c5780cc491e3ac939d",
"poolType": "UNISWAP_V4",
"sent": {
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"amount": 51.847119
},
"received": {
"tokenAddress": "0x4200000000000000000000000000000000000006",
"amount": 0.019300939196703913
}
}
]
}
],
"hasMore": true,
"nextCursor": "MTc5MTA1NzczN3w1MjEzNDE5NXw0MTB8MHgzODliN2QyNzg4MTNlOGEzNTQ0YWY5Mzg4ZGZjZmFhMWZlY2EwNGQwZGQyNjYzNGNiZWI0NmVjNzIzMzgxZjE0",
"oldestAt": 1791057737000
},
{
"data": [
{
"id": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"at": 1791056268000,
"chain": "solana",
"txHash": "3Ju3RNke89G1TAHs2YnxjqqvPXdgdWX1mruVsoYge7vcavPS84icJ1hdSpRsvdCbrD9Vwpo9X4y3FRUzNKhpdjeu",
"block": 453029751,
"sent": [
{
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"symbol": "USELESS",
"name": "USELESS COIN",
"decimals": 6,
"amount": 14.550249
}
],
"received": [
{
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"amount": 3.422499
}
],
"volumeNative": 0.02859042,
"volumeUsd": 3.422363300972725,
"feesNative": 0.000382217,
"route": [
{
"poolAddress": "Q2sPHPdUWFMg7M7wwrQKLrn619cAucfRsmhVJffodSp",
"poolType": "RAYDIUM_CPMM",
"sent": {
"tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
"amount": 14.550249
},
"received": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
},
{
"poolAddress": "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
"poolType": "BISONFI",
"sent": {
"tokenAddress": "So11111111111111111111111111111111111111112",
"amount": 0.02859042
},
"received": {
"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": 3.422499
},
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"router": {
"programId": "DF1ow4tspfHX9JwWJsAb9epbkA8hmpSEAtxXy1V27QBH",
"name": "DFlow"
}
}
],
"hasMore": true,
"usdBasis": "trade",
"nextCursor": "MTc5MTA1NjI2OHwzSnUzUk5rZTg5RzFUQUhzMllueGpxcXZQWGRnZFdYMW1ydVZzb1lnZTd2Y2F2UFM4NGljSjFoZFNwUnN2ZENickQ5VndwbzlYNHkzRlJVek5LaHBkamV1",
"oldestAt": 1791056268000
}
],
"meta": {
"asOf": 1791064128697
}
}
Authorizations
Your raw API key (not needed on the demo server).
Body
application/json
[{ "wallet": "…", "chain": "…", "cursor": "…" }] - 1 to 20 wallets, EVM and Solana mixed freely; chain required; cursor optional, the nextCursor of that wallet's previous slot.
Required array length:
1 - 20 elementsShow child attributes
Show child attributes
Page size per wallet, 1-100. Default 50.
Required range:
1 <= x <= 100Example:
50
Inclusive lower time bound, unix MILLISECONDS. A value in seconds is rejected (400).
Required range:
x >= 0Inclusive upper time bound, unix MILLISECONDS. A value in seconds is rejected (400).
Required range:
x >= 0Same as the GET, applied to every wallet: upper bound in unix MILLISECONDS, swaps strictly older. Ignored for an item that carries a cursor.
Required range:
x >= 0Same as the GET, applied to every wallet: inclusive lower bound in unix MILLISECONDS.
Required range:
x >= 0Response
200
Standard { data, meta } envelope.