vike

Recipe 24 of 32

Wallet transfer history: in/out, min USD, one token

/wallets/{address}/transactions lists a wallet's individual transfers newest first, filtered by direction, days back, a USD floor and one token contract.

GET /v1/onchain/wallets/{address}/transactions returns single transfers, not totals: time, transaction hash, block, sender, recipient, token contract, USD value and the direction from the wallet's side. direction, days, min_usd and token_address narrow the list. The full parameter list is on Wallet transactions.

Quick answer

cURL
# Binance 14's outgoing USDT transfers of at least 100,000 USD over the last 7 days
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/transactions?direction=out&token_address=0xdac17f958d2ee523a2206206994597c13d831ec7&min_usd=100000&days=7&limit=3"

Example response

Captured from the live API on 2026-10-24 at 17:18 UTC, the whole response for limit=3.

The response is a bare array, newest first. usd is the transfer's value in USD at the time it happened, and time is UTC without a zone suffix. direction is out because the wallet is from_address on every row.

Example response
[
  {
    "time": "2026-10-24T16:38:35",
    "tx_hash": "0x58ef3301a4662535abcf8f5a978d807cf35f5153102de61144619a8a18e15b54",
    "usd": 590320.4,
    "block": 26263754,
    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "to_address": "0xd6a3c4a86c78d6b671f21aeefe16d8342777936e",
    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "direction": "out"
  },
  {
    "time": "2026-10-24T16:36:35",
    "tx_hash": "0xadd52eadb81f4b9abcb4a59989e18803bc64d3760d123cc6f1709c75c4213c5b",
    "usd": 108705.966352,
    "block": 26263744,
    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "to_address": "0x924ec2de1cc16e233b309fcc26d271ce2d177672",
    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "direction": "out"
  },
  {
    "time": "2026-10-24T16:32:47",
    "tx_hash": "0xeaec5d9ed72f85004f71d5790ce8689c7c5bb783d2248582b70429bb03731720",
    "usd": 110010.050217,
    "block": 26263725,
    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "to_address": "0x924ec2de1cc16e233b309fcc26d271ce2d177672",
    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "direction": "out"
  }
]

Variations

Both directions, every token. Drop the filters for the newest transfers of any kind.

cURL — everything
# the newest 100 transfers in either direction over the default 30 days
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/transactions?limit=100"

Inbound only. What arrived in the wallet over a week.

cURL — inbound
# incoming transfers over 7 days
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/transactions?direction=in&days=7&limit=100"

A year back. 365 days and 500 rows are the ceilings.

cURL — 365 days
# the newest 500 transfers within a year
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/transactions?days=365&limit=500"

Another chain. The same address on BNB Chain.

cURL — BNB Chain
# the wallet's transfers on BNB Chain
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/transactions?chain=bsc&limit=50"

Before you rely on it

USD only, no token amount

A row carries usd and token_address but no token quantity and no symbol. Resolve the symbol with /tokens/search, and treat usd: 0.0 as a transfer we could not price, not a worthless one.

min_usd also drops unpriced transfers

The floor is applied to usd, so any min_usd above 0 removes every unpriced row along with the small ones. Leave it out when you need the complete list.

500 rows, newest first, no cursor

limit is applied up to 500 and there is no next page. Rows older than the 500th are reachable only by narrowing with token_address, direction or min_usd.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The wallet_transactions tool answers it, at 2 credits a call.

Ask your agent
List Binance 14's outgoing USDT transfers over $100,000 in the last 7 days

Wallet portfolio now across chains, in USD, no dust

Recipe 23

Which of Ethereum, BNB Chain, Base and HyperEVM has this address been active on?

Recipe 25

Example response
[  {    "time": "2026-10-24T16:38:35",    "tx_hash": "0x58ef3301a4662535abcf8f5a978d807cf35f5153102de61144619a8a18e15b54",    "usd": 590320.4,    "block": 26263754,    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",    "to_address": "0xd6a3c4a86c78d6b671f21aeefe16d8342777936e",    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",    "direction": "out"  },  {    "time": "2026-10-24T16:36:35",    "tx_hash": "0xadd52eadb81f4b9abcb4a59989e18803bc64d3760d123cc6f1709c75c4213c5b",    "usd": 108705.966352,    "block": 26263744,    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",    "to_address": "0x924ec2de1cc16e233b309fcc26d271ce2d177672",    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",    "direction": "out"  },  {    "time": "2026-10-24T16:32:47",    "tx_hash": "0xeaec5d9ed72f85004f71d5790ce8689c7c5bb783d2248582b70429bb03731720",    "usd": 110010.050217,    "block": 26263725,    "from_address": "0x28c6c06298d514db089934071355e5743bf21d60",    "to_address": "0x924ec2de1cc16e233b309fcc26d271ce2d177672",    "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",    "direction": "out"  }]