Get transactions

curl --request GET \
  --url https://data-api.b3.fun/insights/v1/transactions

{
  "data": [
    {
      "chain_id": "<string>",
      "block_number": 123,
      "block_hash": "<string>",
      "block_timestamp": 123,
      "hash": "<string>",
      "nonce": 123,
      "transaction_index": 123,
      "from_address": "<string>",
      "to_address": "<string>",
      "value": "<string>",
      "gas_price": "<string>",
      "gas": 123,
      "function_selector": "<string>",
      "data": "<string>",
      "max_fee_per_gas": "<string>",
      "max_priority_fee_per_gas": "<string>",
      "transaction_type": 123,
      "r": "<string>",
      "s": "<string>",
      "v": "<string>",
      "access_list_json": "<string>",
      "authorization_list_json": "<string>",
      "contract_address": "<string>",
      "gas_used": 123,
      "cumulative_gas_used": 123,
      "effective_gas_price": "<string>",
      "blob_gas_used": 123,
      "blob_gas_price": "<string>",
      "logs_bloom": "<string>",
      "status": 123,
      "decoded": {
        "name": "<string>",
        "signature": "<string>",
        "inputs": {}
      }
    }
  ],
  "aggregations": "<any>",
  "meta": {
    "chain_ids": [
      123
    ],
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit_per_chain": 123,
    "total_items": 123,
    "total_pages": 123
  }
}

GET

insights

transactions

Get transactions

curl --request GET \
  --url https://data-api.b3.fun/insights/v1/transactions

{
  "data": [
    {
      "chain_id": "<string>",
      "block_number": 123,
      "block_hash": "<string>",
      "block_timestamp": 123,
      "hash": "<string>",
      "nonce": 123,
      "transaction_index": 123,
      "from_address": "<string>",
      "to_address": "<string>",
      "value": "<string>",
      "gas_price": "<string>",
      "gas": 123,
      "function_selector": "<string>",
      "data": "<string>",
      "max_fee_per_gas": "<string>",
      "max_priority_fee_per_gas": "<string>",
      "transaction_type": 123,
      "r": "<string>",
      "s": "<string>",
      "v": "<string>",
      "access_list_json": "<string>",
      "authorization_list_json": "<string>",
      "contract_address": "<string>",
      "gas_used": 123,
      "cumulative_gas_used": 123,
      "effective_gas_price": "<string>",
      "blob_gas_used": 123,
      "blob_gas_price": "<string>",
      "logs_bloom": "<string>",
      "status": 123,
      "decoded": {
        "name": "<string>",
        "signature": "<string>",
        "inputs": {}
      }
    }
  ],
  "aggregations": "<any>",
  "meta": {
    "chain_ids": [
      123
    ],
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit_per_chain": 123,
    "total_items": 123,
    "total_pages": 123
  }
}

Query Parameters

chain

number[]

deprecated

Use chain_id instead

Example:

[20, 56, 1]

chain_id

number[]

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

Example:

[20, 56, 1]

filter_block_number

number | null

Filter by block number

Example:

1000000

filter_block_number_gte

number | null

Filter by block number greater than or equal to

Example:

1000000

filter_block_number_gt

number | null

Filter by block number greater than

Example:

1000000

filter_block_number_lte

number | null

Filter by block number less than or equal to

Example:

1000000

filter_block_number_lt

number | null

Filter by block number less than

Example:

1000000

filter_block_hash

string

Filter by block hash

Example:

"0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28"

filter_block_timestamp

number | null

Filter by block timestamp

Example:

1715222400

filter_block_timestamp_gte

number | null

Filter by block timestamp greater than or equal to

Example:

1715222400

filter_block_timestamp_gt

number | null

Filter by block timestamp greater than

Example:

1715222400

filter_block_timestamp_lte

number | null

Filter by block timestamp less than or equal to

Example:

1715222400

filter_block_timestamp_lt

number | null

Filter by block timestamp less than

Example:

1715222400

sort_by

Field to sort results by

Available options:

block_number

Example:

"block_number"

sort_order

enum<string>

Sort order (asc or desc)

Available options:

asc,

desc

Example:

"desc"

group_by

string | null

Field(s) to group by. You can specify multiple with repeated query parameters, e.g., ?group_by=chain_id&group_by=block_number

aggregate

string | null

Aggregation(s). You can specify multiple with repeated query parameters, e.g., ?aggregate=count()&aggregate=sum(gas_used)

Example:

"count() as count"

filter_transaction_index

number | null

Filter by transaction index

Example:

5

filter_transaction_index_gte

number | null

Filter by transaction index greater than or equal to

Example:

5

filter_transaction_index_gt

number | null

Filter by transaction index greater than

Example:

5

filter_transaction_index_lte

number | null

Filter by transaction index less than or equal to

Example:

5

filter_transaction_index_lt

number | null

Filter by transaction index less than

Example:

5

decode

boolean | null

Enable ABI decoding of the transactions/events data

Example:

true

filter_hash

string

Filter by transaction hash

Example:

"0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e"

filter_from_address

string

Filter by from address

Example:

"0xa1e4380a3b1f749673e270229993ee55f35663b4"

filter_value

number | null

Filter by value

Example:

21000000000000

filter_value_gte

number | null

Filter by value greater than or equal to

Example:

21000000000000

filter_value_gt

number | null

Filter by value greater than

Example:

21000000000000

filter_value_lte

number | null

Filter by value less than or equal to

Example:

21000000000000

filter_value_lt

number | null

Filter by value less than

Example:

21000000000000

filter_gas_price

number | null

Filter by gas price

Example:

50000000000000

filter_gas_price_gte

number | null

Filter by gas price greater than or equal to

Example:

50000000000000

filter_gas_price_gt

number | null

Filter by gas price greater than

Example:

50000000000000

filter_gas_price_lte

number | null

Filter by gas price less than or equal to

Example:

50000000000000

filter_gas_price_lt

number | null

Filter by gas price less than

Example:

50000000000000

filter_gas

number | null

Filter by gas

Example:

21000

filter_gas_gte

number | null

Filter by gas greater than or equal to

Example:

21000

filter_gas_gt

number | null

Filter by gas greater than

Example:

21000

filter_gas_lte

number | null

Filter by gas less than or equal to

Example:

21000

filter_gas_lt

number | null

Filter by gas less than

Example:

21000

filter_function_selector

string

Filter by function selector

Example:

"0x095ea7b3"

filter_to_address

string

Filter by to address

Example:

"0xa1e4380a3b1f749673e270229993ee55f35663b4"

limit

integer

default:20

The number of items to return

Required range: 0 < x <= 1000

Example:

20

page

integer | null

default:0

Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters.

Required range: x >= 0

Example:

0

Response

200

application/json

Successful response

The response is of type object.

Get contract events with specific signature Get contract transactions

Overview

Resources

Ecosystem Tools

User Experience

Data API

Learn

Get transactions

Query Parameters

Response