Search transactions

POST 
/ronin/txs/search

Search transactions.

Authorized access required.

To use this endpoint, you need to request access to the Skynet Tx Query service through Developer Console > your app > App Permissions. For more information, see Request access to services.

Request

*/*

Body

required

Request body

address object

from string

Optional, searching for from equal to ...

relateTo string

Optional, searching for from or to equal to ...

to string

Optional, searching for to equal to ...

block object

The default search is by blockHash. If blockHash doesn't appear, then search for blockRange. Max allowed blockRange is 200.

blockHash string

Optional, searching for the exact block.

blockRange integer[]

Optional, searching for blocks from from to to. If from equals to, then search exactly by block number.

paging object

Only offset or cursor need to be present.

cursor string

limit integer

Possible values: <= 200

offset integer

Possible values: <= 10000

pagingStyle string

Possible values: [cursor, offset]

If pagingStyle is not cursor, then it's offset.

sort object[]
Possible values: <= 1
Optional, valid sort fieldNames: timestamp
Array [
fieldName stringrequired
order string
]
txTypes string[]required

Possible values: [transfer_ron], <= 1

Optional, tx_type has only one accepted value: transfer_ron.

Responses

200

OK

application/json

Schema

Schema

items object[]
Array [
blockHash string
blockNumber integer
blockStatus string
blockTime integer
chainId string
contractAddress string
cumulativeGasUsed integer
effectiveGasPrice string
expiredTime integer
from string
gas integer
gasPrice string
gasUsed integer
input string
logs object[]
Array [
address integer[]
blockHash integer[]
blockNumber integer
blockTime string
data string
logIndex integer
logParam1 integer[]
logParam2 integer[]
logParam3 integer[]
logTopic integer[]
publishedTime string
removed boolean
transactionHash integer[]
transactionIndex integer
]
logsBloom string
maxFeePerGas string
maxPriorityFeePerGas string
nonce integer
payer string
payerR string
payerS string
payerV string
r string
s string
status integer
to string
transactionHash string
transactionIndex integer
type integer
v string
value string
]
paging object
nextCursor string
total integer

Example (from schema)

{
  "items": [
    {
      "blockHash": "string",
      "blockNumber": 0,
      "blockStatus": "string",
      "blockTime": 0,
      "chainId": "string",
      "contractAddress": "string",
      "cumulativeGasUsed": 0,
      "effectiveGasPrice": "string",
      "expiredTime": 0,
      "from": "string",
      "gas": 0,
      "gasPrice": "string",
      "gasUsed": 0,
      "input": "string",
      "logs": [
        {
          "address": [
            0
          ],
          "blockHash": [
            0
          ],
          "blockNumber": 0,
          "blockTime": "string",
          "data": "string",
          "logIndex": 0,
          "logParam1": [
            0
          ],
          "logParam2": [
            0
          ],
          "logParam3": [
            0
          ],
          "logTopic": [
            0
          ],
          "publishedTime": "string",
          "removed": true,
          "transactionHash": [
            0
          ],
          "transactionIndex": 0
        }
      ],
      "logsBloom": "string",
      "maxFeePerGas": "string",
      "maxPriorityFeePerGas": "string",
      "nonce": 0,
      "payer": "string",
      "payerR": "string",
      "payerS": "string",
      "payerV": "string",
      "r": "string",
      "s": "string",
      "status": 0,
      "to": "string",
      "transactionHash": "string",
      "transactionIndex": 0,
      "type": 0,
      "v": "string",
      "value": "string"
    }
  ],
  "paging": {
    "nextCursor": "string",
    "total": 0
  }
}

400

Invalid parameter

application/json

Schema

Schema

errorCode integer
message string

Example (from schema)

{
  "errorCode": 0,
  "message": "string"
}

500

Internal server error

application/json

Schema

Schema

errorCode integer
message string

Example (from schema)

{
  "errorCode": 0,
  "message": "string"
}

Loading...