---
title: "Get Arkham detailed transfer histogram"
method: POST
path: "/transfers/histogram"
tags: ["Transfers"]
---

# Get Arkham detailed transfer histogram

`POST /transfers/histogram`

Get Arkham detailed transfer histogram. $0.80 per call.

## Request body

- object
  - `base` union — Filter from or to any of a comma-separated list of entities or addresses. Prefix a value with '!' to exclude it, or 'ty…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `chains` union — Chains to filter by, as a single comma-separated value (e.g. 'ethereum,bsc'). If omitted, returns transfers across all…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `counterparties` union — list of addresses or entities to treat strictly as counterparties (only base <-> counterparty transfers).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `flow` union — Transfer direction: 'in' (incoming), 'out' (outgoing), 'self' (self-transfers), or 'all'. Default: all.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `from` union — Filter from any of a comma-separated list of addresses, entities, or deposit services. Prefix a value with '!' to exclu…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `granularity` union, required — Histogram bucket size. Supported values: '1m' (minute), '1h' (hour), '1d' (day), '1w' (week), '1M' (month), '1q' (quart…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `timeGte` union — Filter after a specific time (RFC3339, YYYY-MM-DD, or Unix timestamp).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `timeLast` union — Filter using a duration string.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `timeLte` union — Filter before a specific time (RFC3339, YYYY-MM-DD, or Unix timestamp).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `to` union — Filter to any of a comma-separated list of addresses, entities, or deposit services. Prefix a value with '!' to exclude…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `tokens` union — Filter involving any of a comma separated list of token addresses or token IDs.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `usdGte` union — Filter above a minimum historical USD value.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `usdLte` union — Filter below a maximum historical USD value.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `valueGte` union — Filter above a minimum token amount (the quantity of tokens, not the USD value).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `valueLte` union — Filter below a maximum token amount (the quantity of tokens, not the USD value).
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean

## Response `200`

Successful response

- unknown[]
  - unknown

## Other responses

- `400` — Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled.
- `402` — Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once.
- `404` — The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled.
- `429` — Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 1 request per second.
- `5XX` — Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically.

---

[API](https://skmtc.net/arkm/apis/arkham-x402.md) · [All operations](https://skmtc.net/arkm/apis/arkham-x402/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkm/arkham-x402/revisions/7830c19a58c4/schema)