Wallet - Transfer total

curl --request POST \
  --url https://public-api.birdeye.so/wallet/v2/transfer/total \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "time_from": 1727788070,
  "time_to": 1727788076,
  "flow": "in",
  "from_amount": 10.01,
  "to_amount": 10.001,
  "from_value": 1.001,
  "to_value": 10000,
  "from_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
  "to_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"
}
'

import requests

url = "https://public-api.birdeye.so/wallet/v2/transfer/total"

payload = {
    "wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_from": 1727788070,
    "time_to": 1727788076,
    "flow": "in",
    "from_amount": 10.01,
    "to_amount": 10.001,
    "from_value": 1.001,
    "to_value": 10000,
    "from_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
    "to_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu',
    token_address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    time_from: 1727788070,
    time_to: 1727788076,
    flow: 'in',
    from_amount: 10.01,
    to_amount: 10.001,
    from_value: 1.001,
    to_value: 10000,
    from_wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu',
    to_wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu'
  })
};

fetch('https://public-api.birdeye.so/wallet/v2/transfer/total', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "total": 10
  }
}

{
  "success": false,
  "message": "Bad request"
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Access Denied"
}

{
  "success": false,
  "message": "Too many requests"
}

{
  "success": false,
  "message": "Internal Server Error"
}

POST

wallet

transfer

total

Wallet - Transfer total

curl --request POST \
  --url https://public-api.birdeye.so/wallet/v2/transfer/total \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "time_from": 1727788070,
  "time_to": 1727788076,
  "flow": "in",
  "from_amount": 10.01,
  "to_amount": 10.001,
  "from_value": 1.001,
  "to_value": 10000,
  "from_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
  "to_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"
}
'

import requests

url = "https://public-api.birdeye.so/wallet/v2/transfer/total"

payload = {
    "wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "time_from": 1727788070,
    "time_to": 1727788076,
    "flow": "in",
    "from_amount": 10.01,
    "to_amount": 10.001,
    "from_value": 1.001,
    "to_value": 10000,
    "from_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu",
    "to_wallet": "41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu',
    token_address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    time_from: 1727788070,
    time_to: 1727788076,
    flow: 'in',
    from_amount: 10.01,
    to_amount: 10.001,
    from_value: 1.001,
    to_value: 10000,
    from_wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu',
    to_wallet: '41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu'
  })
};

fetch('https://public-api.birdeye.so/wallet/v2/transfer/total', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "total": 10
  }
}

{
  "success": false,
  "message": "Bad request"
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Access Denied"
}

{
  "success": false,
  "message": "Too many requests"
}

{
  "success": false,
  "message": "Internal Server Error"
}

Usage Note
Accessibility
Chain Supported

Cheap transfer-count summary for one Solana wallet.

Solana transfer data is available from epoch 257 (2021-11-12).
Use the same wallet and transfer filters as the wallet-transfer list when you only need aggregate counts.
This endpoint returns totals, not the underlying transfer rows.

Compute Unit ⚙️

This endpoint consumes 1 CU per request.

Use Cases 💡

Count wallet transfers before pulling the full list.
Show transfer activity totals in wallet dashboards or summary cards.
Prefilter high-activity wallets before full forensic review.

How to Use 🛠️

Set x-chain=solana.
Send the wallet and any transfer filters in the POST body.
Use the returned count to decide whether you need the full wallet-transfer list.

Best Practices ✅

Use this endpoint as a cheap preflight before paginating transfer rows.
Keep the filter set identical to the transfer-list call if you plan to compare totals and rows.

Limitations ⚠️

Solana only.
Historical coverage starts from epoch 257 (2021-11-12).
Returns totals only, not transfer row details.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana network only.

Available options:

solana

Body

application/json

wallet

string

required

Address of the wallet to retrieve transfers for.

Example:

"41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"

token_address

string

Address of the token to filter transfers by.

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

flow

enum<string>

Transfer direction relative to the specified wallet. Use in for incoming transfers or out for outgoing transfers.

Available options:

in,

out

Example:

"in"

time_from

number

Start of the transfer time range as a Unix timestamp.

Example:

1727788070

time_to

number

End of the transfer time range as a Unix timestamp.

Example:

1727788076

from_amount

number

Minimum token amount to include.

Example:

10.01

to_amount

number

Maximum token amount to include.

Example:

10.001

from_value

number

Minimum transfer value in USD to include.

Example:

1.001

to_value

number

Maximum transfer value in USD to include.

Example:

10000

from_wallet

string

Address of the sender wallet to filter transfers by.

Example:

"41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"

to_wallet

string

Address of the recipient wallet to filter transfers by.

Example:

"41zCUJsKk6cMB94DDtm99qWmyMZfp4GkAhhuz4xTwePu"

Response

JSON object containing a total transfer

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes