> ## Documentation Index > Fetch the complete documentation index at: https://docs.b3.fun/llms.txt > Use this file to discover all available pages before exploring further. # Get contract transactions with specific signature Get specific contract transactions ` GET /insights/v1/transactions/{contractAddress}/{signature} ` Get contract transactions with specific signature Get specific contract transactions ## Servers - ` https://data-api.b3.fun/ ` — B3 Data API - Multi-Chain Proxy ## Parameters ### ` contract_address ` (path, required) - ` value `: type ` string ` - Title: address (hex or ENS) - example: ` "vitalik.eth" ` Example: ```json "vitalik.eth" ``` ### ` signature ` (path, required) - ` value `: type ` string ` ### ` chain ` (query, optional) Use chain_id instead - ` value `: type ` array ` - example: ` [20,56,1] ` - ` array item `: type ` number ` Example: ```json [ 20, 56, 1 ] ``` ### ` chain_id ` (query, optional) The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., `?chain_id=20&chain_id=56`. Optional, because a single chain can as well be specified as a subdomain - ` value `: type ` array ` - example: ` [20,56,1] ` - ` array item `: type ` number ` Example: ```json [ 20, 56, 1 ] ``` ### ` filter_block_number ` (query, optional) - ` value `: type ` number `; nullable — Filter by block number - example: ` 1000000 ` Example: ```json 1000000 ``` ### ` filter_block_number_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by block number greater than or equal to - example: ` 1000000 ` Example: ```json 1000000 ``` ### ` filter_block_number_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by block number greater than - example: ` 1000000 ` Example: ```json 1000000 ``` ### ` filter_block_number_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by block number less than or equal to - example: ` 1000000 ` Example: ```json 1000000 ``` ### ` filter_block_number_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by block number less than - example: ` 1000000 ` Example: ```json 1000000 ``` ### ` filter_block_hash ` (query, optional) - ` value `: type ` string ` — Filter by block hash - example: ` "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28" ` Example: ```json "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28" ``` ### ` filter_block_timestamp ` (query, optional) - ` value `: type ` number `; nullable — Filter by block timestamp - example: ` 1715222400 ` Example: ```json 1715222400 ``` ### ` filter_block_timestamp_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by block timestamp greater than or equal to - example: ` 1715222400 ` Example: ```json 1715222400 ``` ### ` filter_block_timestamp_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by block timestamp greater than - example: ` 1715222400 ` Example: ```json 1715222400 ``` ### ` filter_block_timestamp_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by block timestamp less than or equal to - example: ` 1715222400 ` Example: ```json 1715222400 ``` ### ` filter_block_timestamp_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by block timestamp less than - example: ` 1715222400 ` Example: ```json 1715222400 ``` ### ` sort_by ` (query, optional) - ` value `: type ` unknown ` — Field to sort results by - example: ` "block_number" ` - ` anyOf alternative 1 `: type ` string ` - Title: constant - enum: ` ["block_number"] ` - ` anyOf alternative 2 `: type ` string ` - Title: string Example: ```json "block_number" ``` ### ` sort_order ` (query, optional) - ` value `: type ` string ` — Sort order (asc or desc) - enum: ` ["asc","desc"] ` - example: ` "desc" ` Example: ```json "desc" ``` ### ` group_by ` (query, optional) - ` value `: type ` string `; nullable — Field(s) to group by. You can specify multiple with repeated query parameters, e.g., ?group_by=chain_id&group_by=block_number ### ` aggregate ` (query, optional) - ` value `: type ` string `; nullable — Aggregation(s). You can specify multiple with repeated query parameters, e.g., ?aggregate=count()&aggregate=sum(gas_used) - example: ` "count() as count" ` Example: ```json "count() as count" ``` ### ` filter_transaction_index ` (query, optional) - ` value `: type ` number `; nullable — Filter by transaction index - example: ` 5 ` Example: ```json 5 ``` ### ` filter_transaction_index_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by transaction index greater than or equal to - example: ` 5 ` Example: ```json 5 ``` ### ` filter_transaction_index_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by transaction index greater than - example: ` 5 ` Example: ```json 5 ``` ### ` filter_transaction_index_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by transaction index less than or equal to - example: ` 5 ` Example: ```json 5 ``` ### ` filter_transaction_index_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by transaction index less than - example: ` 5 ` Example: ```json 5 ``` ### ` decode ` (query, optional) - ` value `: type ` boolean `; nullable — Enable ABI decoding of the transactions/events data - example: ` true ` Example: ```json true ``` ### ` filter_hash ` (query, optional) - ` value `: type ` string ` — Filter by transaction hash - example: ` "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e" ` Example: ```json "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e" ``` ### ` filter_from_address ` (query, optional) - ` value `: type ` string ` — Filter by from address - Title: address (hex or ENS) - example: ` "0xa1e4380a3b1f749673e270229993ee55f35663b4" ` Example: ```json "0xa1e4380a3b1f749673e270229993ee55f35663b4" ``` ### ` filter_value ` (query, optional) - ` value `: type ` number `; nullable — Filter by value - example: ` 21000000000000 ` Example: ```json 21000000000000 ``` ### ` filter_value_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by value greater than or equal to - example: ` 21000000000000 ` Example: ```json 21000000000000 ``` ### ` filter_value_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by value greater than - example: ` 21000000000000 ` Example: ```json 21000000000000 ``` ### ` filter_value_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by value less than or equal to - example: ` 21000000000000 ` Example: ```json 21000000000000 ``` ### ` filter_value_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by value less than - example: ` 21000000000000 ` Example: ```json 21000000000000 ``` ### ` filter_gas_price ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas price - example: ` 50000000000000 ` Example: ```json 50000000000000 ``` ### ` filter_gas_price_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas price greater than or equal to - example: ` 50000000000000 ` Example: ```json 50000000000000 ``` ### ` filter_gas_price_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas price greater than - example: ` 50000000000000 ` Example: ```json 50000000000000 ``` ### ` filter_gas_price_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas price less than or equal to - example: ` 50000000000000 ` Example: ```json 50000000000000 ``` ### ` filter_gas_price_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas price less than - example: ` 50000000000000 ` Example: ```json 50000000000000 ``` ### ` filter_gas ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas - example: ` 21000 ` Example: ```json 21000 ``` ### ` filter_gas_gte ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas greater than or equal to - example: ` 21000 ` Example: ```json 21000 ``` ### ` filter_gas_gt ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas greater than - example: ` 21000 ` Example: ```json 21000 ``` ### ` filter_gas_lte ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas less than or equal to - example: ` 21000 ` Example: ```json 21000 ``` ### ` filter_gas_lt ` (query, optional) - ` value `: type ` number `; nullable — Filter by gas less than - example: ` 21000 ` Example: ```json 21000 ``` ### ` limit ` (query, optional) - ` value `: type ` integer ` — The number of items to return - default: ` 20 ` - example: ` 20 ` - minimum: ` 0 ` - maximum: ` 1000 ` Example: ```json 20 ``` ### ` page ` (query, optional) - ` value `: type ` integer `; nullable — Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters. - default: ` 0 ` - example: ` 0 ` - minimum: ` 0 ` Example: ```json 0 ``` ## Responses ### ` 200 ` — Successful response Content type: ` application/json ` - ` value `: type ` object ` - Required fields: ` meta ` - ` data `: type ` array ` - ` array item `: type ` object ` - Required fields: ` chain_id `, ` block_number `, ` block_hash `, ` block_timestamp `, ` hash `, ` nonce `, ` transaction_index `, ` from_address `, ` to_address `, ` value `, ` gas_price `, ` gas `, ` function_selector `, ` data `, ` max_fee_per_gas `, ` max_priority_fee_per_gas `, ` transaction_type `, ` r `, ` s `, ` v ` - ` chain_id `: type ` string ` - ` block_number `: type ` number ` - ` block_hash `: type ` string ` - ` block_timestamp `: type ` number ` - ` hash `: type ` string ` - ` nonce `: type ` number ` - ` transaction_index `: type ` number ` - ` from_address `: type ` string ` - ` to_address `: type ` string ` - ` value `: type ` string ` - ` gas_price `: type ` string ` - ` gas `: type ` number ` - ` function_selector `: type ` string ` - ` data `: type ` string ` - ` max_fee_per_gas `: type ` string ` - ` max_priority_fee_per_gas `: type ` string ` - ` transaction_type `: type ` number ` - ` r `: type ` string ` - ` s `: type ` string ` - ` v `: type ` string ` - ` access_list_json `: type ` string ` - ` authorization_list_json `: type ` string ` - ` contract_address `: type ` string ` - ` gas_used `: type ` number ` - ` cumulative_gas_used `: type ` number ` - ` effective_gas_price `: type ` string ` - ` blob_gas_used `: type ` number ` - ` blob_gas_price `: type ` string ` - ` logs_bloom `: type ` string ` - ` status `: type ` number ` - ` decoded `: type ` object ` - Required fields: ` name `, ` signature ` - ` name `: type ` string ` - ` signature `: type ` string ` - ` inputs `: type ` object ` - ` aggregations `: type ` unknown `; nullable - ` meta `: type ` object ` - Required fields: ` chain_ids `, ` page `, ` limit_per_chain `, ` total_items `, ` total_pages ` - ` chain_ids `: type ` array ` - ` array item `: type ` number ` - ` address `: type ` string ` - ` signature `: type ` string ` - ` page `: type ` number ` - ` limit_per_chain `: type ` number ` - ` total_items `: type ` number ` - ` total_pages `: type ` number ` ### ` 400 ` — Bad request Content type: ` application/json ` - ` value `: type ` object ` - Required fields: ` error ` - ` error `: type ` string ` ### ` 500 ` — Internal server error Content type: ` application/json ` - ` value `: type ` object ` - Required fields: ` error ` - ` error `: type ` string ` ## Request examples ### cURL ```curl curl -X GET 'https://data-api.b3.fun//insights/v1/transactions/{contractAddress}/string' ``` ### JavaScript ```javascript const response = await fetch('https://data-api.b3.fun//insights/v1/transactions/{contractAddress}/string', { method: 'GET' }); const data = await response.json(); console.log(data); ``` ### Python ```python import requests response = requests.get('https://data-api.b3.fun//insights/v1/transactions/{contractAddress}/string') print(response.json()) ```