Wallet Transfer History by Address (Tokens & Native)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "flow": {
      "enum": [
        "in",
        "out"
      ],
      "type": "string",
      "description": "Filter by transfer direction relative to the queried wallet. in for incoming, out for outgoing. Omit for both directions. Example: in."
    },
    "chain": {
      "enum": [
        "ethereum",
        "base",
        "solana",
        "tron",
        "bsc",
        "arbitrum"
      ],
      "type": "string",
      "default": "ethereum",
      "description": "Chain. Can be ethereum, base, solana, tron, bsc, or arbitrum. Example: ethereum. Defaults to \"ethereum\"."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Default 20, max 100. NOTE: Solana (chain=solana) is hard-capped at 40 per call by the upstream Solscan API — values above 40 return at most 40 items. Check meta.has_more and paginate with offset to fetch beyond the first page. Example: 20. Defaults to 20."
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "description": "Filter by token contract address. Use 0x0000000000000000000000000000000000000000 for native token transfers. Omit for all tokens. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. For Solana, this maps to Solscan's 1-indexed page parameter (page = offset/page_size + 1). Example: 0. Defaults to 0."
    },
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "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."
    },
    "include": {
      "type": "string",
      "minLength": 1,
      "description": "Comma-separated enrichments to attach to each transfer. Currently valid: labels — adds from_label and to_label fields with entity information for each counterparty address. Example: labels."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "flow": {
            "enum": [
              "in",
              "out"
            ],
            "type": "string",
            "description": "Direction relative to the queried wallet. Only 'in' observed so far."
          },
          "amount": {
            "type": "string",
            "description": "Transfer amount as a decimal string. NOT consistently normalized: some entries are raw base-unit integers with no decimal point (observed on native ETH and on some ERC-20 entries, e.g. '3944975481977', '1000000') while others already carry a decimal point in human token units (observed on empty-unused-wallet.json's SHIB entries, e.g. '167486.69080788'). Neither fixture includes a token 'decimals' field, so an integer-string amount cannot be reliably converted to a human quantity without knowing that token's decimals from elsewhere."
          },
          "tx_hash": {
            "type": "string",
            "description": "The on-chain transaction hash."
          },
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds."
          },
          "amount_usd": {
            "type": "number",
            "description": "USD value of the transfer at time of transfer. Present on some entries of empty-unused-wallet.json (its own first entry lacks it) and absent from every entry of vitalik-eth-mixed.json -- do not assume this field is always present."
          },
          "to_address": {
            "type": "string",
            "description": "Recipient's address."
          },
          "from_address": {
            "type": "string",
            "description": "Sender's address. Observed as the all-zero address on several entries -- that marks a token mint (created supply, no prior holder), not an actual sender."
          },
          "token_symbol": {
            "type": "string",
            "description": "Ticker symbol, e.g. 'ETH', 'SHIB'. Present on native-coin transfers and on some ERC-20 entries but absent on others in the SAME fixture (vitalik-eth-mixed.json's first two entries have no token_symbol at all) -- do not assume every entry names its token."
          },
          "token_address": {
            "type": "string",
            "description": "The token contract address, or the all-zero address (0x0000000000000000000000000000000000000000) for a native-coin transfer (ETH), observed on both fixtures."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per transfer, most recent first on both fixtures observed."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer",
          "description": "Echoes the requested (or defaulted) limit."
        },
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        },
        "offset": {
          "type": "integer",
          "description": "Echoes the requested (or defaulted) offset."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The transfer list, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}