curl -X POST 'https://api.serialized.xyz/v1/wallet/watchlist/app-holders/add' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"wallets":[{"address":"Hasda78TSaT9bjiPxDBvP4GpohFpP3TDTaJEcCYK5kyN","chain":"solana"},{"address":"0x4f2ba0f7f3b8ae1d0cc0fc4b4f04d03cbd1c3d6e","chain":"evm:8453"}]}'
{
"data": {
"id": "app-holders",
"version": 4181,
"wallets": 3,
"added": 1,
"alreadyIn": 1,
"rejected": []
}
}
Watchlists
Add Wallets to a Watchlist
Add up to 10,000 wallets to a watchlist, idempotent. Free.
POST
/
v1
/
wallet
/
watchlist
/
{id}
/
add
curl -X POST 'https://api.serialized.xyz/v1/wallet/watchlist/app-holders/add' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"wallets":[{"address":"Hasda78TSaT9bjiPxDBvP4GpohFpP3TDTaJEcCYK5kyN","chain":"solana"},{"address":"0x4f2ba0f7f3b8ae1d0cc0fc4b4f04d03cbd1c3d6e","chain":"evm:8453"}]}'
{
"data": {
"id": "app-holders",
"version": 4181,
"wallets": 3,
"added": 1,
"alreadyIn": 1,
"rejected": []
}
}
POST /v1/wallet/watchlist/{id}/add · Free
Adds up to 10,000 wallets to a watchlist. Idempotent: a wallet already in the list counts in alreadyIn and changes nothing; version only moves when something changed. Free.
curl -X POST 'https://api.serialized.xyz/v1/wallet/watchlist/app-holders/add' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"wallets":[{"address":"Hasda78TSaT9bjiPxDBvP4GpohFpP3TDTaJEcCYK5kyN","chain":"solana"},{"address":"0x4f2ba0f7f3b8ae1d0cc0fc4b4f04d03cbd1c3d6e","chain":"evm:8453"}]}'
{
"data": {
"id": "app-holders",
"version": 4181,
"wallets": 3,
"added": 1,
"alreadyIn": 1,
"rejected": []
}
}
Authorizations
Your raw API key (not needed on the demo server).
Path Parameters
The watchlist id: yours, or the wl_… id we generated.
Body
application/json
1 to 10,000 wallets per call: { "address": "…", "chain": "…" } (one chain: solana or evm:<id>) or { "address": "…", "chains": "evm" } (every EVM chain, counted as one wallet). Same rules as the wallet and chains parameters of the wallet streams. An address is on every EVM chain or on named EVM chains, never both: an entry that would put it on both is returned in rejected (INVALID_PARAM). An invalid entry is returned in rejected with its index; the others are applied.
Response
200
Standard { data, meta } envelope.