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.

GET/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>"
Parameters
ParameterDescription
counterparty

query · string · required

The other address: a wallet or a contract, 0x followed by 40 hexadecimal characters.
direction

query · string · optional

sent: from the wallet to the counterparty. received: from the counterparty to the wallet. both: either way. Defaults to both.sentreceivedboth
limit

query · integer · optional

How many transactions to return, newest first, 1 to 1000. Defaults to 100. limit ≤ 90 keeps the answer under 32 KB.
chain

path · string · required

ETH, BNB, BASE or STABLE; every other chain returns 400.
address

path · 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.

Response fields of Which transactions went between these two addresses?
FieldTypeDescription
transactionsobject[]Newest first. Empty when the two addresses never transacted in the direction asked.
transactions[].txHashstringThe transaction hash, lowercase.
transactions[].blockintegerThe block it was mined in.
transactions[].atintegerWhen its block was mined, Unix seconds.
transactions[].fromstringThe sender, lowercase.
transactions[].tostringThe recipient, lowercase.
transactions[].valueWeistringThe native coin the transaction carried, in wei, as a decimal string. "0" for a call that sent none.
transactions[].isErrorboolean | nulltrue when it reverted, false when it succeeded, null when not reported.
transactions[].methodIdstring | nullThe 4-byte selector of the function it called, lowercase. null for a plain transfer with no calldata.
transactions[].functionNamestring | nullThe called function's signature, e.g. transfer(address dst, uint256 amount). null when it is not known.
truncatedbooleantrue 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