Ontology Developer Center
v2.5
DISCOVERAPPLICATIONSCOMMUNITYSUPPORT
Search
⌃K
Links

Transactions

APIs to obtain transaction related details

Transaction type

Value
Type
Description
208
int
deploy smart contract
209
int
invoke neovm smart contract
210
int
invoke wasmvm smart contract

Description

Value
Type
Description
transfer
String
transfer
gasconsume
String
consumed gas
ontId-
String
Ont ID
claimRecord-
String
claim Record
auth
String
authorization
{"NeedStorage":true, ...}
String
If the transaction type is 208, the filed content is the description of the contract

Event Type

Value
Type
Description
0
int
others
1
int
deploy contract
2
int
gas consumed
3
int
transfer
4
int
ONT ID
5
int
claim record
6
int
authorization

1. Get latest transaction list

url: /v2/latest-transactions?count=10,
method: GET,
params: {
},
successResponse: {
"code":0,
"msg":"SUCCESS",
"result":[
{
"tx_hash":"9762458cd30612509f7c...a010ccc7b347057eb5",
"tx_type":209,
"tx_time":1522210288,
"block_height":1212,
"confirm_flag":1,
"block_index":1,
"fee":"0.01"
}
]
}
Url RequestField
Type
Description
count
int
number of latest transactions (count is limited between 1 and 50)
ResponseField
Type
Description
tx_hash
String
transaction hash
tx_type
int
transaction type (208/209/210)
tx_time
int
UNIX time of the transaction
block_height
int
block height
confirm_flag
int
transaction state on the blockchain, 0:failure 1:success
block_index
int
The index of transactions within a block
fee
String
fee

2. Get transaction list by page

url：/v2/transactions?page_size=10&page_number=1,
method：GET,
successResponse：{
"code":0,
"msg":"SUCCESS",
"result":{
"records":[
{
"tx_hash":"9762458cd30612509f7c...a010ccc7b347057eb5",
"tx_type":209,
"tx_time":1522210288,
"block_height":1212,
"confirm_flag":1,
"block_index":1,
"fee":"0.01"
}
],
"total":23449
}
}
Url RequestField
Type
Description
page_size
int
number of records in one page (limited between 1 and 20)
page_number
int
page number (atleast 1 or greater)
ResponseField
Type
Description
total
int
total transactions
tx_hash
String
transaction hash
tx_type
int
transaction type (208/209/210)
tx_time
int
UNIX time of the transaction
block_height
int
block height
confirm_flag
int
transaction state on the blockchain, 0:failure 1:success
block_index
int
The index of transactions within a block
fee
String
transaction fee

3. Get latest non-ontid transaction list

url: /v2/latest-nonontid-transactions?count=10,
method: GET,
params: {
},
successResponse: {
"code":0,
"msg":"SUCCESS",
"result":[
{
"tx_hash":"9762458cd30612509f7c...a010ccc7b347057eb5",
"tx_type":209,
"tx_time":1522210288,
"block_height":1212,
"confirm_flag":1,
"block_index":1,
"fee":"0.01"
}
]
}
Url RequestField
Type
Description
count
int
number of latest non-ontid transactions (limited between 1 and 50)
ResponseField
Type
Description
tx_hash
String
transaction hash
tx_type
int
transaction type (209/210)
tx_time
int
UNIX time of the transaction
block_height
int
block height
confirm_flag
int
transaction state on the blockchain, 0:failure 1:success
block_index
int
The index of transactions within a block
fee
String
transaction fee

4. Get non-ontid transaction list by page

url：/v2/nonontid-transactions?page_size=1&page_number=10,
method：GET,
successResponse：{
"code":0,
"msg":"SUCCESS",
"result":{
"records":[
{
"tx_hash":"9762458cd30612509f7c...a010ccc7b347057eb5",
"tx_type":209,
"tx_time":1522210288,
"block_height":1212,
"confirm_flag":1,
"block_index":1,
"fee":"0.01"
}
],
"total":23449
}
}
Url RequestField
Type
Description
page_size
int
number of records in one page (limited between 1 and 20)
page_number
int
page number (atleast 1 or greater)
ResponseField
Type
Description
total
int
total transactions
tx_hash
String
transaction hash
tx_type
int
transaction type (208/209/210)
tx_time
int
UNIX time of the transaction
block_height
int
block height
confirm_flag
int
transaction state on the blockchain, 0:failure 1:success
block_index
int
The index of transactions within a block
fee
String
fee

5. Get transaction detail by txhash

url：/v2/transactions/{tx_hash},
method：GET,
successResponse：{
"code":0,
"msg":"SUCCESS",
"result":{
"tx_hash":"000004c9903c338...ee5505e171e6d752dbd",
"tx_type":209,
"tx_time":1522210288,
"block_height":1212,
"confirm_flag":1,
"block_index":1,
"fee":"0.01",
"description":"transfer",
"event_type":3,
"detail":{
}
}
}
Url RequestField
Type
Description
tx_hash
String
transaction hash
ResponseField
Type
Description
tx_hash
String
transaction hash
tx_type
int
transaction type (208/209/210)
tx_time
int
UNIX time of the transaction
block_height
int
block height
confirm_flag
int
transaction state on the blockchain, 0:failure 1:success
block_index
int
The index of transactions within a block
fee
String
fee
description
String
transaction description for given ONT ID
event_type
int
event type reference
detail
Object
transaction detail

detail field

  • Deploy smart contract transaction
Smart contract detail in description filed
{
"detail":{}
}
  • Transfer transaction
{
"detail":{
"transfers": [
{
"amount": "0.02",
"from_address":"Aege6VvWEiKauFa2ngrtwdXt8FeGkWNPRH",
"to_address":"ATUD7W6t6tLPGgd8H9tCN6Kwkb9WKFddch",
"asset_name":"ont",
"contract_hash":"9762458cd30612509f7c...",
"description":"transfer"
}
]
}
}
ResponseField
Type
Description
transfers.asset_name
String
asset name
transfers.to_address
String
toaddres
transfers.from_address
String
fromaddress
transfers.amount
String
amount
transfers.description
String
transfer reference
transfers.contract_hash
String
contract hash
  • ONT ID transaction
{
"detail":{
"ontid":"did:ont:Ahctt129csbc612enxGTss6",
"description":"register OntId"
}
}
ResponseField
Type
Description
ontid
String
ONT ID
description
String
transaction description for given ONT ID

6. Get transaction input data

Returns input data and contract abi (if exists) for EVM transactions. Returns input data and resolution results of responses (if can be resolved) for naive and neoVM transactions.
url：/v2/transactions/input-data/{txHash}
method：GET
URL Request Parameter
Type
Description
txHash
String
transaction hash
Example Response
Returns from the EVM:
{
"code": 0,
"msg": "SUCCESS",
"result": {
"original_view": "0xa9059cbb000000000000000000000000d0efc52b329699a071be1b0745fcc0dc5cfd0d600000000000000000000000000000000000000000000000000000000000989680",
"abi": "[{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousOwner\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"OwnershipTransferred\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"owner\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"renounceOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newOwner\",\"type\":\"address\"}],\"name\":\"transferOwnership\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]"
}
}
Resolution results of native VM and neoVM transactions:
{
"code": 0,
"msg": "SUCCESS",
"result": {
"original_view": "00c66b149b27fff7d06c214f4f4ae2e13ec844a9ea7a46636a7cc814a68d0c9ef4806f6e67a5e5b168af3afa1a452be06a7cc80400d8c1426a7cc86c51c10a7472616e7366657256321400000000000000000000000000000000000000010068164f6e746f6c6f67792e4e61746976652e496e766f6b65",
"default_view": {
"function": "transferV2(Address from,Address to,Long value)",
"method_id": "7472616e736665725632",
"params": [
"9b27fff7d06c214f4f4ae2e13ec844a9ea7a4663",
"a68d0c9ef4806f6e67a5e5b168af3afa1a452be0",
"00d8c142"
]
},
"decode": [
{
"name": "from",
"type": "Address",
"data": [
"AVvGJULMaKwvJvKpQSN7s5PU7mVz4hKJim"
]
},
{
"name": "to",
"type": "Address",
"data": [
"AWxWncsrqnUL6oWhmpL1QkLL7echaD9JEs"
]
},
{
"name": "value",
"type": "Long",
"data": [
1120000000
]
}
]
}
}
Returns for wasmVM transactions and transactions that can't be resolved:
{
"code": 0,
"msg": "SUCCESS",
"result": {
"original_view": "438f52b0e107dc0d79f0b7b2ee3fde304a922f6b4e0b6f72633230546f4f657034acae7a1a3ca81df404c312b57a520a52006fc7a79899b83824870f81a4f25879e49f720f266657f000bca0650100000000000000000000000957494e472d57494e47"
}
}
Response Parameter
Type
Description
original_view
String
original input data
abi
String
contract abi, returns when query is for EVM transactions and contract abi exists, otherwise this field is not returned
default_view
Map
default view of the corresponding page, only returns when resolution is successful
decode
List
resolution result, only returns when resolution is successful
Previous
Token
Next
ONT ID
Last modified 5mo ago