# Get transfers

Retrieves a list of transfers based on various query filters.

Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

Filter parameters:
- base: Filter by specific entity or address. For example, "0x123abc" or "binance".
- chains: Specify a comma-separated list of chains (e.g. "ethereum,bsc").
- flow: Direction of the transfer. Valid values are "in" (incoming), "out" (outgoing), "self" (self-transfers), or "all".
- from: Comma-separated list of addresses, entities, or deposit services for the 'from' side of a transfer. You can also use special syntax like "type:cex" to filter on entity types or "deposit:binance" to filter on deposit addresses.
- to: Comma-separated list of addresses, entities, or deposit services for the 'to' side.
- tokens: Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".
- counterparties: Comma-separated list of addresses or entities to treat strictly as counterparties (only base  counterparty transfers).
- timeLast: Filter transfers from a recent duration. For example, "24h" returns transfers from the last 24 hours.
- timeGte/timeLte: Filter from/to a specific timestamp in milliseconds.
- valueGte/valueLte: Numeric filters on the raw token amount (on-chain units).
- usdGte/usdLte: Numeric filters on the historical USD value of the transfer.
- sortKey: Field by which to sort the results. Options include "time", "value", or "usd".
- sortDir: Sorting direction. Use "asc" for ascending or "desc" for descending.
- limit: Maximum number of results to return (default is 50).
- offset: Pagination offset (default is 0).

Endpoint: GET /transfers
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `base` (string)
    Filter by specific entity or address. For example: "0x123abc" or "binance".

  - `chains` (string)
    Comma-separated list of chains. For example: "ethereum,bsc".

  - `flow` (string)
    Transfer direction: "in" for incoming, "out" for outgoing, "self" for self-transfers, or "all" for all transfers.
    Enum: "in", "out", "self", "all"

  - `from` (string)
    Comma-separated list of addresses, entities, or deposit services for the 'from' side. You can also use special syntax like "type:cex" to filter on entity types or "deposit:binance" to filter on deposit addresses.

  - `to` (string)
    Comma-separated list of addresses, entities, or deposit services for the 'to' side.

  - `tokens` (string)
    Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".

  - `counterparties` (string)
    Comma-separated list of addresses or entities to treat strictly as counterparties (only base  counterparty transfers).

  - `timeLast` (string)
    Time range filter using relative durations. For example: "24h" for transfers in the last 24 hours, "7d" for last 7 days.

  - `timeGte` (string)
    Time range filter (from) in milliseconds (e.g. 1696630274000).

  - `timeLte` (string)
    Time range filter (to) in milliseconds (e.g. 1696716674000).

  - `valueGte` (number)
    Minimum raw token value (on-chain units).

  - `valueLte` (number)
    Maximum raw token value (on-chain units).

  - `usdGte` (number)
    Minimum historical USD value.

  - `usdLte` (number)
    Maximum historical USD value.

  - `sortKey` (string)
    Enum: "time", "value", "usd"

  - `sortDir` (string)
    Enum: "asc", "desc"

  - `limit` (integer)
    Maximum number of results to return.

  - `offset` (integer)
    Pagination offset.

## Response 200 fields (application/json):

  - `transfers` (array)

  - `transfers.id` (string)
    Unique identifier (transaction hash + log index)
    Example: "0xded143b3e5dd3c9f6987783d0f0f2af1cec746553113a015a23f1213038b3972"

  - `transfers.transactionHash` (string)
    Example: "0xded143b3e5dd3c9f6987783d0f0f2af1cec746553113a015a23f1213038b3972"

  - `transfers.fromAddress` (object)
    Blockchain address intelligence object

  - `transfers.fromAddress.address` (string)
    The raw address (hex for EVM chains, base58 for Bitcoin, etc.)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `transfers.fromAddress.chain` (string)
    Enum: "ethereum", "polygon", "bsc", "optimism", "avalanche", "arbitrum_one", "bitcoin", "tron", "base", "flare", "linea", "manta", "blast", "ton", "solana", "mantle", "dogecoin", "sonic"

  - `transfers.fromAddress.depositServiceID` (string,null)

  - `transfers.fromAddress.arkhamEntity` (object,null)

  - `transfers.fromAddress.arkhamEntity.name` (string,null)
    Example: "Vitalik Buterin"

  - `transfers.fromAddress.arkhamEntity.note` (string,null)

  - `transfers.fromAddress.arkhamEntity.id` (string,null)
    Example: "vitalik-buterin"

  - `transfers.fromAddress.arkhamEntity.type` (string,null)
    Example: "individual"

  - `transfers.fromAddress.arkhamEntity.service` (string,null)

  - `transfers.fromAddress.arkhamEntity.addresses` (string,null)

  - `transfers.fromAddress.arkhamEntity.website` (string,null)

  - `transfers.fromAddress.arkhamEntity.twitter` (string,null)
    Example: "https://twitter.com/VitalikButerin"

  - `transfers.fromAddress.arkhamEntity.crunchbase` (string,null)
    Example: "https://www.crunchbase.com/person/vitalik-buterin"

  - `transfers.fromAddress.arkhamEntity.linkedin` (string,null)
    Example: "https://www.linkedin.com/in/vitalik-buterin-267a7450"

  - `transfers.fromAddress.arkhamLabel` (object,null)

  - `transfers.fromAddress.arkhamLabel.address` (string,null)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `transfers.fromAddress.arkhamLabel.chainType` (string)
    Enum: "evm", "bitcoin", "tron", "ton", "solana", "dogecoin"

  - `transfers.fromAddress.isUserAddress` (boolean,null)

  - `transfers.fromAddress.contract` (boolean,null)

  - `transfers.toAddress` (object)
    Blockchain address intelligence object

  - `transfers.tokenAddress` (string,null)

  - `transfers.type` (string)
    external, internal, or token

  - `transfers.blockTimestamp` (string)
    Example: "2025-06-04T09:07:47Z"

  - `transfers.blockNumber` (integer,null)
    Example: 22630280

  - `transfers.blockHash` (string,null)
    Example: "0xb73b329bad7428bdace6623dcd18743fca05b136116c261b63224176d831d997"

  - `transfers.tokenName` (string,null)
    Example: "Ethereum"

  - `transfers.tokenSymbol` (string,null)
    Example: "ETH"

  - `transfers.tokenDecimals` (integer,null)
    Example: 18

  - `transfers.unitValue` (number,null)
    Example: 259.6

  - `transfers.tokenId` (string,null)
    Example: "ethereum"

  - `transfers.historicalUSD` (number,null)
    Example: 685673.692

  - `count` (integer)
    Example: 10

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"