Blockscout Transactions API
The Transactions API from Blockscout — 8 operation(s) for transactions.
The Transactions API from Blockscout — 8 operation(s) for transactions.
openapi: 3.0.0
info:
description: API for BlockScout web app
version: 1.0.0
title: BlockScout Addresses Transactions API
contact:
email: support@blockscout.com
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://eth.blockscout.com/api/v2/
description: Ethereum mainnet
- url: https://optimism.blockscout.com/api/v2/
description: Optimism mainnet
- url: https://base.blockscout.com/api/v2/
description: Base mainnet
- url: https://eth-sepolia.blockscout.com/api/v2/
description: Ethereum testnet
tags:
- name: Transactions
paths:
/transactions:
get:
parameters:
- in: query
name: filter
schema:
type: string
example: pending | validated
- in: query
name: type
schema:
type: string
example: token_transfer,contract_creation,contract_call,coin_transfer,token_creation
- in: query
name: method
schema:
type: string
example: approve,transfer,multicall,mint,commit
summary: get transactions
operationId: get_txs
responses:
'200':
description: block
content:
application/json:
schema:
type: object
required:
- items
- next_page_params
properties:
items:
type: array
items:
$ref: '#/components/schemas/Transaction'
next_page_params:
type: object
example:
block_number: 27170298
index: 0
items_count: 50
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}:
get:
summary: get transaction info
operationId: get_tx
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: transaction info
content:
application/json:
schema:
$ref: '#/components/schemas/Transaction'
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/token-transfers:
get:
summary: get transaction token transfers
operationId: get_transaction_token_transfers
parameters:
- $ref: '#/components/parameters/transactionHash'
- in: query
name: type
schema:
type: string
example: ERC-20,ERC-721,ERC-1155
responses:
'200':
description: token transfers
content:
application/json:
schema:
type: object
required:
- items
- next_page_params
properties:
items:
type: array
items:
$ref: '#/components/schemas/TokenTransfer'
next_page_params:
type: object
example:
block_number: 27350206
index: 1
items_count: 50
transaction_hash: '0xa3b401d6f3124c9d1528cd8d4b692f523d86fd88e48c391ffe9c67e4436ae5ca'
examples:
large_1155_batch:
$ref: '#/components/examples/TokenTransferLarge1155Batch'
some_batches_on_the_first_page_and_one_on_the_second:
$ref: '#/components/examples/TokenTransferSomeBatchesOnTheFirstPageAndOneOnTheSecond'
a_lot_of_batches:
$ref: '#/components/examples/TokenTransferALotOfBatches'
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/internal-transactions:
get:
summary: get transaction internal transactions
operationId: get_transaction_internal_txs
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: internal transactions
content:
application/json:
schema:
type: object
required:
- items
- next_page_params
properties:
items:
type: array
items:
$ref: '#/components/schemas/InternalTransaction'
next_page_params:
type: object
example:
block_number: 27350206
index: 1
items_count: 50
transaction_index: 0
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/logs:
get:
summary: get transaction logs
operationId: get_transaction_logs
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: internal transactions
content:
application/json:
schema:
type: object
required:
- items
- next_page_params
properties:
items:
type: array
items:
$ref: '#/components/schemas/Log'
next_page_params:
type: object
example:
index: 0
items_count: 50
block_number: 2
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/raw-trace:
get:
summary: get transaction raw trace
operationId: get_transaction_raw_trace
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: raw trace
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RawTrace'
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/state-changes:
get:
summary: get transaction state changes
operationId: get_transaction_state_changes
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: state changes
content:
application/json:
schema:
type: object
required:
- items
- next_page_params
properties:
items:
type: array
items:
$ref: '#/components/schemas/StateChange'
next_page_params:
type: object
example:
items_count: 1
state_changes: null
'400':
description: bad input parameter
tags:
- Transactions
/transactions/{transaction_hash}/summary:
get:
summary: get human-readable transaction summary
operationId: get_transaction_summary
parameters:
- $ref: '#/components/parameters/transactionHash'
responses:
'200':
description: human-readable transaction summary
content:
application/json:
schema:
$ref: '#/components/schemas/TransactionSummary'
'400':
description: bad input parameter
tags:
- Transactions
components:
examples:
TokenTransferLarge1155Batch:
value:
items:
- block_hash: '0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a'
from:
hash: '0xcc4e74EB7F0D2F3e8c86Ac08A6B70689F564b226'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
log_index: '243'
method: null
timestamp: null
to:
hash: '0xEf8801eaf234ff82801821FFe2d78D60a0237F97'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
token:
address_hash: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
circulating_market_cap: '83606435600.3635'
decimals: '6'
exchange_rate: '0.999487'
holders_count: '1149'
icon_url: null
name: Tether USD
symbol: USDT
total_supply: '39030615894320966'
type: ERC-20
total:
decimals: '6'
value: '830000000'
transaction_hash: '0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592'
type: token_transfer
next_page_params:
batch_block_hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
batch_log_index: 0
batch_transaction_hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
index_in_batch: 1
TokenTransferSomeBatchesOnTheFirstPageAndOneOnTheSecond:
value:
items:
- block_hash: '0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a'
from:
hash: '0xcc4e74EB7F0D2F3e8c86Ac08A6B70689F564b226'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
log_index: '243'
method: null
timestamp: null
to:
hash: '0xEf8801eaf234ff82801821FFe2d78D60a0237F97'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
token:
address_hash: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
circulating_market_cap: '83606435600.3635'
decimals: '6'
exchange_rate: '0.999487'
holders_count: '1149'
icon_url: null
name: Tether USD
symbol: USDT
total_supply: '39030615894320966'
type: ERC-20
total:
decimals: '6'
value: '830000000'
transaction_hash: '0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592'
type: token_transfer
next_page_params:
block_number: 4
index: 2
TokenTransferALotOfBatches:
value:
items:
- block_hash: '0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a'
from:
hash: '0xcc4e74EB7F0D2F3e8c86Ac08A6B70689F564b226'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
log_index: '243'
method: null
timestamp: null
to:
hash: '0xEf8801eaf234ff82801821FFe2d78D60a0237F97'
implementation_name: null
is_contract: false
is_verified: false
name: null
private_tags: []
public_tags: []
watchlist_names: []
token:
address_hash: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
circulating_market_cap: '83606435600.3635'
decimals: '6'
exchange_rate: '0.999487'
holders_count: '1149'
icon_url: null
name: Tether USD
symbol: USDT
total_supply: '39030615894320966'
type: ERC-20
total:
decimals: '6'
value: '830000000'
transaction_hash: '0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592'
type: token_transfer
next_page_params:
batch_block_hash: '0x0000000000000000000000000000000000000000000000000000000000000014'
batch_log_index: 5
batch_transaction_hash: '0x000000000000000000000000000000000000000000000000000000000000000a'
block_number: 14
index: 4
index_in_batch: 1
schemas:
TotalERC20:
required:
- decimals
- value
properties:
decimals:
type: string
example: '18'
value:
type: string
example: '1000'
DecodedInput:
type: object
required:
- method_call
- method_id
- parameters
properties:
method_call:
type: string
example: transferFrom(address _from, address _to, uint256 _value)
method_id:
type: string
example: 23b872dd
parameters:
type: array
items:
$ref: '#/components/schemas/DecodedInputParameter'
TransactionSummary:
type: object
required:
- success
- data
properties:
success:
type: boolean
example: true
data:
$ref: '#/components/schemas/TransactionSummaryObj'
DecodedInputLog:
type: object
required:
- method_call
- method_id
- parameters
properties:
method_call:
type: string
example: transferFrom(address _from, address _to, uint256 _value)
method_id:
type: string
example: 23b872dd
parameters:
type: array
items:
$ref: '#/components/schemas/DecodedInputLogParameter'
Transaction:
type: object
required:
- timestamp
- fee
- gas_limit
- block_number
- status
- method
- confirmations
- type
- exchange_rate
- to
- transaction_burnt_fee
- max_fee_per_gas
- result
- hash
- gas_price
- priority_fee
- base_fee_per_gas
- from
- token_transfers
- transaction_types
- gas_used
- created_contract
- position
- nonce
- has_error_in_internal_transactions
- actions
- decoded_input
- token_transfers_overflow
- raw_input
- value
- max_priority_fee_per_gas
- revert_reason
- confirmation_duration
- transaction_tag
properties:
timestamp:
type: string
example: '2022-08-02T07:18:05.000000Z'
fee:
$ref: '#/components/schemas/Fee'
gas_limit:
type: integer
block_number:
type: integer
format: int32
example: 23484035
status:
type: string
example: ok | error
method:
type: string
example: transferFrom
confirmations:
type: integer
example: 1035
type:
type: integer
example: 2
exchange_rate:
type: string
example: '1866.51'
to:
nullable: true,
$ref: '#/components/schemas/AddressParam'
transaction_burnt_fee:
type: string
example: '1099596081903840'
max_fee_per_gas:
type: string
example: '55357460102'
result:
type: string
example: 'Error: (Awaiting internal transactions for reason)'
hash:
type: string
example: '0x5d90a9da2b8da402b11bc92c8011ec8a62a2d59da5c7ac4ae0f73ec51bb73368'
gas_price:
type: string
example: '26668595172'
priority_fee:
type: string
example: '2056916056308'
base_fee_per_gas:
type: string
example: '26618801760'
from:
$ref: '#/components/schemas/AddressParam'
token_transfers:
type: array
items:
$ref: '#/components/schemas/TokenTransfer'
transaction_types:
type: array
items:
type: string
example:
- token_transfer
- contract_creation
- contract_call
- token_creation
- coin_transfer
gas_used:
type: string
example: '41309'
created_contract:
nullable: true,
$ref: '#/components/schemas/AddressParam'
position:
type: integer
example: 117
nonce:
type: integer
example: 115
has_error_in_internal_transactions:
type: boolean
example: false
actions:
type: array
items:
$ref: '#/components/schemas/TransactionAction'
decoded_input:
$ref: '#/components/schemas/DecodedInput'
token_transfers_overflow:
type: boolean
example: false
raw_input:
type: string
example: '0xa9059cbb000000000000000000000000ef8801eaf234ff82801821ffe2d78d60a0237f97000000000000000000000000000000000000000000000000000000003178cb80'
value:
type: string
example: '0'
max_priority_fee_per_gas:
type: string
example: '49793412'
revert_reason:
type: string
example: 'Error: (Awaiting internal transactions for reason)'
confirmation_duration:
type: object
example:
- 0
- 17479.0
transaction_tag:
type: string
example: private_transaction_tag
SummaryVariableCurrency:
type: object
required:
- type
- value
properties:
type:
type: string
example: currency
description: Currency type
value:
type: string
example: '0.195999999980484004'
description: Value
TransactionActionUniswapV3MintNFT:
required:
- data
- protocol
- type
properties:
data:
type: object
example:
name: 'Uniswap V3: Positions NFT'
symbol: UNI-V3-POS
address: '0x1F98431c8aD98523631AE4a59f267346ea31F984'
to: '0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9'
ids:
- '1'
- '2'
block_number: 1
protocol:
type: string
example: uniswap_v3
type:
type: string
example: mint_nft
RawTraceCreateAction:
type: object
required:
- from
- gas
- init
- value
properties:
from:
type: string
example: '0xf57b55b01b831e602e09674a4e5d69cbcf343f98'
gas:
type: string
example: '0x25D3FC'
init:
type: string
example: '0x630cea8e000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000041c25b36779231e71769118210c3eb64c0a9c7577b925b309af3183e13acc7cf30210493d13c8c6c3c0bd337d5e39e454fece0c301f0aedb6c43c7a37650ac83e71c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000019500050000f0add9e5dc02faeca12e9669f045685449d6b80a000000000000744359447362798334d3485c64d1e4870fde2ddc0d75f0b456250dc9990662a6f25808cc74a6d1131ea9000927c001018064382ae87cdd000000000000000000000000bab3cbdcbcc578445480a79ed80269c50bb5b71800000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000012000000000000000000000000351af1631aa5ea1ca62ad8a4e3cd87128d4d910800000000000000000000000000000000000000000000005b8decde02914ce837000000000000000000000000000000000000000000000000000000000000001e4d45444f4f5a412045636f73797374656d2076322e30206f6e2078446169000000000000000000000000000000000000000000000000000000000000000000044d445a41000000000000000000000000000000000000000000000000000000000000000000000000000000'
value:
type: string
example: '0x0'
RawTraceCreateResult:
type: object
required:
- address
- code
- gasUsed
properties:
address:
type: string
example: '0xf57b55b01b831e602e09674a4e5d69cbcf343f98'
code:
type: string
example: '0x25D3FC'
gasUsed:
type: string
example: '0x25D3FC'
InternalTransaction:
type: object
required:
- block_number
- created_contract
- error
- from
- gas_limit
- index
- success
- timestamp
- to
- transaction_hash
- type
- value
properties:
block_number:
type: integer
example: 8844586
created_contract:
$ref: '#/components/schemas/AddressParam'
error:
type: string
example: reverted
from:
$ref: '#/components/schemas/AddressParam'
gas_limit:
type: string
example: '351759'
index:
type: integer
example: 1
success:
type: boolean
example: true
timestamp:
type: string
example: '2023-04-17T10:37:12.000000Z'
to:
$ref: '#/components/schemas/AddressParam'
transaction_hash:
type: string
example: '0x08ea4d75ad0abe327a7fd368733eaeac43077989e635d800530d7906ebf3bd54'
type:
type: string
example: call
value:
type: string
example: '30000000000000000'
RawTraceSelfDestructAction:
type: object
required:
- address
- balance
- refundAddress
properties:
address:
type: string
example: '0xf57b55b01b831e602e09674a4e5d69cbcf343f98'
balance:
type: string
example: '0x25D3FC'
refundAddress:
type: string
example: '0x162e898bd0aacb578c8d5f8d6ca588c13d2a383f'
Summary:
type: object
required:
- summary_template
- summary_template_variables
properties:
summary_template:
type: string
example: '{action_type} of {amount} {token}'
description: Summary template
summary_template_variables:
$ref: '#/components/schemas/SummaryTemplateVariables'
description: Variables for summary
NFTChange:
required:
- direction
- total
properties:
direction:
type: string
example: from | to
total:
$ref: '#/components/schemas/TotalERC721'
TotalERC1155:
required:
- token_id
- decimals
- value
properties:
token_id:
type: string
example: '1'
decimals:
type: string
example: null
value:
type: string
example: '1000'
token_instance:
$ref: '#/components/schemas/NFTInstance'
TransactionActionAaveV3BSWRF:
required:
- data
- protocol
- type
properties:
data:
type: object
example:
amount: '1.289548595490270429'
symbol: AAVE
address: '0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9'
block_number: 1
protocol:
type: string
example: aave_v3
type:
type: string
example: borrow | supply | withdraw | repay | flash_loan
TokenInfoDetailed:
type: object
required:
- address
- circulating_market_cap
- decimals
- exchange_rate
- holders
- icon_url
- name
- symbol
- total_supply
- type
- volume_24h
properties:
address_hash:
type: string
example: '0xBEEF69Ac7870777598A04B2bd4771c71212E6aBc'
description: Token Address
circulating_market_cap:
type: string
example: '0.0'
description: Token circulating market cap
decimals:
type: string
example: '18'
description: Token decimals
exchange_rate:
type: string
example: '2890.96'
description: Token exchange rate
holders_count:
type: string
example: '2999'
description: Token holders amount
icon_url:
type: string
example: https://assets.coingecko.com/coins/images/39410/small/Steakhouse_logo-05.jpg?1722053893
description: 'Token image URL '
name:
type: string
example: Steakhouse Resteaking Vault
description: Token name
symbol:
type: string
example: steakLRT
description: Token symbol
total_supply:
type: string
example: '9710057205959239302188'
description: Token total supply
type:
type: string
example: ERC-20
description: Token type
volume_24h:
type: string
example: '24298.765344836862'
description: Token trading volume for past 24h
TokenTransfer:
type: object
required:
- block_hash
- from
- log_index
- to
- token
- total
- transaction_hash
- type
properties:
block_hash:
type: string
example: '0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a'
from:
$ref: '#/components/schemas/AddressParam'
log_index:
type: integer
example: 16
method:
type: string
example: transfer
timestamp:
type: string
example: '2023-07-03T20:09:59.000000Z'
to:
$ref: '#/components/schemas/AddressParam'
token:
$ref: '#/components/schemas/TokenInfo'
total:
oneOf:
- $ref: '#/components/schemas/TotalERC20'
- $ref: '#/components/schemas/TotalERC721'
- $ref: '#/components/schemas/TotalERC1155'
transaction_hash:
type: string
example: '0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592'
type:
type: string
example: token_transfer
WatchlistName:
type: object
required:
- display_name
- label
properties:
display_name:
type: string
example: name to show
label:
type: string
example: label
RawTrace:
type: object
required:
- action
- subtraces
- traceAddress
- type
properties:
action:
oneOf:
- $ref: '#/components/schemas/RawTraceCallAction'
- $ref: '#/components/schemas/RawTraceCreateAction'
- $ref: '#/components/schemas/RawTraceSelfDestructAction'
subtraces:
type: integer
example: 0
traceAddress:
type: array
items:
type: integer
example:
- 0
- 0
type:
type: string
example: call
error:
type: string
example: Reverted
result:
oneOf:
- $ref: '#/components/schemas/RawTraceCallResult'
- $ref: '#/components/schemas/RawTraceCreateResult'
TokenInfo:
type: object
required:
- address
- circulating_market_cap
- icon_url
- symbol
- name
- decimals
- type
- holders
- exchange_rate
- total_supply
properties:
circulating_market_cap:
type: string
example: '83606435600.3635'
icon_url:
type: string
example: https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png
name:
type: string
example: Tether USD
decimals:
type: string
example: '6'
symbol:
type: string
example: USDT
address_hash:
type: string
example: '0x394c399dbA25B99Ab7708EdB505d755B3aa29997'
type:
type: string
example: ERC-20
holders_count:
type: string
example: '837494234523'
exchange_rate:
type: string
example: '0.99'
total_supply:
type: string
example: '10000000'
TransactionActionAaveV3EnableDisableCollateral:
required:
- data
- protocol
- type
properties:
data:
type: object
example:
symbol: AAVE
address: '0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9'
block_number: 1
protocol:
type: string
example: aave_v3
type:
type: string
example: enable_collateral | disable_collateral
TransactionAction:
oneOf:
- $ref: '#/components/schemas/TransactionActionAaveV3LiquidationCall'
- $ref: '#/components/schemas/TransactionActionAaveV3BSWRF'
- $ref: '#/components/schemas/TransactionActionAaveV3EnableDisableCollateral'
- $ref: '#/components/schemas/TransactionActionUniswapV3MintNFT'
- $ref: '#/components/schemas/TransactionActionUniswapV3BCS'
ERC20Or1155OrCoinChange:
type: string
example: '-10000000'
SummaryTemplateVariables:
type: object
required:
- action_type
- amount
- token
properties:
action_type:
$ref: '#/components/schemas/SummaryVariable'
description: Action type
amount:
$ref: '#/components/schemas/SummaryVariableCurrency'
description: Amount
token:
$ref: '#/components/schemas/SummaryVariableToken'
description: Token info
TotalERC721:
required:
- token_id
properties:
token_id:
type: string
example: '1'
token_instance:
$ref: '#/components/schemas/NFTInstance'
SummaryVariableToken:
type: object
required:
- type
- value
properties:
type:
type: string
example: token
description: Type
value:
$ref: '#/components/schemas/TokenInfoDetailed'
description: Token info
TransactionSummaryObj:
type: object
properties:
summaries:
type: array
items:
$ref: '#/components/schemas/Summary'
TransactionActionAaveV3LiquidationCall:
required:
- data
- protocol
- type
properties:
data:
type: object
example:
debt_amount: '1.289548595490270429'
debt_symbol: AAVE
debt_address: '0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9'
collateral_amount: '110.824768'
collateral_symbol: USDC
collateral_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
block_number: 1
protocol:
type: string
example: aave_v3
type:
type: string
example: liquidation_call
Fee:
type: object
required:
- type
- value
properties:
type:
type: string
example: maximum | actual
value:
type: string
example: '9853224000000000'
NFTChangesArray:
type: array
items:
$ref: '#/components/schemas/NFTChange'
SummaryVariable:
type: object
required:
- type
- value
properties:
type:
type: string
example: string
description: Variable type
value:
type: string
example: Registered withdrawal of
description: Action Type
TransactionActionUniswapV3BCS:
required:
- data
- protocol
- type
properties:
dat
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/blockscout/refs/heads/main/openapi/blockscout-transactions-api-openapi.yml