Wallets API
Which transactions went between these two addresses?
The transactions a wallet sent to one counterparty, received from it, or both, newest first, found however many other transactions either side has.
/api/external/wallet-analysis/wallet-pair-transactions/{chain}/{address}What it returns
The normal transactions a wallet sent to one counterparty, received from it, or both, newest first, however busy either side is. A transaction is listed when one side sent it and the other is its direct recipient: a token transfer is listed under the token contract it called, not under the wallet it paid, and value moved inside another transaction is not listed. truncated says older transactions of the pair may exist beyond limit.
Chains
- BNB Chain BNB
- Ethereum ETH
- Stable STABLE
- 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-pair-transactions/BNB/<address>?counterparty=<counterparty>"
| Parameter | Description |
|---|---|
counterpartyquery · string · required | The other address: a wallet or a contract, 0x followed by 40 hexadecimal characters. |
directionquery · string · optional | sent: from the wallet to the counterparty. received: from the counterparty to the wallet. both: either way. Defaults to both.sentreceivedboth |
limitquery · integer · optional | How many transactions to return, newest first, 1 to 1000. Defaults to 100. limit ≤ 90 keeps the answer under 32 KB. |
chainpath · string · required | ETH, BNB, BASE or STABLE; every other chain returns 400. |
addresspath · string · required | The wallet, 0x followed by 40 hexadecimal characters. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
transactions | object[] | Newest first. Empty when the two addresses never transacted in the direction asked. |
transactions[].txHash | string | The transaction hash, lowercase. |
transactions[].block | integer | The block it was mined in. |
transactions[].at | integer | When its block was mined, Unix seconds. |
transactions[].from | string | The sender, lowercase. |
transactions[].to | string | The recipient, lowercase. |
transactions[].valueWei | string | The native coin the transaction carried, in wei, as a decimal string. "0" for a call that sent none. |
transactions[].isError | boolean | null | true when it reverted, false when it succeeded, null when not reported. |
transactions[].methodId | string | null | The 4-byte selector of the function it called, lowercase. null for a plain transfer with no calldata. |
transactions[].functionName | string | null | The called function's signature, e.g. transfer(address dst, uint256 amount). null when it is not known. |
truncated | boolean | true when a direction returned limit transactions, so older ones may exist. |
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