Wallets API
How active a wallet has been on one chain
A wallet's first and last transaction on one chain, plus activity counts: transactions, token transfers, NFT transfers, NFTs and collections held. BNB, ETH, BASE.
GET
/api/external/wallet-analysis/wallet-stats/{chain}/{address}Chains
- BNB Chain BNB
- Ethereum ETH
- Base BASE
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/wallet-analysis/wallet-stats/BNB/<address>"
| Parameter | Description |
|---|---|
chainpath · string · required | The chain the wallet address belongs to. ETH, BNB and BASE are served; SOL, STABLE, RHC and ARC return 400. CELO, ARB, OP and SCROLL return 400 here. |
addresspath · string · required | The wallet address. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
firstTransactionAt | object | null | This chain's earliest transaction the source has indexed for this wallet, or null when the source has nothing — confirmed live as a real null on a never-used address, not merely an unreported field. |
firstTransactionAt.blockNumber | string | |
firstTransactionAt.timestamp | string | ISO-8601 UTC. |
firstTransactionAt.txHash | string | |
lastTransactionAt | object | null | This chain's most recent transaction the source has indexed for this wallet, or null. |
lastTransactionAt.blockNumber | string | |
lastTransactionAt.timestamp | string | ISO-8601 UTC. |
lastTransactionAt.txHash | string | |
transactionCount | integer | null | Total transaction count on this chain, or null when not reported. A real 0 is possible and distinct from null — confirmed live against a never-used address. |
tokenTransferCount | integer | null | Total ERC-20/BEP-20 token-transfer count on this chain, or null. A real 0 is possible. |
nftTransferCount | integer | null | Total NFT-transfer count on this chain, or null. A real 0 is possible. |
nftCount | integer | null | How many distinct NFTs this wallet currently holds on this chain, or null. |
collectionCount | integer | null | How many distinct NFT collections this wallet currently holds from, on this chain, or null. |
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