- Intro
- History
- State
- Tokens
- Submit new transaction
Blocks
POST
https://api.trait.tech/history/blocks
History
Request params allows to filter blocks by various properties, such as block index, block time, and block hash.
Response contains list of matched blocks, transactions included into blocks, events generated by the blocks.
Request
Body Params application/json
Request
Any of
/history/blocks.Example:
{"block_receipt":{"block_index":{"max":"blockchain_head"}},"presentation":{"sorting":"time_ascending","include_transactions":false,"include_events":false}}
block_receipt
object
FilterBlockReceipt
presentation
object
HistoryBlocksPresentation
/history/blocks.Example
{
"block_receipt": {
"block_index": {
"max": "blockchain_head"
}
},
"presentation": {
"sorting": "time_ascending",
"include_transactions": false,
"include_events": false
}
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.trait.tech/history/blocks' \
--header 'Content-Type: application/json' \
--data-raw '{
"block_receipt": {
"block_index": {
"max": "blockchain_head"
}
},
"presentation": {
"sorting": "time_ascending",
"include_transactions": false,
"include_events": false
}
}'Responses
🟢200OK
application/json
Body
Response schema for the endpoint `/history/blocks`.
metadata
object (ResponseMetadataPaged)
required
request_context
object (ResponseBlockId)
required
blockchain_head
object (ResponseBlockId)
required
pagination
object (ResponsePaginationData)
required
data
array[object (Block) {3}]
Data
receipt
object (BlockReceipt)
required
transactions
array[object (Transaction) {3}]
Transactions
non_tx_events
array[object (EventNonTx) {2}]
Non Tx Events
Example
{
"metadata": {
"request_context": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000
},
"blockchain_head": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000
},
"pagination": {
"current_page": 0,
"next_page_id": "109924cd-b827-4eb1-8901-1f45d2d753e9"
}
},
"data": [
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"runtime_version": {
"spec_version": 1000,
"impl_version": 0,
"transaction_version": 1,
"state_version": 1
},
"parent_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"extrinsics_root": "0xa20b4b3541fab465be2dfda5000ba78d9deb7a5b9c62003284816037269afa31",
"state_root": "0x8a754e69cd69efd5701570e793ba46c262f5d287015432e3cf0c7570e5442554",
"tx_number": 1,
"tx_events_number": 3,
"non_tx_events_number": 2
},
"transactions": [
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"tx_type": "signed",
"tx_hash": "0x4c9d18b01f98df18c8730230afb92be703be19f0884b86113e0e72251b806eb3",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_assets",
"tx_origin": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"tx_origin_nonce": 0,
"events_number": 3
},
"arguments": {
"id": 32,
"target": {
"address": "ttnHxmq7B2xwZnG28puQCw8kgxsXY4yKvucRzRHqJq2gftLW6",
"account_id": "0x3244dc7318398fe43dd214d0ffdd1f8d0603a73fc286f4d758caaf5bbfddf702",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"amount": 5
},
"events": [
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"tx_type": "signed",
"tx_hash": "0x4c9d18b01f98df18c8730230afb92be703be19f0884b86113e0e72251b806eb3",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_assets",
"tx_origin": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 1,
"event_module": "Assets",
"event_name": "Transferred",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"asset_id": 32,
"from": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"to": {
"address": "ttnHxmq7B2xwZnG28puQCw8kgxsXY4yKvucRzRHqJq2gftLW6",
"account_id": "0x3244dc7318398fe43dd214d0ffdd1f8d0603a73fc286f4d758caaf5bbfddf702",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"amount": 5
}
},
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"tx_type": "signed",
"tx_hash": "0x4c9d18b01f98df18c8730230afb92be703be19f0884b86113e0e72251b806eb3",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_assets",
"tx_origin": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 2,
"event_module": "TransactionPayment",
"event_name": "TransactionFeePaid",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"who": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"actual_fee": 0,
"tip": 0
}
},
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"tx_type": "signed",
"tx_hash": "0x4c9d18b01f98df18c8730230afb92be703be19f0884b86113e0e72251b806eb3",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_assets",
"tx_origin": {
"address": "ttrENnXUfsdTDFwweKjK1dSvCXcAtVVQ9xgARy8iBisAFfc5e",
"account_id": "0xe079a519da31f627a19daf986c30d63ea24c6ce8762a19487d88077aaf1cc033",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 3,
"event_module": "System",
"event_name": "ExtrinsicSuccess",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"dispatch_info": {
"weight": {
"ref_time": 452619073,
"proof_size": 6208
},
"class": {
"option": "Normal",
"payload": null
},
"pays_fee": {
"option": "No",
"payload": null
}
}
}
}
]
}
],
"non_tx_events": [
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"event_index": 0,
"event_module": "Balances",
"event_name": "Transfer",
"event_phase": "Initialization"
},
"attributes": {
"from": {
"address": "ttodYEVA917tPqpseDdLP4NhMJUkCQHJU4T7zcT4TCYM3PKxQ",
"account_id": "0x6d6f646c506f745374616b650000000000000000000000000000000000000000",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"to": {
"address": "ttn8KQhZ3gsKkryZoKWFdGnEV4C5WDhpyXinEVQVu1v2HA7Xs",
"account_id": "0x2ae9df7cc0678eb17e196ab2638689eefebfffe3c7c75b7f5bb8ccb501a25f7f",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"amount": 170
}
},
{
"receipt": {
"block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
"block_index": 29702,
"block_timestamp": 1727581488000,
"event_index": 6,
"event_module": "FreeTransfers",
"event_name": "BlockThresholdScoreUpdated",
"event_phase": "Finalization"
},
"attributes": {
"new_threshold": 3072140,
"halted_till_block": null
}
}
]
},
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"runtime_version": {
"spec_version": 1000,
"impl_version": 0,
"transaction_version": 1,
"state_version": 1
},
"parent_hash": "0xb021f3066d1bfef208178882820d0ee04c66166c2d8ab71bd15fe857e9d97023",
"extrinsics_root": "0xbf9344eb63836d6f46182e3b614908097b83726ed4a0a26392e4c47c9d780f5e",
"state_root": "0xb6dde656f5ee7c6da8695e917224a4f2144566c5163af678814ba4812df84bbb",
"tx_number": 1,
"tx_events_number": 3,
"non_tx_events_number": 2
},
"transactions": [
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"tx_type": "signed",
"tx_hash": "0x6d15b4f2e65d289450ebed790292a6e54c0c64e7b0217575113cc25de42fbabe",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_nfts",
"tx_origin": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"tx_origin_nonce": 144,
"events_number": 3
},
"arguments": {
"collection": 17,
"item": 754266,
"dest": {
"address": "ttnCSi8iaGuFXTRvdrzn17cVyUfnHeWqF91sdksdXB19V9y4j",
"account_id": "0x2e0f6e39e5306a3905d31c3edff91c53059ddfbd4ec7fe93ea515b5b3bad7e29",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
}
},
"events": [
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"tx_type": "signed",
"tx_hash": "0x6d15b4f2e65d289450ebed790292a6e54c0c64e7b0217575113cc25de42fbabe",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_nfts",
"tx_origin": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 1,
"event_module": "Nfts",
"event_name": "Transferred",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"collection": 17,
"item": 754266,
"from": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"to": {
"address": "ttnCSi8iaGuFXTRvdrzn17cVyUfnHeWqF91sdksdXB19V9y4j",
"account_id": "0x2e0f6e39e5306a3905d31c3edff91c53059ddfbd4ec7fe93ea515b5b3bad7e29",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
}
}
},
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"tx_type": "signed",
"tx_hash": "0x6d15b4f2e65d289450ebed790292a6e54c0c64e7b0217575113cc25de42fbabe",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_nfts",
"tx_origin": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 2,
"event_module": "TransactionPayment",
"event_name": "TransactionFeePaid",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"who": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"actual_fee": 0,
"tip": 0
}
},
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"tx_type": "signed",
"tx_hash": "0x6d15b4f2e65d289450ebed790292a6e54c0c64e7b0217575113cc25de42fbabe",
"tx_index": 2,
"tx_module": "PlayerTransfers",
"tx_function": "submit_transfer_nfts",
"tx_origin": {
"address": "ttmfeDNnbqZ2RwJou1L41qhJJuYrEgTNVfb6tYvrjDsGnjkhE",
"account_id": "0x16918cb054ffb795a293ecd4dbfd7d3b36a8dc30cc0d769f34d9e9983f403b53",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"event_index": 3,
"event_module": "System",
"event_name": "ExtrinsicSuccess",
"event_phase": "ApplyExtrinsic"
},
"attributes": {
"dispatch_info": {
"weight": {
"ref_time": 468294751,
"proof_size": 4326
},
"class": {
"option": "Normal",
"payload": null
},
"pays_fee": {
"option": "No",
"payload": null
}
}
}
}
]
}
],
"non_tx_events": [
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"event_index": 0,
"event_module": "Balances",
"event_name": "Transfer",
"event_phase": "Initialization"
},
"attributes": {
"from": {
"address": "ttodYEVA917tPqpseDdLP4NhMJUkCQHJU4T7zcT4TCYM3PKxQ",
"account_id": "0x6d6f646c506f745374616b650000000000000000000000000000000000000000",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"to": {
"address": "ttn8KQhZ3gsKkryZoKWFdGnEV4C5WDhpyXinEVQVu1v2HA7Xs",
"account_id": "0x2ae9df7cc0678eb17e196ab2638689eefebfffe3c7c75b7f5bb8ccb501a25f7f",
"address_type": "regular",
"app_agent_id": null,
"ta_id": null,
"address_name": null
},
"amount": 28394435621
}
},
{
"receipt": {
"block_hash": "0x825629604055537b62aedc82db1d214feb92d0bc7cef450f233e428bbf851403",
"block_index": 29701,
"block_timestamp": 1727581482000,
"event_index": 6,
"event_module": "FreeTransfers",
"event_name": "BlockThresholdScoreUpdated",
"event_phase": "Finalization"
},
"attributes": {
"new_threshold": 1734300,
"halted_till_block": null
}
}
]
}
]
}🟠422Parameter Error
Modified at 2024-11-21 18:59:09