# Get a detailed histogram of transfers (API Only)

Returns an aggregated histogram of transfers over time (count and USD values) based on the same filter parameters used in /transfers.

⚠️ This endpoint requires API tier authentication (not just API key)

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

Additional parameter:
- granularity: "1h" or "1d" (if the range exceeds 30 days, "1h" is invalid).

Filter parameters (same as /transfers, minus pagination/sorting):
- 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", "out", "self", or "all".
- timeLast: Filter from a recent duration (e.g. "24h", "7d", "30d", etc.).
- timeGte/timeLte: Filter from/to a specific timestamp in milliseconds.
- valueGte/valueLte: Numeric filters on the raw token amount.
- usdGte/usdLte: Numeric filters on the historical USD value of the transfer.
- from: Comma-separated list of addresses, entities, or deposit services for the 'from' side.
- 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).

Endpoint: GET /transfers/histogram
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

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

  - `granularity` (string, required)
    Granularity of histogram buckets. Valid values: "1h" or "1d". For time ranges over 30 days, only "1d" is valid.
    Enum: "1h", "1d"

  - `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".
    Enum: "in", "out", "self", "all"

  - `timeLast` (string)
    Time range filter using relative durations. Examples: "24h", "7d", "30d".

  - `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.

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

  - `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).

## Response 200 fields (application/json):

  - `time` (string)
    Example: "2025-03-31T00:00:00Z"

  - `count` (integer)
    Example: 17

  - `usd` (number)
    Example: 983

## Response 400 fields (application/json):

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

## Response 401 fields (application/json):

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