Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
advanced-filters

Export advanced-filter results as CSV

Streams the items matching the advanced filter criteria as a CSV file. When asynchronous CSV export is enabled on the deployment, returns 202 Accepted with a request_id that can be polled via /api/v2/csv-exports/{request_id}; otherwise the CSV body is streamed inline.

get/{chain_id}/api/v2/advanced-filters/csv

Path parameters

chain_idstring required

The ID of the blockchain

Query parameters

transaction_typesstring nullable

Comma-separated list of transaction types to include. Allowed values: COIN_TRANSFER, CONTRACT_INTERACTION, CONTRACT_CREATION, ERC-20, ERC-404, ERC-721, ERC-1155, ERC-7984 (plus ZRC-2 on Zilliqa). Values are matched case-insensitively; unknown entries are silently dropped.

methodsstring nullable

Comma-separated list of 4-byte contract method selectors (lowercase, 0x-prefixed). At most 20 unique entries are honored; invalid entries are dropped.

age_fromstring nullable

Inclusive lower bound on timestamp (ISO 8601).

age_tostring nullable

Inclusive upper bound on timestamp (ISO 8601).

from_address_hashes_to_includestring nullable

Comma-separated list of sender address hashes to include.

from_address_hashes_to_excludestring nullable

Comma-separated list of sender address hashes to exclude.

to_address_hashes_to_includestring nullable

Comma-separated list of recipient address hashes to include.

to_address_hashes_to_excludestring nullable

Comma-separated list of recipient address hashes to exclude.

address_relationstring nullable

How to combine the from_address_hashes_* and to_address_hashes_* filters. Accepts or or and (case-insensitive). or (default) matches an item if either side matches; and requires both sides to match. Any other value is silently coerced to nil (no relation constraint).

amount_fromstring nullable

Inclusive lower bound on the item's transferred amount (decimal string in the token's base units).

amount_tostring nullable

Inclusive upper bound on the item's transferred amount (decimal string in the token's base units).

token_contract_address_hashes_to_includestring nullable

Comma-separated list of token contract address hashes to include. Use the literal native to also include native coin transfers. Each list (include and exclude) is capped to 20 entries separately.

token_contract_address_hashes_to_excludestring nullable

Comma-separated list of token contract address hashes to exclude. Use the literal native to also exclude native coin transfers. Each list (include and exclude) is capped to 20 entries separately.

methods_namesstring nullable

Comma-separated list of human-readable method names corresponding to the methods selectors.

token_contract_symbols_to_includestring nullable

Comma-separated list of token symbols to include.

token_contract_symbols_to_excludestring nullable

Comma-separated list of token symbols to exclude.

block_numberstring

Keyset cursor: block number of the last item from the previous page.

transaction_indexstring

Keyset cursor: transaction index within the block of the last item from the previous page.

string
OR
'' | 'null'

Keyset cursor: internal-transaction index of the last item from the previous page. Use an empty string or the literal null when the previous item was not an internal transaction.

string
OR
'' | 'null'

Keyset cursor: token-transfer index of the last item from the previous page. Use an empty string or the literal null when the previous item was not a token transfer.

string
OR
'' | 'null'

Keyset cursor: index within an ERC-1155 batch token transfer. Use an empty string or the literal null when the previous item was not part of a batch.

Response

CSV file (sync export).