Wallets API

The raw account records of many wallets

Native-currency balance, on EVM chains the nonce, and on Solana whether each is an ordinary account, a program or off-curve, for up to 50 addresses on one chain in one request. Every chain.

POST/api/external/wallet-analysis/wallet-account-batch/{chain}

What it returns

The wallet-account answer — native balance, on the EVM chains the nonce, on Solana the owner, program and curve flags — for many addresses on one chain in one request. Every chain. Each result is exactly what wallet-account answers for that address, with the same caveats on every field. POST, because the list is the subject: it can run past what a URL comfortably holds, and a body keeps a watch list out of every proxy log between the caller and this service.

Chains

  • Solana SOL
  • BNB Chain BNB
  • Ethereum ETH
  • Stable STABLE
  • Base BASE
  • Robinhood Chain RHC
  • Arc ARC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -X POST -H "x-dex-data-key: $DEXDATA_API_KEY" \
  -H "content-type: application/json" \
  -d '{"subjects":["<subjects>"]}' \
  "https://api.dexdata.io/api/external/wallet-analysis/wallet-account-batch/SOL"
Parameters
ParameterDescription
chain

path · string · required

The chain every address in the batch belongs to. CELO, ARB, OP and SCROLL return 400 here.
subjects

body · string[] · optional

Wallet addresses: base58 on SOL, 0x-prefixed on every other chain. Between 1 and 50, each sent once.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of The raw account records of many wallets
FieldTypeDescription
resultsobject[]One entry per requested subject, in the order they were sent.
results[].subjectstringThe subject exactly as it was sent.
results[].resultobject | nullWhat the single-subject endpoint answers for this subject. null only when error is set.
results[].result.nativeBalancenumber | nullDecimalized native-currency balance (SOL on Solana; the chain's own gas token on every other chain — USDC on ARC), or null when not reported.
results[].result.nonceinteger | nullEVM ONLY: the account's transaction count at the latest block — the transactions an ordinary wallet has sent, or for a contract the contracts it has created, counted from 1. Always null on SOL, which has no such counter; null on an EVM chain when not reported.
results[].result.ownerstring | nullSOL ONLY: the program that owns this account — the System Program for an ordinary wallet, the Token Program for a mint. On SOL, null when no account exists at the address or when not reported. Always null on the other chains: there is no equivalent concept there, not merely an unreported one.
results[].result.isProgramboolean | nullSOL ONLY: true when this address is itself an executable program rather than an ordinary wallet. On SOL, null when no account exists at the address or when not reported. Always null on the other chains.
results[].result.isOnCurveboolean | nullSOL ONLY: whether this address lies on the ed25519 curve. false marks a Program Derived Address — an account that by construction has no private key. Always null on the other chains.
results[].errorstring | nullnull, or unavailable when no source could be reached for this subject — retry it. A subject nobody has data for is NOT an error: its result says so.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key