Skip to main content
GET
/
gateway
/
v1
/
wallet
/
transfers
Wallet Transfer History
curl --request GET \
  --url https://api.ask.surf/gateway/v1/wallet/transfers
{
  "data": [
    {
      "amount": "<string>",
      "from_address": "<string>",
      "timestamp": 123,
      "to_address": "<string>",
      "tx_hash": "<string>",
      "activity_type": "<string>",
      "amount_usd": 123,
      "flow": "<string>",
      "token_address": "<string>",
      "token_symbol": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

address
string
required

Wallet address — must be a raw address (0x-prefixed hex for EVM, base58 for Solana). ENS names like vitalik.eth are not supported; resolve to a 0x address first.

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

chain
enum<string>
default:ethereum

Chain. Can be ethereum, base, or solana.

Available options:
ethereum,
base,
solana
Example:

"ethereum"

flow
enum<string>

Filter by transfer direction relative to the queried wallet. in for incoming, out for outgoing. Omit for both directions.

Available options:
in,
out
Example:

"in"

token
string

Filter by token contract address. Use 0x0000000000000000000000000000000000000000 for native token transfers. Omit for all tokens.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

limit
integer<int64>
default:20

Results per page

Required range: 1 <= x <= 100
Example:

20

offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseWalletTransferItem.json"