--- title: "Get Arkham transfers with filters" method: POST path: "/transfers" tags: ["Transfers"] --- # Get Arkham transfers with filters `POST /transfers` Get Arkham transfers with filters. Priced per row: $0.40 × limit (default 20, max 1650); pass the smallest useful limit. ## 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 - `includeCursors` union — Include per-chain as-of cursors in the response. Default: false. - string - number - boolean - union[] - union - string - number - boolean - `limit` union — Maximum number of results to return. Default: 20. Max: 1650. - string - number - boolean - union[] - union - string - number - boolean - `offset` union — Pagination offset. Default: 0. offset + limit must not exceed 10000. - string - number - boolean - union[] - union - string - number - boolean - `seqGte` union — Return transfers at or after this chain sequence, as reported in cursors and on each returned transfer. Requires seqLte… - string - number - boolean - union[] - union - string - number - boolean - `seqLte` union — Return transfers at or before this chain sequence. Requires seqGte, and the range may span at most 10,000,000 sequences… - string - number - boolean - union[] - union - string - number - boolean - `sortDir` union — Direction for sorting results. Default: desc. - string - number - boolean - union[] - union - string - number - boolean - `sortKey` union — Field by which to sort the results. Default: time. Custom sorting requires authentication; anonymous requests are alway… - 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 ## 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)