Get Transaction Details by Hash
1. Overview & Typical Use
Query complete information for a single transaction by its hash, including contract data, resource consumption, and SR confirmation list.
- Typical use: transaction detail page display, transaction status tracking, resource consumption analysis.
- When not to use: for batch transaction queries use “Get Transaction List”; for transfer records use the corresponding transfer list endpoint.
2. Endpoint & Authentication
GET /api/transaction-info
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hash | string | Yes | — | Transaction hash |
source | string | No | — | Data source; when provided, records the query count for this hash in Redis |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
block | integer | Required | Block height | — |
hash | string | Required | Transaction hash | — |
timestamp | integer | Required | Block time | ms timestamp |
ownerAddress | string | Required | Initiator address (Base58, starts with T) | — |
toAddress | string | Required | Recipient address | — |
contractType | integer | Required | Contract type number | — |
contract_type | string | Required | Contract type description (e.g. trc20) | — |
confirmed | boolean | Required | Whether confirmed | — |
revert | boolean | Required | Whether reverted | — |
confirmations | integer | Required | Number of confirmed blocks | — |
contractRet | string | Required | Contract execution result (e.g. SUCCESS) | — |
contractData | object | Required | Contract call data; sub-fields see the contractData object table below | — |
cost | object | Required | Resource consumption details; see below | — |
data | string | Required | Raw transaction data (empty string for non-contract calls) | — |
riskTransaction | boolean | Required | Risk transaction flag | — |
noteLevel | integer | Required | Risk level annotation | — |
info | object | Required | Additional information (usually empty object) | — |
contract_map | object | Required | Address → whether it is a contract mapping (note: key is contract_map, not contractMap) | — |
normalAddressInfo | object | Required | Address → risk information | — |
addressTag | object | Required | Address tag mapping (may be empty object) | — |
hashTag | array | Required | Transaction hash tag list (may be empty array) | — |
signature_addresses | array | Required | Signing address list (may be empty array) | — |
trigger_info | object | Optional | Contract call method and parameters (only present for smart contract calls); sub-fields see the trigger_info object table below | — |
trc20TransferInfo | array | Optional | TRC20 transfer information list (only present when TRC20 transfers are involved); element schema see the trc20TransferInfo[] element table below | — |
transfersAllList | array | Optional | Unified list of all token transfers (includes TRC20/TRC10, etc.); element schema same as trc20TransferInfo[] | — |
tokenTransferInfo | object | Optional | Primary token transfer information (present for single transfers); schema same as trc20TransferInfo[] element | — |
internal_transactions | object | Required | Internal transactions; empty object {} when no internal calls, otherwise contains internal transaction data | — |
event_count | integer | Optional | Event count (present for smart contract calls) | — |
triggerContractType | integer | Optional | Trigger contract sub-type number | — |
project | string | Optional | Associated project name (present when the contract belongs to a known project) | — |
srConfirmList | array | Optional | SR confirmation list; element schema see the srConfirmList[] element table below | — |
contractInfo | object | Optional | Contract address → label information mapping (value schema below) | — |
toAddressTag | string | Optional | Recipient address label | — |
cheat_status | integer | Optional | Fraud status flag (observed value 0) | — |
fee_limit | integer | Optional | Fee limit (present for smart contract calls) | sun |
revertReason | string | Optional | Contract revert reason (only present when contractRet == "REVERT") | — |
trc20ApprovalInfo | array | Optional | TRC20 approval information list (only present for approval events) | — |
contractInfo[<addr>] object schema (8 fields):
| Field | Type | Required | Description |
|---|---|---|---|
tag1 | string | Required | Primary label (project name / contract name / exchange name) |
tag1Url | string | Required | URL of the primary label (may be an empty string) |
name | string | Required | Formal contract / project name |
isToken | boolean | Required | Whether it is a token contract (true / false) |
vip | boolean | Required | Whether it is a VIP entity (true / false) |
risk | boolean | string | Required | Risk label; most endpoints return boolean, some return a string risk type (blacklist / fraud, etc.) |
publicTagDesc | string | Required | Public label description; empty string for most accounts |
publicTag | string | Optional | Public label (e.g. "USDT Token" / "Binance"); returned only for well-known entities or certain endpoints |
cost object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
fee | integer | Required | Total fee | sun |
net_fee | integer | Required | Bandwidth fee | sun |
net_usage | integer | Required | Bandwidth consumed | bytes |
energy_fee | integer | Required | Energy fee | sun |
energy_usage | integer | Required | Caller energy consumed | — |
energy_usage_total | integer | Required | Total energy consumed | — |
origin_energy_usage | integer | Required | Contract owner energy consumed | — |
energy_penalty_total | integer | Required | Total energy penalty | — |
net_fee_cost | integer | Required | Bandwidth unit price (sun/byte) | sun/byte |
energy_fee_cost | integer | Required | Energy unit price (sun/energy) | sun/energy |
date_created | integer | Required | Transaction creation time | s timestamp |
multi_sign_fee | integer | Required | Multi-signature fee | sun |
memoFee | integer | Required | Memo fee | sun |
account_create_fee | integer | Optional | Account creation fee (present for new-account creation transactions) | sun |
contractData object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
owner_address | string | Required | Caller address (Base58 / Hex, depending on contract type) | — |
contract_address | string | Optional | Called contract address (present for smart contract calls) | — |
data | string | Optional | Call data (present for smart contract calls) | hex |
amount | integer | Optional | Amount sent with the call; contractType=1 (TRX transfer) → SUN; contractType=2 (TRC10 transfer) → token-smallest-unit, convert using tokenInfo.tokenDecimal | sun |
trigger_info object (present for smart contract calls)
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
method | string | Required | Method signature (e.g. transfer(address _to,uint256 _value)) | — |
methodId | string | Required | Method ID (4-byte hex, e.g. a9059cbb) | — |
parameter | object | Required | Parameter object; keys are parameter names (e.g. _to, _value), values are strings/numbers (depending on parameter type) | — |
contract_address | string | Required | Called contract address | — |
call_value | integer | Required | TRX amount sent with the call | sun |
trc20TransferInfo[] / transfersAllList[] / tokenTransferInfo element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
from_address | string | Required | Sender address (Base58) | — |
to_address | string | Required | Receiver address (Base58) | — |
contract_address | string | Required | Token contract address (token id for TRC10) | — |
amount_str | string | Required | Transfer amount (raw value, not divided by decimals) | — |
decimals | integer | Required | Token decimals | — |
name | string | Required | Token full name (e.g. Tether USD) | — |
symbol | string | Required | Token symbol (e.g. USDT) | — |
type | string | Required | Transfer type (e.g. Transfer, Approval) | — |
status | integer | Required | Status code (0 = success) | — |
tokenType | string | Required | Token type (trc20/trc10/trc721/trc1155) | — |
tokenType2 | string | Required | Token type (compatibility field, same value as tokenType) | — |
level | string | Required | Token level: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE) | — |
icon_url | string | Required | Token logo URL | — |
vip | boolean | Required | Whether this is a VIP token | — |
srConfirmList[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
address | string | Required | SR address (Base58) | — |
name | string | Required | SR name | — |
block | integer | Required | Block height that confirmed this transaction | — |
url | string | Required | SR official website URL | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Invalid hash: an unknown hash returns
200+ empty object{}, not a 4xx error.
Last updated on: