curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2&cursor=MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"at": 1786998412000,
"chain": "evm:8453",
"txHash": "0x7c1f2a9b0e3d4c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f",
"direction": "in",
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"tokenSymbol": "USDC",
"amount": "250.5",
"amountUsd": 250.5,
"counterparty": "0xae695f8e2cf6bac920fc983ec0e43c77c471b366",
"spam": false
},
{
"at": 1786991244000,
"chain": "evm:8453",
"txHash": "0x3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"direction": "out",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenSymbol": "DEGEN",
"amount": "10000",
"amountUsd": 9.730412931559485,
"counterparty": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"spam": false
}
],
"meta": {
"asOf": 1787163134668,
"hasMore": true,
"nextCursor": "MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA",
"oldestAt": 1786991244000,
"historyFrom": 1779387135000
}
}
Wallet Transfers
Token in/out history of a wallet over the last 90 days, newest first: deposits, withdrawals, plain transfers - timestamp (ms), token, amount, direction, counterparty, tx hash. Paginate with the opaque cursor from meta.nextCursor: exact pagination that never skips or repeats a transfer. The reconciliation primitive next to /v1/wallet/trades.
curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2&cursor=MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"at": 1786998412000,
"chain": "evm:8453",
"txHash": "0x7c1f2a9b0e3d4c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f",
"direction": "in",
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"tokenSymbol": "USDC",
"amount": "250.5",
"amountUsd": 250.5,
"counterparty": "0xae695f8e2cf6bac920fc983ec0e43c77c471b366",
"spam": false
},
{
"at": 1786991244000,
"chain": "evm:8453",
"txHash": "0x3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"direction": "out",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenSymbol": "DEGEN",
"amount": "10000",
"amountUsd": 9.730412931559485,
"counterparty": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"spam": false
}
],
"meta": {
"asOf": 1787163134668,
"hasMore": true,
"nextCursor": "MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA",
"oldestAt": 1786991244000,
"historyFrom": 1779387135000
}
}
GET /v1/wallet/transfers · 1 credit
Token in/out history of a wallet over the last 90 days, newest first: deposits, withdrawals, plain transfers - timestamp (ms), token, amount, direction, counterparty, tx hash. Paginate with the opaque cursor from meta.nextCursor: exact pagination that never skips or repeats a transfer. The reconciliation primitive next to /v1/wallet/trades.
limit token movements of the wallet, newest first: a transaction that moved several tokens adds several rows, a transaction that only swapped adds none (swaps are on /v1/wallet/swaps). On Solana a transaction is never split across two pages, so a page can hold a few more or fewer than limit rows while meta.hasMore is true; with the spam filter on (the default) a page can hold fewer rows than limit, even none, while meta.hasMore is true. Keep passing meta.nextCursor until hasMore is false; cursors never skip or repeat a transfer, and hasMore: false means the wallet’s history is fully served. meta.nextCursor is present while meta.hasMore is true.excludeSpam=true) the transfers judged spam are left out of the page: a token outside our registry worth less than $0.05 at transfer time (the same floor /v1/wallet/positions applies by default) or with no market at all. On EVM chains, incoming and outgoing transfers are judged alike, and a transfer to a burn address is always served; on Solana, outgoing transfers are always served. Every token of our registry (stablecoins, the native coin and its wrapped form, known assets) is always served. Every row carries spam: true (judged spam, returned only with excludeSpam=false), false (judged and kept) or null (not judged: the USD value of that transfer could not be read at that moment, kept). Pass excludeSpam=false to receive every row and build your own toggle on spam.meta.historyFrom (unix ms) is the earliest instant covered, and a window that starts earlier is served from that instant. from and to bound the history in unix milliseconds, both inclusive; order is desc (newest first, default) or asc. They combine with cursor: keep the same from, to and order on every page of a walk. meta.oldestAt is the oldest timestamp of the page.direction is in or out; counterparty is the other side of the transfer (the zero address for a mint or a burn: 11111111111111111111111111111111 on Solana). Amounts are strings for precision, in token units; amountUsd is the USD value of the transfer (null for a token with no price).curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/wallet/transfers?chain=evm:8453&wallet=0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09&limit=2&cursor=MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"at": 1786998412000,
"chain": "evm:8453",
"txHash": "0x7c1f2a9b0e3d4c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f",
"direction": "in",
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"tokenSymbol": "USDC",
"amount": "250.5",
"amountUsd": 250.5,
"counterparty": "0xae695f8e2cf6bac920fc983ec0e43c77c471b366",
"spam": false
},
{
"at": 1786991244000,
"chain": "evm:8453",
"txHash": "0x3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b",
"direction": "out",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"tokenSymbol": "DEGEN",
"amount": "10000",
"amountUsd": 9.730412931559485,
"counterparty": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"spam": false
}
],
"meta": {
"asOf": 1787163134668,
"hasMore": true,
"nextCursor": "MTc4Njk5MTI0NHwweDNhNGI1YzZkN2U4ZjlhMGIxYzJkM2U0ZjVhNmI3YzhkOWUwZjFhMmIzYzRkNWU2ZjdhOGI5YzBkMWUyZjNhNGJ8MTJ8MA",
"oldestAt": 1786991244000,
"historyFrom": 1779387135000
}
}
Query Parameters
Leave out the transfers judged spam: a token outside our registry worth less than $0.05 at transfer time (the floor /v1/wallet/positions applies by default) or with no market at all. On EVM chains, incoming and outgoing transfers are judged alike (a token contract can record a transfer out of a wallet without the wallet's signature), and a transfer to a burn address is always served; on Solana, outgoing transfers are always served. Every token of our registry (stablecoins, the native coin and its wrapped form, known assets) is always served. Default true. With the filter on, a page can hold fewer rows than limit, even none, while meta.hasMore is true: keep paging. Pass false to receive every row.
Response
Standard { data, meta } envelope.