> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt > Use this file to discover all available pages before exploring further. # List transactions, internal transactions and token transfers matching the advanced filter criteria > Returns a paginated, mixed list of activity — native value transfers, internal transactions and token transfers — filtered by transaction type, contract method, time window, address relations, value range and/or token contract. The response also echoes the resolved human-readable names of the methods and tokens referenced in the request filters. ## OpenAPI ````yaml /openapi-specs/pro-api-v11.yaml get /v2/advanced-filters openapi: 3.0.0 info: contact: email: info@blockscout.com title: Blockscout version: 11.0.3 servers: - url: http://localhost/api variables: {} security: [] tags: - name: blocks - name: transactions - name: addresses - name: internal-transactions - name: tokens - name: token-transfers - name: smart-contracts - name: config - name: main-page - name: search - name: stats - name: csv-export - name: account-abstraction - name: withdrawals - name: advanced-filters - name: arbitrum - name: legacy - name: optimism - name: mud - name: celo - name: scroll - name: zilliqa paths: /v2/advanced-filters: get: tags: - advanced-filters summary: >- List transactions, internal transactions and token transfers matching the advanced filter criteria description: >- Returns a paginated, mixed list of activity — native value transfers, internal transactions and token transfers — filtered by transaction type, contract method, time window, address relations, value range and/or token contract. The response also echoes the resolved human-readable names of the methods and tokens referenced in the request filters. operationId: BlockScoutWeb.API.V2.AdvancedFilterController.list parameters: - description: API key for rate limiting or for sensitive endpoints in: query name: apikey required: false schema: type: string x-struct: null x-validate: null - description: Secret key for getting access to restricted resources in: query name: key required: false schema: type: string x-struct: null x-validate: null - description: >- 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. example: COIN_TRANSFER,ERC-20 in: query name: transaction_types required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- Comma-separated list of 4-byte contract method selectors (lowercase, `0x`-prefixed). At most 20 unique entries are honored; invalid entries are dropped. example: 0xa9059cbb,0x095ea7b3 in: query name: methods required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Inclusive lower bound on `timestamp` (ISO 8601). example: '2024-01-01T00:00:00.000Z' in: query name: age_from required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Inclusive upper bound on `timestamp` (ISO 8601). example: '2024-12-31T23:59:59.000Z' in: query name: age_to required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Comma-separated list of sender address hashes to include. example: >- 0x5a52e96bacdabb82fd05763e25335261b270efcb,0x00000000219ab540356cbb839cbe05303d7705fa in: query name: from_address_hashes_to_include required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Comma-separated list of sender address hashes to exclude. example: >- 0x5a52e96bacdabb82fd05763e25335261b270efcb,0x00000000219ab540356cbb839cbe05303d7705fa in: query name: from_address_hashes_to_exclude required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Comma-separated list of recipient address hashes to include. example: >- 0x5a52e96bacdabb82fd05763e25335261b270efcb,0x00000000219ab540356cbb839cbe05303d7705fa in: query name: to_address_hashes_to_include required: false schema: nullable: true type: string x-struct: null x-validate: null - description: Comma-separated list of recipient address hashes to exclude. example: >- 0x5a52e96bacdabb82fd05763e25335261b270efcb,0x00000000219ab540356cbb839cbe05303d7705fa in: query name: to_address_hashes_to_exclude required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- 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). example: and in: query name: address_relation required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- Inclusive lower bound on the item's transferred amount (decimal string in the token's base units). example: '0' in: query name: amount_from required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- Inclusive upper bound on the item's transferred amount (decimal string in the token's base units). example: '1000000' in: query name: amount_to required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- 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. example: native,0xdac17f958d2ee523a2206206994597c13d831ec7 in: query name: token_contract_address_hashes_to_include required: false schema: nullable: true type: string x-struct: null x-validate: null - description: >- 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. example: '0x0000000000000000000000000000000000000000' in: query name: token_contract_address_hashes_to_exclude required: false schema: nullable: true type: string x-struct: null x-validate: null - description: 'Keyset cursor: block number of the last item from the previous page.' example: '23532302' in: query name: block_number required: false schema: pattern: ^([1-9][0-9]*|0)$ type: string x-struct: null x-validate: null - description: >- Keyset cursor: transaction index within the block of the last item from the previous page. example: '1' in: query name: transaction_index required: false schema: pattern: ^([1-9][0-9]*|0)$ type: string x-struct: null x-validate: null - description: >- 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. in: query name: internal_transaction_index required: false schema: $ref: '#/components/schemas/IntegerStringOrEmptyOrNullLiteral' - description: >- 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. in: query name: token_transfer_index required: false schema: $ref: '#/components/schemas/IntegerStringOrEmptyOrNullLiteral' - description: >- 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. in: query name: token_transfer_batch_index required: false schema: $ref: '#/components/schemas/IntegerStringOrEmptyOrNullLiteral' - description: Cumulative number of items already returned across previous pages. in: query name: items_count required: false schema: minimum: 1 type: integer x-struct: null x-validate: null responses: '200': content: application/json: schema: $ref: '#/components/schemas/AdvancedFilterResponse' description: >- List of matching items with pagination information and resolved search params. '422': content: application/json: schema: $ref: '#/components/schemas/JsonErrorResponse' description: Unprocessable Entity callbacks: {} components: schemas: IntegerStringOrEmptyOrNullLiteral: oneOf: - pattern: ^([1-9][0-9]*|0)$ type: string x-struct: null x-validate: null - enum: - '' - 'null' type: string x-struct: null x-validate: null title: IntegerStringOrEmptyOrNullLiteral x-struct: >- Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringOrEmptyOrNullLiteral x-validate: null AdvancedFilterResponse: additionalProperties: false properties: items: items: $ref: '#/components/schemas/AdvancedFilterItem' nullable: false type: array x-struct: null x-validate: null next_page_params: example: block_number: 23532302 internal_transaction_index: null items_count: 50 token_transfer_batch_index: null token_transfer_index: 0 transaction_index: 1 nullable: true type: object x-struct: null x-validate: null search_params: $ref: '#/components/schemas/AdvancedFilterSearchParams' required: - items - search_params - next_page_params title: AdvancedFilterResponse type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.AdvancedFilter.Response x-validate: null JsonErrorResponse: properties: errors: items: properties: detail: example: null value where string expected type: string x-struct: null x-validate: null source: properties: pointer: example: /data/attributes/petName type: string x-struct: null x-validate: null required: - pointer type: object x-struct: null x-validate: null title: example: Invalid value type: string x-struct: null x-validate: null required: - title - source - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors title: JsonErrorResponse type: object x-struct: Elixir.OpenApiSpex.JsonErrorResponse x-validate: null AdvancedFilterItem: additionalProperties: false properties: block_number: description: Number of the block that contains the parent transaction. minimum: 0 nullable: false type: integer x-struct: null x-validate: null created_contract: allOf: - $ref: '#/components/schemas/Address' description: >- Address of the contract deployed by this item. `null` unless the item is a contract creation. nullable: true x-struct: null x-validate: null fee: description: >- Transaction fee paid by the sender, in the chain's base unit (e.g. wei). nullable: false pattern: ^([1-9][0-9]*|0)$ type: string x-struct: null x-validate: null from: allOf: - $ref: '#/components/schemas/Address' description: Sender address. `null` for contract-creation items. nullable: true x-struct: null x-validate: null hash: $ref: '#/components/schemas/FullHash' internal_transaction_index: description: >- Zero-based position of the internal transaction within its parent transaction. Populated only for internal-transaction items; `null` otherwise. minimum: 0 nullable: true type: integer x-struct: null x-validate: null method: $ref: '#/components/schemas/MethodNameNullable' status: description: >- Execution status of the parent transaction. One of `pending`, `awaiting_internal_transactions`, `success`, or a free-form error reason string when the transaction reverted (e.g. `Reverted`). nullable: false type: string x-struct: null x-validate: null timestamp: description: Block timestamp of the parent transaction. format: date-time nullable: false title: Timestamp type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Timestamp x-validate: null to: allOf: - $ref: '#/components/schemas/Address' description: >- Recipient address. `null` for contract-creation items and some internal transactions. nullable: true x-struct: null x-validate: null token: allOf: - $ref: '#/components/schemas/Token' description: >- Token contract metadata. Populated only for token-transfer items; `null` otherwise. nullable: true x-struct: null x-validate: null token_transfer_batch_index: description: >- Zero-based position within an ERC-1155 batch token transfer. Populated only for items that belong to a batch; `null` otherwise. minimum: 0 nullable: true type: integer x-struct: null x-validate: null token_transfer_index: description: >- Zero-based position of the token transfer, unique per parent transaction. Populated only for token-transfer items; `null` otherwise. minimum: 0 nullable: true type: integer x-struct: null x-validate: null total: anyOf: - $ref: '#/components/schemas/TotalERC721' - $ref: '#/components/schemas/TotalERC1155' - $ref: '#/components/schemas/TotalERC7984' - $ref: '#/components/schemas/Total' description: >- Token transfer amount (or token id for NFTs). Populated only for token-transfer items; `null` otherwise. nullable: true x-struct: null x-validate: null transaction_index: description: Zero-based position of the parent transaction within its block. minimum: 0 nullable: false type: integer x-struct: null x-validate: null type: description: >- Kind of activity represented by the item. Values `coin_transfer`, `contract_interaction`, and `contract_creation` apply to top-level transactions and internal transactions; the `ERC-*` values apply to token transfers. enum: - coin_transfer - contract_interaction - contract_creation - ERC-20 - ERC-721 - ERC-1155 - ERC-404 - ERC-7984 nullable: false type: string x-struct: null x-validate: null value: description: >- Native coin amount transferred, in the chain's base unit (e.g. wei). `null` for token-transfer items. nullable: true pattern: ^([1-9][0-9]*|0)$ type: string x-struct: null x-validate: null required: - hash - type - status - method - from - to - created_contract - value - total - token - timestamp - block_number - transaction_index - internal_transaction_index - token_transfer_index - token_transfer_batch_index - fee title: AdvancedFilterItem type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.AdvancedFilter x-validate: null AdvancedFilterSearchParams: additionalProperties: false properties: methods: additionalProperties: nullable: false type: string x-struct: null x-validate: null description: >- Map of 4-byte method selectors (keys) to resolved method names (values) for the `methods` filter. type: object x-struct: null x-validate: null tokens: additionalProperties: $ref: '#/components/schemas/Token' description: >- Map of token contract address hashes (keys) to `Token` objects for tokens referenced in the `token_contract_address_hashes_to_include`/`_exclude` filters. At most 20 entries are returned (combined across both lists). type: object x-struct: null x-validate: null required: - methods - tokens title: AdvancedFilterSearchParams type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.AdvancedFilter.SearchParams x-validate: null Address: additionalProperties: false description: Address properties: ens_domain_name: description: ENS domain name associated with the address nullable: true type: string x-struct: null x-validate: null hash: $ref: '#/components/schemas/AddressHash' implementations: description: Implementations linked with the contract items: $ref: '#/components/schemas/Implementation' type: array x-struct: null x-validate: null is_contract: description: Has address contract code? nullable: true type: boolean x-struct: null x-validate: null is_scam: description: Has address scam badge? nullable: false type: boolean x-struct: null x-validate: null is_verified: description: Has address associated source code? nullable: true type: boolean x-struct: null x-validate: null metadata: allOf: - $ref: '#/components/schemas/Metadata' nullable: true x-struct: null x-validate: null name: description: Name associated with the address nullable: true type: string x-struct: null x-validate: null private_tags: description: Private tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null proxy_type: $ref: '#/components/schemas/ProxyType' public_tags: description: Public tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null reputation: description: Reputation of the address enum: - ok - scam nullable: false type: string x-struct: null x-validate: null watchlist_names: description: Watchlist name associated with the address items: $ref: '#/components/schemas/WatchlistName' type: array x-struct: null x-validate: null required: - hash - is_contract - name - is_scam - reputation - proxy_type - implementations - is_verified - ens_domain_name - metadata title: Address type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Address x-validate: null FullHash: nullable: false pattern: ^0x([A-Fa-f0-9]{64})$ title: FullHash type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FullHash x-validate: null MethodNameNullable: description: Method name or hex method id example: transfer nullable: true title: MethodNameNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.MethodNameNullable x-validate: null Token: additionalProperties: false description: Token struct properties: address_hash: $ref: '#/components/schemas/AddressHash' bridge_type: description: Type of bridge used for this bridged token enum: - omni - amb nullable: true type: string x-struct: null x-validate: null circulating_market_cap: $ref: '#/components/schemas/FloatStringNullable' decimals: $ref: '#/components/schemas/IntegerStringNullable' exchange_rate: $ref: '#/components/schemas/FloatStringNullable' foreign_address: nullable: true pattern: ^0x([A-Fa-f0-9]{40})$ type: string x-struct: null x-validate: null holders_count: $ref: '#/components/schemas/IntegerStringNullable' icon_url: $ref: '#/components/schemas/URLNullable' name: nullable: true type: string x-struct: null x-validate: null origin_chain_id: $ref: '#/components/schemas/IntegerStringNullable' reputation: description: Reputation of the token enum: - ok - scam nullable: true type: string x-struct: null x-validate: null symbol: nullable: true type: string x-struct: null x-validate: null total_supply: $ref: '#/components/schemas/IntegerStringNullable' type: allOf: - $ref: '#/components/schemas/Type' nullable: true x-struct: null x-validate: null volume_24h: $ref: '#/components/schemas/FloatStringNullable' required: - address_hash - symbol - name - decimals - type - holders_count - exchange_rate - volume_24h - total_supply - icon_url - circulating_market_cap - reputation title: Token type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Token x-validate: null TotalERC721: additionalProperties: false properties: token_id: $ref: '#/components/schemas/IntegerStringNullable' token_instance: allOf: - $ref: '#/components/schemas/TokenInstance' nullable: true x-struct: null x-validate: null required: - token_id - token_instance title: TotalERC721 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC721 x-validate: null TotalERC1155: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' token_id: $ref: '#/components/schemas/IntegerStringNullable' token_instance: allOf: - $ref: '#/components/schemas/TokenInstance' nullable: true x-struct: null x-validate: null value: $ref: '#/components/schemas/IntegerStringNullable' required: - token_id - value - decimals - token_instance title: TotalERC1155 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC1155 x-validate: null TotalERC7984: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' value: $ref: '#/components/schemas/IntegerStringNullable' required: - value - decimals title: TotalERC7984 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC7984 x-validate: null Total: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' value: $ref: '#/components/schemas/IntegerStringNullable' required: - value - decimals title: Total type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.Total x-validate: null AddressHash: nullable: false pattern: ^0x([A-Fa-f0-9]{40})$ title: AddressHash type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHash x-validate: null Implementation: additionalProperties: false description: Proxy smart contract implementation properties: address_hash: $ref: '#/components/schemas/AddressHash' name: nullable: true type: string x-struct: null x-validate: null required: - address_hash - name title: Implementation type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Implementation x-validate: null Metadata: additionalProperties: false description: Metadata struct properties: tags: description: Metadata tags linked with the address items: $ref: '#/components/schemas/MetadataTag' type: array x-struct: null x-validate: null required: - tags title: Metadata type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.Metadata x-validate: null Tag: additionalProperties: false description: Address tag struct properties: address_hash: $ref: '#/components/schemas/AddressHash' display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - address_hash - display_name - label title: Tag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Tag x-validate: null ProxyType: enum: - eip1167 - eip1967 - eip1822 - eip1967_oz - eip1967_beacon - master_copy - basic_implementation - basic_get_implementation - comptroller - eip2535 - clone_with_immutable_arguments - eip7702 - resolved_delegate_proxy - erc7760 nullable: true title: ProxyType type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.ProxyType x-validate: null WatchlistName: additionalProperties: false description: Watchlist name struct properties: display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - display_name - label title: WatchlistName type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.WatchlistName x-validate: null FloatStringNullable: nullable: true pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$ title: FloatStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FloatStringNullable x-validate: null IntegerStringNullable: nullable: true pattern: ^-?([1-9][0-9]*|0)$ title: IntegerStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringNullable x-validate: null URLNullable: example: https://example.com format: uri nullable: true title: URLNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.URLNullable x-validate: null Type: enum: - ERC-20 - ERC-721 - ERC-1155 - ERC-404 - ERC-7984 title: Type type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Token.Type x-validate: null TokenInstance: additionalProperties: false nullable: false properties: animation_url: $ref: '#/components/schemas/URLNullable' external_app_url: $ref: '#/components/schemas/URLNullable' id: $ref: '#/components/schemas/IntegerString' image_url: $ref: '#/components/schemas/URLNullable' is_unique: nullable: true type: boolean x-struct: null x-validate: null media_type: description: Mime type of the media in media_url example: image/png nullable: true type: string x-struct: null x-validate: null media_url: $ref: '#/components/schemas/URLNullable' metadata: example: description: Test image: https://example.com/image.png name: Test nullable: true type: object x-struct: null x-validate: null owner: allOf: - $ref: '#/components/schemas/Address' nullable: true x-struct: null x-validate: null thumbnails: nullable: true properties: 250x250: format: uri type: string x-struct: null x-validate: null 500x500: format: uri type: string x-struct: null x-validate: null 60x60: format: uri type: string x-struct: null x-validate: null original: format: uri type: string x-struct: null x-validate: null required: - original type: object x-struct: null x-validate: null token: allOf: - $ref: '#/components/schemas/Token' nullable: true x-struct: null x-validate: null token_type: allOf: - $ref: '#/components/schemas/Type' nullable: true x-struct: null x-validate: null value: $ref: '#/components/schemas/IntegerStringNullable' required: - id - metadata - owner - token - external_app_url - animation_url - image_url - is_unique - thumbnails - media_type - media_url title: TokenInstance type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenInstance x-validate: null MetadataTag: additionalProperties: false description: Metadata tag struct properties: meta: nullable: false type: object x-struct: null x-validate: null name: nullable: false type: string x-struct: null x-validate: null ordinal: nullable: false type: integer x-struct: null x-validate: null slug: nullable: false type: string x-struct: null x-validate: null tagType: nullable: false type: string x-struct: null x-validate: null required: - slug - name - tagType - ordinal - meta title: MetadataTag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.MetadataTag x-validate: null IntegerString: nullable: false pattern: ^-?([1-9][0-9]*|0)$ title: IntegerString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerString x-validate: null ````