Token Transfer History by Contract Address

{
  "type": "object",
  "required": [
    "address",
    "chain"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to today. Example: 2025-03-01."
    },
    "from": {
      "type": "string",
      "default": 30,
      "minLength": 1,
      "description": "Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to 30 days ago. Example: 2025-01-01."
    },
    "chain": {
      "enum": [
        "ethereum",
        "base",
        "solana",
        "tron",
        "bsc",
        "arbitrum"
      ],
      "type": "string",
      "description": "Chain. Can be ethereum, base, solana, tron, bsc, or arbitrum. Example: ethereum."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Example: 20. Defaults to 20."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. Example: 0. Defaults to 0."
    },
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "Token CONTRACT ADDRESS — 0x-prefixed hex for EVM chains, base58 for Solana. This is NOT a ticker symbol (e.g. do NOT pass USDC or BTC). To resolve a ticker symbol to a contract address, call GET /v1/search/token?q={symbol}&chain={chain} and use the address whose chain is supported by this endpoint. This endpoint has no symbol parameter. Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48."
    },
    "include": {
      "type": "string",
      "minLength": 1,
      "description": "Comma-separated enrichments to attach to each transfer. Currently valid: labels — adds from_label and to_label fields. Example: labels."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "string",
            "description": "The transferred amount in the token's own units, as a decimal string."
          },
          "symbol": {
            "type": "string",
            "description": "The token's ticker symbol, e.g. 'USDC'."
          },
          "tx_hash": {
            "type": "string",
            "description": "The on-chain transaction hash."
          },
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds when the transfer occurred."
          },
          "amount_usd": {
            "type": "number",
            "description": "The transferred amount's estimated USD value at the time of transfer."
          },
          "to_address": {
            "type": "string",
            "description": "The receiving wallet's on-chain address (public blockchain data)."
          },
          "block_number": {
            "type": "integer",
            "description": "The block the transfer was included in."
          },
          "from_address": {
            "type": "string",
            "description": "The sending wallet's on-chain address (public blockchain data)."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per transfer event, most recent first on the populated fixture. Observed as an empty array on the no-transfers fixture (a date range before the token existed on the requested chain)."
    },
    "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 response, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}