openapi: 3.0.3 info: title: Chainstack TRON Node API version: 1.0.0 description: Chainstack-managed RPC node API for the TRON blockchain. Endpoints follow the canonical JSON-RPC over HTTPS interface for the network. Authenticate against your Chainstack node's per-node URL (e.g. https://nd-XXX-XXX-XXX.p2pify.com/). Merged from the Chainstack Developer Portal per-method fragments at https://github.com/chainstack/dev-portal/tree/main/openapi/tron_node_api. contact: name: Chainstack API Support email: support@chainstack.com license: name: Chainstack Terms url: https://chainstack.com/terms-of-service/ servers: - url: https://{node_id}.p2pify.com/{api_key} description: Chainstack-managed node endpoint variables: node_id: default: nd-000-000-000 description: Your Chainstack node identifier api_key: default: description: Per-node access key tags: - name: General paths: /accountpermissionupdate: post: tags: - General summary: Wallet/Accountpermissionupdate operationId: accountPermissionUpdate requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g owner: type: object properties: type: type: integer default: 0 permission_name: type: string default: owner threshold: type: integer default: 1 keys: type: array items: type: object properties: address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: type: integer default: 1 default: - address: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: 1 witness: type: object properties: type: type: integer default: 1 permission_name: type: string default: witness threshold: type: integer default: 1 keys: type: array items: type: object properties: address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: type: integer default: 1 default: - address: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: 1 actives: type: array items: type: object properties: type: type: integer default: 2 permission_name: type: string default: active threshold: type: integer default: 1 operations: type: string description: 32-byte hex bitmask of allowed operations default: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF keys: type: array items: type: object properties: address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: type: integer default: 1 default: - address: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: 1 default: - type: 2 permission_name: active threshold: 1 operations: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF keys: - address: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g weight: 1 visible: type: boolean default: true responses: '200': description: Unsigned account permission update transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object raw_data_hex: type: string /broadcasthex: post: tags: - General summary: Wallet/Broadcasthex operationId: broadcastHex requestBody: required: true content: application/json: schema: type: object properties: transaction: type: string description: The transaction data in hexadecimal format required: - transaction example: transaction: 0a84010a025e4b220847c9dc89341b300d40f8fed3a2a72e5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541608f8da72479edc7dd921e4c30bb7e7cddbe722e121541e9d79cc47518930bc322d9bf7cddd260a0260a8d18e8077093afd0a2a72e1241deadbeefcafebabefacec0011234abcd0badf00d9999777755553333222211114321dcba0f0ff0f013579bdf2468ace0987654321a2b3c4d5e6f7a8b9c0deeff1b responses: '200': description: Transaction broadcast result content: application/json: schema: type: object properties: result: type: boolean description: Whether the broadcast was successful txid: type: string description: Transaction ID if successful message: type: string description: Status message /broadcasttransaction: post: tags: - General summary: Wallet/Broadcasttransaction operationId: broadcastTransaction requestBody: required: true content: application/json: schema: type: object required: - raw_data - raw_data_hex properties: raw_data: type: object default: contract: - parameter: value: amount: 1000 owner_address: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e to_address: 41e9d79cc47518930bc322d9bf7cddd260a0260a8d type_url: type.googleapis.com/protocol.TransferContract type: TransferContract ref_block_bytes: 5e4b ref_block_hash: 47c9dc89341b300d expiration: 1591089627000 timestamp: 1591089567635 raw_data_hex: type: string default: 0a025e4b220847c9dc89341b300d40f8fed3a2a72e5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541608f8da72479edc7dd921e4c30bb7e7cddbe722e121541e9d79cc47518930bc322d9bf7cddd260a0260a8d18e8077093afd0a2a72e signature: type: array description: Array of hex-encoded signatures (65-byte secp256k1). items: type: string default: - deadbeefcafebabefacec0011234abcd0badf00d9999777755553333222211114321dcba0f0ff0f013579bdf2468ace0987654321a2b3c4d5e6f7a8b9c0deeff1b visible: type: boolean default: false responses: '200': description: Transaction broadcast result content: application/json: schema: type: object properties: result: type: boolean code: type: string message: type: string txid: type: string /cancelallunfreezev2: post: tags: - General summary: Wallet/Cancelallunfreezev2 operationId: cancelAllUnfreezeV2 requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Unsigned cancel all unfreeze transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object raw_data_hex: type: string /clearabi: post: tags: - General summary: Wallet/Clearabi operationId: clearAbi requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address of the contract owner contract_address: type: string description: Address of the smart contract visible: type: boolean description: Whether to use visible (Base58) address format required: - owner_address - contract_address example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC contract_address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t visible: true responses: '200': description: Contract ABI clearing transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the ABI clearing raw_data: type: object properties: contract: type: array description: Contract ABI clearing details ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /createaccount: post: tags: - General summary: Wallet/Createaccount operationId: createAccount requestBody: required: true content: application/json: schema: type: object required: - owner_address - account_address properties: owner_address: type: string description: The existing account that pays the account creation fee. Must have sufficient TRX. default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g account_address: type: string description: The new account address to be activated. default: TFgY1uN8buRxAtV2r6Zy5sG3ACko6pJT1y visible: type: boolean description: When true, addresses are base58; when false, hex. default: true responses: '200': description: Unsigned account creation transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object raw_data_hex: type: string '400': description: Validation error (e.g., insufficient fee) content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.ContractValidateException : Validate CreateAccountActuator error, insufficient fee.' /createassetissue: post: tags: - General summary: Wallet/Createassetissue operationId: createAssetIssue requestBody: required: true content: application/json: schema: type: object required: - owner_address - name - abbr - total_supply - trx_num - num - start_time - end_time - description - url properties: owner_address: type: string description: Address that will issue the token default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g name: type: string description: Token name default: MyToken abbr: type: string description: Token symbol/abbreviation default: MTK total_supply: type: integer description: Total supply of tokens default: 1000000000000 trx_num: type: integer description: TRX amount for exchange rate default: 1 num: type: integer description: Token amount for exchange rate default: 1000 precision: type: integer description: Token decimal places (0-6) default: 6 start_time: type: integer description: ICO start time (timestamp) default: 1640995200000 end_time: type: integer description: ICO end time (timestamp) default: 1672531200000 description: type: string description: Token description default: A new TRC10 token for the TRON ecosystem url: type: string description: Token project website default: https://example.com free_asset_net_limit: type: integer description: Free bandwidth for token operations default: 1000000 public_free_asset_net_limit: type: integer description: Public free bandwidth limit default: 1000000 frozen_supply: type: array description: Frozen supply configurations items: type: object properties: frozen_amount: type: integer frozen_days: type: integer visible: type: boolean description: Use base58 address format default: true responses: '200': description: Unsigned TRC10 asset issue transaction content: application/json: schema: type: object properties: visible: type: boolean description: Address format indicator txID: type: string description: Transaction hash raw_data: type: object description: Raw transaction data properties: contract: type: array description: Contract array ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp fee_limit: type: number description: Maximum fee allowed raw_data_hex: type: string description: Hexadecimal raw transaction /createshieldedcontractparameters: post: tags: - General summary: Wallet/Createshieldedcontractparameters operationId: createShieldedContractParameters requestBody: required: true content: application/json: schema: type: object required: - spend_authority_signature - view_signature - proof_generation_key - payment_address - rcm - ar - alpha - rsk - ask properties: spend_authority_signature: type: string description: Spending authority signature (128 hex characters, no 0x prefix) example: 08a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890 view_signature: type: string description: View signature component (64 hex characters, no 0x prefix) example: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b proof_generation_key: type: string description: Proof generation key (64 hex characters, no 0x prefix) example: 2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3 payment_address: type: string description: Recipient's shielded payment address (ztron1 format, 78 characters) example: ztron1768kf7dy4qquefp46szk978d65eeua66yhr4zv260c0uzj68t3tfjl3en9lhyyfxalv4jus30xs rcm: type: string description: Randomness commitment value (64 hex characters, no 0x prefix) example: 3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4 ar: type: string description: Authentication randomness value (64 hex characters, no 0x prefix) example: 4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5 alpha: type: string description: Alpha parameter for proof generation (64 hex characters, no 0x prefix) example: 5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6 rsk: type: string description: Randomness for spending key (64 hex characters, no 0x prefix) example: 6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7 ask: type: string description: Authentication secret key (64 hex characters, no 0x prefix) example: 7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8 responses: '200': description: Successfully created shielded contract parameters content: application/json: schema: type: object properties: receive_description: type: object description: Receive description for shielded transaction spend_description: type: object description: Spend description for shielded transaction binding_signature: type: string description: Binding signature for transaction /createshieldedcontractparameterswithoutask: post: tags: - General summary: Wallet/Createshieldedcontractparameterswithoutask operationId: createShieldedContractParametersWithoutAsk requestBody: required: true content: application/json: schema: type: object required: - ovk - from_address - to_address - amount properties: ovk: type: string description: Outgoing viewing key (64 hex characters, no 0x prefix) example: 09b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1 from_address: type: string description: Sender's shielded address example: ztron1a2b3c4d5e6f7g8h9j0k1l2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f1g2h3j4k5l6m7n8p9 to_address: type: string description: Recipient's shielded address example: ztron1z9y8x7w6v5u4t3s2r1q0p9n8m7l6k5j4h3g2f1e0d9c8b7a6z5y4x3w2v1u0t9s8r7q6p5n4m3 amount: type: string description: Amount to transfer example: '1000000' transparent_from_address: type: string description: Optional transparent sender address example: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE transparent_to_address: type: string description: Optional transparent recipient address example: TXYZoPYKcJJvXWc2WqJcqWvHqCqvqP5h3X responses: '200': description: Successfully created shielded contract parameters content: application/json: schema: type: object properties: receive_description: type: object description: Receive description for shielded transaction spend_description: type: object description: Spend description for shielded transaction binding_signature: type: string description: Binding signature for transaction /createspendauthsig: post: tags: - General summary: Wallet/Createspendauthsig operationId: createSpendAuthSig requestBody: required: true content: application/json: schema: type: object required: - ask - alpha - tx_hash properties: ask: type: string description: Authentication secret key for signing (32 bytes, hex without 0x prefix) example: 0f63eabdfe2bbfe08012f6bb2db024e6809c16e8ed055aa41a6095424f192005 alpha: type: string description: Alpha parameter for randomization (32 bytes, hex without 0x prefix) example: d0f0768664f5c807f9e70d05993f029c71da529afaa5c037b44c63d6e13bc907 tx_hash: type: string description: Transaction hash being authorized (32 bytes, hex without 0x prefix) example: 7fb99e66df052f430d50e80a3f197c319a4e35184ed48a433d6219e025741337 responses: '200': description: Successfully created spending authorization signature content: application/json: schema: type: object properties: value: type: string description: Generated spending authorization signature (hex string without 0x prefix) example: 66c806bc592a7599e65833bf25c3c7005c8b21b7895dd835a84c97d7bec49d0f1493d2c73a68eeb9b9699b92cae42406f9e44ebe19acaea3d5febfe28de57109 /createtransaction: post: tags: - General summary: Wallet/Createtransaction operationId: createTransaction requestBody: required: true content: application/json: schema: type: object required: - to_address - owner_address - amount properties: to_address: type: string default: 41e9d79cc47518930bc322d9bf7cddd260a0260a8d owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e amount: type: integer default: 1000 visible: type: boolean default: false responses: '200': description: Unsigned transaction object content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string /createwitness: post: tags: - General summary: Wallet/Createwitness operationId: createWitness requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: 'Address that will become a witness. Use base58 with `visible: true`, or hex with `visible: false`.' url: type: string description: Witness website URL (must be a valid URL) visible: type: boolean description: When true, addresses are base58; when false, hex. default: true required: - owner_address - url example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC url: https://mywitness.example.com visible: true responses: '200': description: Witness creation transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for witness creation raw_data: type: object properties: contract: type: array description: Contract details for witness creation ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /delegateresource: post: tags: - General summary: Wallet/Delegateresource operationId: delegateResource requestBody: required: true content: application/json: schema: type: object required: - owner_address - receiver_address - balance - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e receiver_address: type: string default: 41e9d79cc47518930bc322d9bf7cddd260a0260a8d balance: type: integer default: 1000000 resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH lock: type: boolean default: false lock_period: type: integer default: 0 visible: type: boolean default: false responses: '200': description: Resource delegation transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string /deploycontract: post: tags: - General summary: Wallet/Deploycontract operationId: deployContract requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address deploying the contract in hex format abi: type: string description: Contract ABI (Application Binary Interface) as JSON string bytecode: type: string description: Contract bytecode in hex format parameter: type: string description: Constructor parameters encoded in hex format call_value: type: number description: Amount of TRX to transfer to contract (in SUN) consume_user_resource_percent: type: number description: Percentage of caller's resources used (0-100) fee_limit: type: number description: Maximum energy fee willing to pay (in SUN) origin_energy_limit: type: number description: Energy limit provided by contract creator name: type: string description: Human-readable contract name required: - owner_address - abi - bytecode example: owner_address: 41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b abi: '[{"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"type":"function"}]' bytecode: 608060405234801561001057600080fd5b5061012a806100206000396000f3fe6080604052 parameter: '' call_value: 0 consume_user_resource_percent: 100 fee_limit: 1000000000 origin_energy_limit: 10000000 name: MyContract responses: '200': description: Contract deployment transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID of the deployment raw_data: type: object description: Raw transaction data raw_data_hex: type: string description: Raw transaction data in hex format /estimateenergy: post: tags: - General summary: Wallet/Estimateenergy operationId: estimateEnergy requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address executing the contract call contract_address: type: string description: Address of the smart contract function_selector: type: string description: Function signature to call parameter: type: string description: Hex-encoded parameters for the function visible: type: boolean description: Whether to use visible (Base58) address format required: - owner_address - contract_address - function_selector - parameter example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC contract_address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t function_selector: balanceOf(address) parameter: 000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c visible: true responses: '200': description: Energy consumption estimation content: application/json: schema: type: object properties: result: type: object properties: result: type: boolean description: Whether estimation was successful energy_required: type: number description: Estimated energy consumption energy_used: type: number description: Total energy that would be consumed constant_result: type: array description: Return values for view/pure functions transaction: type: object description: Transaction object with estimated costs /exchangecreate: post: summary: Create a new exchange trading pair description: Creates a new trading pair on the TRON decentralized exchange with initial liquidity provision operationId: exchangeCreate requestBody: required: true content: application/json: schema: type: object required: - owner_address - first_token_id - first_token_balance - second_token_id - second_token_balance properties: owner_address: type: string description: The address that will own and control the exchange pair first_token_id: type: string description: Token ID of the first token in the trading pair first_token_balance: type: integer description: Initial balance to provide for the first token (integer amount in the token's base units) second_token_id: type: string description: Token ID of the second token in the trading pair. Use '_' to denote TRX. second_token_balance: type: integer description: Initial balance to provide for the second token (integer amount; if TRX, specify in sun) permission_id: type: integer description: Optional permission ID for multi-signature accounts visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: "Create TRC10\u2013TRX exchange pair" value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH first_token_id: '1000001' first_token_balance: 1000000000000 second_token_id: _ second_token_balance: 5000000000 visible: true responses: '200': description: Successful response with transaction details content: application/json: schema: type: object properties: txID: type: string description: Unique transaction identifier raw_data: type: object description: Raw transaction data including contract details properties: contract: type: array items: type: object properties: parameter: type: object properties: value: type: object properties: owner_address: type: string first_token_id: type: string first_token_balance: type: string second_token_id: type: string second_token_balance: type: string type_url: type: string type: type: string ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string description: Hexadecimal representation of raw transaction data examples: success: summary: Successful response value: txID: f7d5c2e8a1b9f3d4c5e6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8 raw_data: contract: - parameter: value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH first_token_id: '1000001' first_token_balance: '1000000000000' second_token_id: _ second_token_balance: '5000000000' type_url: type.googleapis.com/protocol.ExchangeCreateContract type: ExchangeCreateContract ref_block_bytes: ab90 ref_block_hash: f5d4c3b2a1 expiration: 1672531260000 timestamp: 1672531200000 raw_data_hex: 0a02ab901220f5d4c3b2a140e0b8e2f6e30f5a68081112620a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e6765437265617465436f6e747261637412280a154c7971797a56474c5631737266b7dd4afc8eagg61534522083131306b30303131 '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Invalid token balance or insufficient funds tags: - General /exchangeinject: post: summary: Add liquidity to an exchange pair description: Adds liquidity to an existing exchange trading pair on the TRON decentralized exchange operationId: exchangeInject requestBody: required: true content: application/json: schema: type: object required: - owner_address - exchange_id - token_id - quant properties: owner_address: type: string description: The address providing liquidity to the exchange pair exchange_id: type: integer description: Unique identifier of the exchange pair to add liquidity to token_id: type: string description: Token ID being added to the liquidity pool. Use '_' to denote TRX. quant: type: integer description: Amount to add as an integer (token base units; if TRX, specify in sun) permission_id: type: integer description: Optional permission ID for multi-signature accounts visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: Add TRC10 tokens to liquidity pool value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: 500000000000 visible: true responses: '200': description: Successful response with transaction details content: application/json: schema: type: object properties: txID: type: string description: Unique transaction identifier raw_data: type: object description: Raw transaction data including contract details properties: contract: type: array items: type: object properties: parameter: type: object properties: value: type: object properties: owner_address: type: string exchange_id: type: integer token_id: type: string quant: type: string type_url: type: string type: type: string ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string description: Hexadecimal representation of raw transaction data examples: success: summary: Successful response value: txID: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 raw_data: contract: - parameter: value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: '500000000000' type_url: type.googleapis.com/protocol.ExchangeInjectContract type: ExchangeInjectContract ref_block_bytes: ab91 ref_block_hash: f5d4c3b2a2 expiration: 1672531320000 timestamp: 1672531260000 raw_data_hex: 0a02ab911220f5d4c3b2a240a0c9e2f6e30f5a68081112620a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e6765496e6a656374436f6e747261637412280a154c7971797a56474c5631737266b7dd4afc8eagg615349220831310313530303031 '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Exchange not found or insufficient token balance tags: - General /exchangetransaction: post: summary: Execute a token swap transaction description: Executes a token swap transaction on the TRON decentralized exchange operationId: exchangeTransaction requestBody: required: true content: application/json: schema: type: object required: - owner_address - exchange_id - token_id - quant - expected properties: owner_address: type: string description: The address performing the token swap transaction exchange_id: type: integer description: Unique identifier of the exchange pair to trade on token_id: type: string description: Token ID being sold. Use '_' to denote TRX. quant: type: integer description: Amount being sold as an integer (token base units; if TRX, specify in sun) expected: type: integer description: Minimum amount to receive as an integer (token base units; if TRX, sun). Protects against slippage. permission_id: type: integer description: Optional permission ID for multi-signature accounts visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: Swap TRC10 tokens for TRX value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: 100000000000 expected: 95000000 visible: true responses: '200': description: Successful response with transaction details content: application/json: schema: type: object properties: txID: type: string description: Unique transaction identifier raw_data: type: object description: Raw transaction data including contract details properties: contract: type: array items: type: object properties: parameter: type: object properties: value: type: object properties: owner_address: type: string exchange_id: type: integer token_id: type: string quant: type: string expected: type: string type_url: type: string type: type: string ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string description: Hexadecimal representation of raw transaction data examples: success: summary: Successful response value: txID: c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4 raw_data: contract: - parameter: value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: '100000000000' expected: '95000000' type_url: type.googleapis.com/protocol.ExchangeTransactionContract type: ExchangeTransactionContract ref_block_bytes: ab93 ref_block_hash: f5d4c3b2a4 expiration: 1672531440000 timestamp: 1672531380000 raw_data_hex: 0a02ab931220f5d4c3b2a440a0fee2f6e30f5a68081112620a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e67655472616e73616374696f6e436f6e747261637412280a154c7971797a56474c5631737266b7dd4afc8eagg61535422083931303030303030303030 '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Insufficient liquidity or slippage exceeded expected amount tags: - General /exchangewithdraw: post: summary: Remove liquidity from an exchange pair description: Removes liquidity from an existing exchange trading pair on the TRON decentralized exchange operationId: exchangeWithdraw requestBody: required: true content: application/json: schema: type: object required: - owner_address - exchange_id - token_id - quant properties: owner_address: type: string description: The address withdrawing liquidity from the exchange pair exchange_id: type: integer description: Unique identifier of the exchange pair to remove liquidity from token_id: type: string description: Token ID being withdrawn from the liquidity pool. Use '_' to denote TRX. quant: type: integer description: Amount to withdraw as an integer (token base units; if TRX, specify in sun) permission_id: type: integer description: Optional permission ID for multi-signature accounts visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: Withdraw TRC10 tokens from liquidity pool value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: 250000000000 visible: true responses: '200': description: Successful response with transaction details content: application/json: schema: type: object properties: txID: type: string description: Unique transaction identifier raw_data: type: object description: Raw transaction data including contract details properties: contract: type: array items: type: object properties: parameter: type: object properties: value: type: object properties: owner_address: type: string exchange_id: type: integer token_id: type: string quant: type: string type_url: type: string type: type: string ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string description: Hexadecimal representation of raw transaction data examples: success: summary: Successful response value: txID: b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3 raw_data: contract: - parameter: value: owner_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH exchange_id: 1 token_id: '1000001' quant: '250000000000' type_url: type.googleapis.com/protocol.ExchangeWithdrawContract type: ExchangeWithdrawContract ref_block_bytes: ab92 ref_block_hash: f5d4c3b2a3 expiration: 1672531380000 timestamp: 1672531320000 raw_data_hex: 0a02ab921220f5d4c3b2a340e0ebe2f6e30f5a68081112620a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e67655769746864726177436f6e747261637412280a154c7971797a56474c5631737266b7dd4afc8eagg615352220832353030303030303030 '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Exchange not found or insufficient liquidity to withdraw tags: - General /freezebalance: post: tags: - General summary: Wallet/Freezebalance operationId: freezeBalance deprecated: true requestBody: required: true content: application/json: schema: type: object required: - owner_address - frozen_balance - frozen_duration - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e frozen_balance: type: integer default: 1000000 frozen_duration: type: integer default: 3 resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH receiver_address: type: string description: Optional. Address to receive the resources. Omit to freeze for yourself. Must not equal `owner_address`. visible: type: boolean default: false example: owner_address: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e frozen_balance: 1000000 frozen_duration: 3 resource: BANDWIDTH visible: false responses: '200': description: Freeze balance transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string '400': description: Validation error (legacy freeze disabled) content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.ContractValidateException : freeze v2 is open, old freeze is closed' /freezebalancev2: post: tags: - General summary: Wallet/Freezebalancev2 operationId: freezeBalanceV2 requestBody: required: true content: application/json: schema: type: object required: - owner_address - frozen_balance - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e frozen_balance: type: integer default: 1000000 resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH visible: type: boolean default: false responses: '200': description: Freeze balance v2 transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string /getaccount: post: tags: - General summary: Wallet/Getaccount operationId: getAccount requestBody: required: true content: application/json: schema: type: object required: - address properties: address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Account information content: application/json: schema: type: object properties: address: type: string balance: type: integer create_time: type: integer latest_operation_time: type: integer free_net_usage: type: integer account_resource: type: object owner_permission: type: object active_permission: type: array /getaccountbalance: post: tags: - General summary: Wallet/Getaccountbalance operationId: getAccountBalance requestBody: required: true content: application/json: schema: type: object required: - account_identifier - block_identifier properties: account_identifier: type: object required: - address properties: address: type: string description: Account address. Use hex when `visible` is false, or base58 when `visible` is true. default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e block_identifier: type: object properties: hash: type: string description: Optional 32-byte block hash as 64 hex characters. pattern: ^[0-9a-fA-F]{64}$ number: type: integer required: - hash - number description: Block to query the balance at. Provide both the 32-byte block hash (64 hex chars) and its number; the node validates they match. visible: type: boolean default: false example: account_identifier: address: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e block_identifier: hash: 0000000004986736812cbf15ffbcdd229bd3d76a595db895719867cc2da3a5bd number: 77096758 visible: false responses: '200': description: Account balance information content: application/json: schema: type: object properties: balance: type: integer description: Available TRX balance in sun frozen: type: array description: Frozen balance information items: type: object properties: frozen_balance: type: integer expire_time: type: integer delegated_frozenV2: type: array description: Delegated frozen balance v2 items: type: object properties: type: type: string frozen_balance: type: integer undelegated_frozenV2: type: array description: Undelegated frozen balance v2 items: type: object properties: type: type: string unfreeze_amount: type: integer unfreeze_expire_time: type: integer /getaccountnet: post: tags: - General summary: Wallet/Getaccountnet operationId: getAccountNet requestBody: required: true content: application/json: schema: type: object required: - address properties: address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e visible: type: boolean default: false responses: '200': description: Account network resource information content: application/json: schema: type: object properties: freeNetUsed: type: integer description: Free bandwidth used freeNetLimit: type: integer description: Free bandwidth limit NetUsed: type: integer description: Staked bandwidth used NetLimit: type: integer description: Staked bandwidth limit TotalNetLimit: type: integer description: Total network bandwidth limit TotalNetWeight: type: integer description: Total network weight netUsed: type: integer description: Current bandwidth usage netLimit: type: integer description: Current bandwidth limit TotalEnergyLimit: type: integer description: Total energy limit TotalEnergyWeight: type: integer description: Total energy weight /getaccountresource: post: tags: - General summary: Wallet/Getaccountresource operationId: getAccountResource requestBody: required: true content: application/json: schema: type: object required: - address properties: address: type: string description: Account address in hex or base58check format example: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean description: Whether the address is in readable format default: true responses: '200': description: Account resource information content: application/json: schema: type: object properties: freeNetUsed: type: integer description: Free bandwidth used by the account example: 0 freeNetLimit: type: integer description: Total free bandwidth example: 5000 NetUsed: type: integer description: Used amount of bandwidth obtained by staking example: 0 NetLimit: type: integer description: Total bandwidth obtained by staking example: 0 TotalNetLimit: type: integer description: Total network bandwidth limit example: 43200000000 TotalNetWeight: type: integer description: Total network weight example: 84687233463517 EnergyUsed: type: integer description: Energy used by the account example: 0 EnergyLimit: type: integer description: Total energy obtained by staking example: 0 TotalEnergyLimit: type: integer description: Total energy limit on network example: 90000000000 TotalEnergyWeight: type: integer description: Total energy weight on network example: 13369831825062 tronPowerLimit: type: integer description: TRON Power (voting power) example: 0 tronPowerUsed: type: integer description: TRON Power used for voting example: 0 totalTronPowerWeight: type: integer description: Total TRON Power weight on network example: 0 assetNetUsed: type: array description: Bandwidth used for TRC10 assets items: type: object properties: key: type: string description: Asset ID value: type: integer description: Bandwidth used for this asset assetNetLimit: type: array description: Bandwidth limit for TRC10 assets items: type: object properties: key: type: string description: Asset ID value: type: integer description: Bandwidth limit for this asset /getapprovedlist: post: tags: - General summary: Wallet/Getapprovedlist operationId: getApprovedList requestBody: required: true content: application/json: schema: type: object required: - txID - raw_data - raw_data_hex - signature properties: txID: type: string description: Transaction ID (hash) raw_data: type: object description: Raw transaction data raw_data_hex: type: string description: Raw transaction data in hex signature: type: array items: type: string description: Array of 65-byte hex signatures visible: type: boolean default: false example: txID: 4ad97d49409cfff338d2f9e71d4019c70e82030b52e15e208b1808f2f3ea782e raw_data: contract: - parameter: value: data: a9059cbb0000000000000000000000415d4a41a3b0cdda5c03df72b38a20aa1b88777c7500000000000000000000000000000000000000000000000000000000f9cd95c0 owner_address: 41cf2e99409d2a9a9190197ab0bff35ca87818c41e contract_address: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c type_url: type.googleapis.com/protocol.TriggerSmartContract type: TriggerSmartContract ref_block_bytes: 68bd ref_block_hash: bc830d2c09fa23d1 expiration: 1761952567698 fee_limit: 225000000 timestamp: 1761952507695 raw_data_hex: 0a0268bd2208bc830d2c09fa23d14092a3bae4a3335aae01081f12a9010a31747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e54726967676572536d617274436f6e747261637412740a1541cf2e99409d2a9a9190197ab0bff35ca87818c41e121541a614f803b6fd780986a42c78ec9c7f77e6ded13c2244a9059cbb0000000000000000000000415d4a41a3b0cdda5c03df72b38a20aa1b88777c7500000000000000000000000000000000000000000000000000000000f9cd95c070afceb6e4a3339001c0f4a46b signature: - c99cdc8af6f47dc65a75aa0c6da1c5be8510736e581043162c3e8525c6e0ed8f592adaa74ba250136ea6e1fb125b3d3d024ac6abd3e24c28097d66a8e2a0c0aa01 visible: false responses: '200': description: Approved addresses (derived from signatures) and the echoed transaction content: application/json: schema: type: object properties: result: type: object approved_list: type: array items: type: string transaction: type: object /getassetissuebyid: post: tags: - General summary: Wallet/Getassetissuebyid operationId: getAssetIssueById requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: TRC10 token ID to query required: - value example: value: '1000001' responses: '200': description: TRC10 token information content: application/json: schema: type: object properties: owner_address: type: string description: Address that issued the token name: type: string description: Token name abbr: type: string description: Token symbol/abbreviation total_supply: type: number description: Total supply of tokens trx_num: type: number description: TRX amount for exchange rate precision: type: number description: Token decimal places num: type: number description: Token amount for exchange rate start_time: type: number description: ICO start time (timestamp) end_time: type: number description: ICO end time (timestamp) description: type: string description: Token description url: type: string description: Token project website id: type: string description: Unique token ID free_asset_net_limit: type: number description: Free bandwidth for token operations public_free_asset_net_limit: type: number description: Public free bandwidth limit public_free_asset_net_usage: type: number description: Used public bandwidth public_latest_free_net_time: type: number description: Latest free bandwidth usage time /getassetissuebyname: post: tags: - General summary: Wallet/Getassetissuebyname operationId: getAssetIssueByName requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: "Token name. When `visible` is true, provide the plain UTF\u20118 name. When `visible` is false,\ \ provide the UTF\u20118 name hex\u2011encoded." default: TOKEN_NAME visible: type: boolean description: "When true, `value` is plain text. When false, `value` is hex\u2011encoded UTF\u20118." default: false example: value: 54525854657374436f696e visible: false responses: '200': description: TRC10 token information content: application/json: schema: type: object properties: assetIssue: type: array items: type: object properties: owner_address: type: string name: type: string abbr: type: string total_supply: type: integer trx_num: type: integer num: type: integer start_time: type: integer end_time: type: integer description: type: string url: type: string id: type: string /getassetissuelist: post: tags: - General summary: Wallet/Getassetissuelist operationId: getAssetIssueList requestBody: required: true content: application/json: schema: type: object example: {} responses: '200': description: List of all TRC10 tokens content: application/json: schema: type: object properties: assetIssue: type: array items: type: object properties: owner_address: type: string description: Address that issued the token name: type: string description: Token name abbr: type: string description: Token symbol/abbreviation total_supply: type: number description: Total supply of tokens trx_num: type: number description: TRX amount for exchange rate precision: type: number description: Token decimal places num: type: number description: Token amount for exchange rate start_time: type: number description: ICO start time (timestamp) end_time: type: number description: ICO end time (timestamp) description: type: string description: Token description url: type: string description: Token project website id: type: string description: Unique token ID free_asset_net_limit: type: number description: Free bandwidth for token operations public_free_asset_net_limit: type: number description: Public free bandwidth limit public_free_asset_net_usage: type: number description: Used public bandwidth public_latest_free_net_time: type: number description: Latest free bandwidth usage time /getassetissuelistbyname: post: tags: - General summary: Wallet/Getassetissuelistbyname operationId: getAssetIssueListByName requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: "Token name or pattern. When `visible` is true, provide plain UTF\u20118. When `visible` is\ \ false, provide hex\u2011encoded UTF\u20118." visible: type: boolean description: "When true, `value` is plain text; when false, hex\u2011encoded." default: true required: - value example: value: SEED visible: true responses: '200': description: List of TRC10 tokens matching the name pattern content: application/json: schema: type: object properties: assetIssue: type: array description: Array of TRC10 token information items: type: object properties: id: type: string description: Unique token ID owner_address: type: string description: Address of token issuer name: type: string description: Token name in hex format abbr: type: string description: Token abbreviation in hex format total_supply: type: number description: Total supply of the token trx_num: type: number description: TRX amount in exchange ratio precision: type: number description: Token decimal places num: type: number description: Token amount in exchange ratio start_time: type: number description: Token sale start timestamp end_time: type: number description: Token sale end timestamp description: type: string description: Token description in hex format url: type: string description: Token website URL in hex format free_asset_net_limit: type: number description: Free bandwidth allocation public_free_asset_net_limit: type: number description: Public free bandwidth limit frozen_supply: type: array description: Frozen token supply details /getavailableunfreezecount: post: tags: - General summary: Wallet/Getavailableunfreezecount operationId: getAvailableUnfreezeCount requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Available unfreeze count content: application/json: schema: type: object properties: count: type: integer /getbandwidthprices: post: tags: - General summary: Wallet/Getbandwidthprices operationId: getBandwidthPrices requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: Current bandwidth prices content: application/json: schema: type: object properties: prices: type: string /getblock: post: tags: - General summary: Wallet/Getblock operationId: getBlock requestBody: required: true content: application/json: schema: type: object required: - id_or_num properties: id_or_num: type: string default: '66677878' description: Block number or block hash detail: type: boolean default: true visible: type: boolean default: true responses: '200': description: Block information content: application/json: schema: type: object properties: blockID: type: string block_header: type: object properties: raw_data: type: object witness_signature: type: string transactions: type: array items: type: object /getblockbalance: post: tags: - General summary: Wallet/Getblockbalance operationId: getBlockBalance requestBody: required: true content: application/json: schema: type: object required: - hash - number properties: hash: type: string description: Block hash (64 hex chars) pattern: ^[0-9a-fA-F]{64}$ number: type: integer description: Block number (must match the hash) visible: type: boolean default: true example: hash: 0000000004986736812cbf15ffbcdd229bd3d76a595db895719867cc2da3a5bd number: 77096758 visible: true responses: '200': description: Block balance changes information content: application/json: schema: type: object properties: timestamp: type: integer block_identifier: type: object properties: hash: type: string number: type: integer transaction_balance_trace: type: array description: Per-transaction balance deltas within the block items: type: object properties: transaction_identifier: type: string operation: type: array items: type: object properties: operation_identifier: type: integer address: type: string amount: type: integer description: Delta in sun; negative for debits, positive for credits type: type: string status: type: string /getblockbyid: post: tags: - General summary: Wallet/Getblockbyid operationId: getBlockById requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: The block ID (hash) in hexadecimal format required: - value example: value: 0000000000f4245300b88ffeb9bdb95b88c66b5ce6bb0ee79d85d5ce14b6a2a7ca responses: '200': description: Block information content: application/json: schema: type: object properties: blockID: type: string description: Block ID (hash) block_header: type: object properties: raw_data: type: object properties: timestamp: type: number description: Block timestamp in milliseconds txTrieRoot: type: string description: Transaction trie root hash parentHash: type: string description: Hash of the parent block number: type: number description: Block height/number witness_address: type: string description: Address of the block producer version: type: number description: Block version witness_signature: type: string description: Block producer's signature transactions: type: array description: Array of transactions in the block items: type: object /getblockbylatestnum: post: tags: - General summary: Wallet/Getblockbylatestnum operationId: getBlockByLatestNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer default: 5 description: Number of latest blocks to retrieve (max 100) visible: type: boolean default: true responses: '200': description: Latest blocks information content: application/json: schema: type: object properties: block: type: array items: type: object properties: blockID: type: string block_header: type: object transactions: type: array items: type: object /getblockbylimitnext: post: tags: - General summary: Wallet/Getblockbylimitnext operationId: getBlockByLimitNext requestBody: required: true content: application/json: schema: type: object required: - startNum - endNum properties: startNum: type: integer default: 66677870 endNum: type: integer default: 66677880 visible: type: boolean default: true responses: '200': description: Blocks within specified range content: application/json: schema: type: object properties: block: type: array items: type: object properties: blockID: type: string block_header: type: object transactions: type: array items: type: object /getblockbynum: post: tags: - General summary: Wallet/Getblockbynum operationId: getBlockByNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer default: 1000 visible: type: boolean default: false responses: '200': description: Block information content: application/json: schema: type: object properties: blockID: type: string block_header: type: object properties: raw_data: type: object properties: number: type: integer timestamp: type: integer parentHash: type: string witness_signature: type: string transactions: type: array items: type: object visible: type: boolean /getbrokerage: get: tags: - General summary: wallet/getBrokerage operationId: getBrokerage parameters: - name: address in: query required: true schema: type: string description: Witness address in hex format (21-byte, starts with 41) example: 41928c9af0651632157ef27a2cf17ca72c575a4d21 responses: '200': description: Brokerage percentage for witness rewards content: application/json: schema: type: object properties: brokerage: type: number description: Brokerage percentage (0-100) example: brokerage: 20 /getburntrx: post: tags: - General summary: Wallet/Getburntrx operationId: getBurnTrx requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: Burned TRX information content: application/json: schema: type: object properties: burnTrxAmount: type: integer /getcandelegatedmaxsize: post: tags: - General summary: Wallet/Getcandelegatedmaxsize operationId: getCanDelegatedMaxSize requestBody: required: true content: application/json: schema: type: object required: - owner_address - type properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g type: type: integer default: 0 description: 0 for bandwidth, 1 for energy visible: type: boolean default: true responses: '200': description: Maximum delegatable amount content: application/json: schema: type: object properties: max_size: type: integer /getcanwithdrawunfreezeamount: post: tags: - General summary: Wallet/Getcanwithdrawunfreezeamount operationId: getCanWithdrawUnfreezeAmount requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g timestamp: type: integer description: Timestamp in milliseconds visible: type: boolean default: true responses: '200': description: Withdrawable unfreeze amount content: application/json: schema: type: object properties: amount: type: integer /getchainparameters: get: tags: - General summary: Wallet/Getchainparameters operationId: getChainParameters responses: '200': description: Blockchain parameters and configuration content: application/json: schema: type: object properties: chainParameter: type: array description: Array of blockchain parameters items: type: object properties: key: type: string description: Parameter name value: type: integer description: Parameter value example: - key: getMaintenanceTimeInterval value: 21600000 - key: getAccountUpgradeCost value: 9999000000 - key: getCreateAccountFee value: 100000 - key: getTransactionFee value: 10 - key: getAssetIssueFee value: 1024000000 - key: getWitnessPayPerBlock value: 16000000 - key: getWitnessStandbyAllowance value: 115200000000 - key: getCreateNewAccountFeeInSystemContract value: 1000000 - key: getCreateNewAccountBandwidthRate value: 1 - key: getAllowCreationOfContracts value: 1 - key: getRemoveThePowerOfTheGr value: 1 - key: getEnergyFee value: 140 - key: getExchangeCreateFee value: 1024000000 - key: getMaxCpuTimeOfOneTx value: 80 - key: getAllowUpdateAccountName value: 0 - key: getAllowSameTokenName value: 1 - key: getAllowDelegateResource value: 1 - key: getTotalEnergyLimit value: 90000000000 - key: getAllowTvmTransferTrc10 value: 1 - key: getTotalEnergyCurrentLimit value: 90000000000 - key: getAllowMultiSign value: 1 - key: getAllowAdaptiveEnergy value: 1 - key: getUpdateAccountPermissionFee value: 100000000 - key: getMultiSignFee value: 1000000 /getcontract: post: tags: - General summary: Wallet/Getcontract operationId: getContract requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: Contract address in hex format required: - value example: value: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c responses: '200': description: Smart contract information content: application/json: schema: type: object properties: bytecode: type: string description: Contract bytecode in hex format name: type: string description: Contract name origin_address: type: string description: Address that deployed the contract contract_address: type: string description: Contract address in hex format abi: type: object description: Contract ABI (Application Binary Interface) origin_energy_limit: type: number description: Original energy limit set for the contract consume_user_resource_percent: type: number description: Percentage of user resources consumed by contract calls code_hash: type: string description: Hash of the contract code trx_hash: type: string description: Transaction hash of the contract deployment /getcontractinfo: post: tags: - General summary: Wallet/Getcontractinfo operationId: getContractInfo requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: Contract address to get information for visible: type: boolean description: Whether to use visible (Base58) address format required: - value example: value: TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs visible: true responses: '200': description: Detailed contract information content: application/json: schema: type: object properties: contract_address: type: string description: The contract address bytecode: type: string description: Contract bytecode in hex format name: type: string description: Contract name if available abi: type: object description: Application Binary Interface source_map: type: string description: Source code mapping for debugging source_code: type: string description: Original contract source code compiler_version: type: string description: Solidity compiler version used consume_user_resource_percent: type: number description: Percentage of user resources consumed origin_address: type: string description: Address that deployed the contract origin_energy_limit: type: number description: Energy limit set by contract creator contract_state: type: string description: Current state of the contract code_hash: type: string description: Hash of the contract code /getdelegatedresource: post: tags: - General summary: Wallet/Getdelegatedresource operationId: getDelegatedResource requestBody: required: true content: application/json: schema: type: object required: - fromAddress - toAddress properties: fromAddress: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g toAddress: type: string default: TFgY1uN8buRxAtV2r6Zy5sG3ACko6pJT1y visible: type: boolean default: true responses: '200': description: Delegated resource information content: application/json: schema: type: object properties: delegatedResource: type: array items: type: object properties: from: type: string to: type: string frozen_balance_for_bandwidth: type: integer frozen_balance_for_energy: type: integer expire_time_for_bandwidth: type: integer expire_time_for_energy: type: integer /getdelegatedresourceaccountindex: post: tags: - General summary: Wallet/Getdelegatedresourceaccountindex operationId: getDelegatedResourceAccountIndex requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Delegated resource account index content: application/json: schema: type: object properties: account: type: string fromAccounts: type: array items: type: string toAccounts: type: array items: type: string /getdelegatedresourceaccountindexv2: post: tags: - General summary: Wallet/Getdelegatedresourceaccountindexv2 operationId: getDelegatedResourceAccountIndexV2 requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Delegated resource account index (Stake 2.0) content: application/json: schema: type: object properties: account: type: string fromAccounts: type: array items: type: string toAccounts: type: array items: type: string /getdelegatedresourcev2: post: tags: - General summary: Wallet/Getdelegatedresourcev2 operationId: getDelegatedResourceV2 requestBody: required: true content: application/json: schema: type: object required: - fromAddress - toAddress properties: fromAddress: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g toAddress: type: string default: TFgY1uN8buRxAtV2r6Zy5sG3ACko6pJT1y visible: type: boolean default: true responses: '200': description: Delegated resource information (Stake 2.0) content: application/json: schema: type: object properties: delegatedResource: type: array items: type: object properties: from: type: string to: type: string frozen_balance_for_bandwidth: type: integer frozen_balance_for_energy: type: integer expire_time_for_bandwidth: type: integer expire_time_for_energy: type: integer /getenergyprices: post: tags: - General summary: Wallet/Getenergyprices operationId: getEnergyPrices requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: Current energy prices content: application/json: schema: type: object properties: prices: type: string /getexchangebyid: post: summary: Get exchange pair details by ID description: Retrieves detailed information about a specific exchange trading pair by its unique identifier operationId: getExchangeById requestBody: required: true content: application/json: schema: type: object required: - id properties: id: type: integer description: The unique exchange ID to query visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: Get exchange by ID value: id: 1 visible: true responses: '200': description: Successful response with exchange details content: application/json: schema: type: object properties: exchange_id: type: integer description: Unique identifier for the exchange pair creator_address: type: string description: Address that created the exchange pair create_time: type: integer description: Timestamp when the exchange was created first_token_id: type: string description: Token ID of the first token in the pair first_token_balance: type: string description: Current balance of the first token second_token_id: type: string description: Token ID of the second token in the pair second_token_balance: type: string description: Current balance of the second token examples: success: summary: Successful response value: exchange_id: 1 creator_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH create_time: 1672531200000 first_token_id: '1000001' first_token_balance: '1000000000000' second_token_id: _ second_token_balance: '5000000000' '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Exchange not found tags: - General /getmarketorderbyaccount: post: tags: - General summary: Wallet/Getmarketorderbyaccount operationId: getMarketOrderByAccount requestBody: required: true content: application/json: schema: type: object properties: address: type: string description: Account address in hex format offset: type: number description: 'Starting position for pagination (default: 0)' limit: type: number description: 'Maximum number of orders to return (default: 20, max: 100)' required: - address example: address: 41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b offset: 0 limit: 20 responses: '200': description: Market orders for the account content: application/json: schema: type: object properties: orders: type: array items: type: object properties: order_id: type: string description: Unique identifier for the market order owner_address: type: string description: Order creator address create_time: type: number description: Order creation timestamp sell_token_id: type: string description: Token ID being sold (empty for TRX) sell_token_quantity: type: string description: Quantity of tokens being sold buy_token_id: type: string description: Token ID being purchased (empty for TRX) buy_token_quantity: type: string description: Quantity of tokens being purchased sell_token_quantity_remain: type: string description: Remaining quantity for sale buy_token_quantity_remain: type: string description: Remaining quantity to purchase state: type: string description: Order status /getmarketorderbyid: post: tags: - General summary: Wallet/Getmarketorderbyid operationId: getMarketOrderById requestBody: required: true content: application/json: schema: type: object properties: order_id: type: string description: Unique identifier of the market order (hex string) required: - order_id example: order_id: '0x1234567890abcdef1234567890abcdef12345678' responses: '200': description: Market order details content: application/json: schema: type: object properties: order_id: type: string description: Unique identifier for the market order owner_address: type: string description: Order creator address create_time: type: number description: Order creation timestamp sell_token_id: type: string description: Token ID being sold (empty for TRX) sell_token_quantity: type: string description: Original quantity of tokens being sold buy_token_id: type: string description: Token ID being purchased (empty for TRX) buy_token_quantity: type: string description: Original quantity of tokens being purchased sell_token_quantity_remain: type: string description: Remaining quantity for sale buy_token_quantity_remain: type: string description: Remaining quantity to purchase state: type: string description: Order status prev: type: string description: Previous order ID in order book next: type: string description: Next order ID in order book /getmarketorderlistbypair: post: tags: - General summary: Wallet/Getmarketorderlistbypair operationId: getMarketOrderListByPair requestBody: required: true content: application/json: schema: type: object properties: sell_token_id: type: string description: TRC10 token ID being sold, as a numeric string (for example, '1000006'). buy_token_id: type: string description: TRC10 token ID being purchased, as a numeric string. offset: type: number description: 'Starting position for pagination (default: 0)' limit: type: number description: 'Maximum number of orders to return (default: 20, max: 100)' visible: type: boolean description: 'Optional. Some node builds require `visible: true` for this endpoint.' default: true required: - sell_token_id - buy_token_id example: sell_token_id: '1000006' buy_token_id: '1000001' offset: 0 limit: 20 visible: true responses: '200': description: Market orders for trading pair content: application/json: schema: type: object properties: orders: type: array items: type: object properties: order_id: type: string description: Unique identifier for the market order owner_address: type: string description: Order creator address create_time: type: number description: Order creation timestamp sell_token_id: type: string description: Token ID being sold sell_token_quantity: type: string description: Quantity of tokens being sold buy_token_id: type: string description: Token ID being purchased buy_token_quantity: type: string description: Quantity of tokens being purchased sell_token_quantity_remain: type: string description: Remaining quantity for sale buy_token_quantity_remain: type: string description: Remaining quantity to purchase state: type: string description: Order status /getmarketpairlist: post: tags: - General summary: Wallet/Getmarketpairlist operationId: getMarketPairList requestBody: required: true content: application/json: schema: type: object example: {} responses: '200': description: All available trading pairs content: application/json: schema: type: object properties: orderPair: type: array description: Array of trading pair objects items: type: object properties: sell_token_id: type: string description: Token ID for sell side (empty for TRX) buy_token_id: type: string description: Token ID for buy side (empty for TRX) /getmarketpricebypair: post: tags: - General summary: Wallet/Getmarketpricebypair operationId: getMarketPriceByPair requestBody: required: true content: application/json: schema: type: object properties: sell_token_id: type: string description: TRC10 token ID being sold, as a numeric string (e.g., '1000006'). buy_token_id: type: string description: TRC10 token ID being purchased, as a numeric string. visible: type: boolean description: 'Optional. Some node builds require `visible: true` for this endpoint.' default: true required: - sell_token_id - buy_token_id example: sell_token_id: '1000006' buy_token_id: '1000001' visible: true responses: '200': description: Market price for trading pair content: application/json: schema: type: object properties: sell_token_id: type: string description: Token ID being sold buy_token_id: type: string description: Token ID being purchased prices: type: array description: Array of recent price points items: type: object properties: sell_token_quantity: type: string description: Quantity of sell token buy_token_quantity: type: string description: Quantity of buy token timestamp: type: number description: Price point timestamp '400': description: Validation error or unsupported pair content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.BadItemException : sellTokenId is not a valid number' /getmerkletreevoucherinfo: post: tags: - General summary: Wallet/Getmerkletreevoucherinfo operationId: getMerkleTreeVoucherInfo requestBody: required: true content: application/json: schema: type: object required: - output_point - ak - nk - position properties: output_point: type: string description: The output point for the merkle tree voucher default: 030c8c2bc59fb3eb8c12157b4d7ddd4b2d6cf2c5b3f1a2c3d4e5f6071819202122 ak: type: string description: Authentication key for the voucher default: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b nk: type: string description: Nullifier key for the voucher default: 9f8e7d6c5b4a39281706f5e4d3c2b1a09f8e7d6c5b4a39281706f5e4d3c2b1a0 position: type: integer description: Position in the merkle tree default: 12345 responses: '200': description: Merkle tree voucher information content: application/json: schema: type: object properties: voucher_info: type: object description: Voucher information object paths: type: array items: type: string description: Array of merkle tree path elements anchors: type: array items: type: string description: Array of anchor values for the merkle tree rt: type: string description: Merkle tree root output_point_info: type: object description: Detailed information about the output point /getnewshieldedaddress: post: tags: - General summary: Wallet/Getnewshieldedaddress operationId: getNewShieldedAddress requestBody: required: true content: application/json: schema: type: object properties: {} responses: '200': description: Successfully generated new shielded address with full key set content: application/json: schema: type: object properties: sk: type: string description: Spending key (private key, 64 hex characters, no 0x prefix) example: 02a1b2c3d4e5f67890123456789012345678901234567890123456789012345678 ask: type: string description: Authentication secret key (64 hex characters, no 0x prefix) example: 0f63eabdfe2bbfe08012f6bb2db024e6809c16e8ed055aa41a6095424f192005 nsk: type: string description: Nullifier secret key (64 hex characters, no 0x prefix) example: 590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14 ovk: type: string description: Outgoing viewing key (64 hex characters, no 0x prefix) example: 0ff58efd75e083fe4fd759c8701e1c8cb6961c4297a12b2c800bdb7b2bcab889 ak: type: string description: Authentication key (64 hex characters, no 0x prefix) example: 8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64 nk: type: string description: Nullifier key (64 hex characters, no 0x prefix) example: 590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14 ivk: type: string description: Incoming viewing key (64 hex characters, no 0x prefix) example: 9f8e74bb3d7188a2781dc1db38810c6914eef4570a79e8ec8404480948e4e305 d: type: string description: Diversifier (22 hex characters, no 0x prefix) example: 06e5f678901234567890ab pkD: type: string description: Payment address public key (64 hex characters, no 0x prefix) example: a1b2c3d4e5f6789012345678901234567890123456789012345678901234abcd payment_address: type: string description: Complete shielded payment address (ztron1 format, 78 characters) example: ztron1768kf7dy4qquefp46szk978d65eeua66yhr4zv260c0uzj68t3tfjl3en9lhyyfxalv4jus30xs /getnextmaintenancetime: post: tags: - General summary: Wallet/Getnextmaintenancetime operationId: getNextMaintenanceTime requestBody: required: true content: application/json: schema: type: object example: {} responses: '200': description: Next maintenance window time content: application/json: schema: type: object properties: num: type: number description: Timestamp of next maintenance window in milliseconds example: num: 1693468800000 /getnodeinfo: get: tags: - General summary: Wallet/Getnodeinfo operationId: getNodeInfo responses: '200': description: Node information and status content: application/json: schema: type: object properties: beginSyncNum: type: integer description: Block number from which sync started block: type: string description: Current block height solidityBlock: type: string description: Current solidity block height currentConnectCount: type: integer description: Current peer connections activeConnectCount: type: integer description: Active peer connections passiveConnectCount: type: integer description: Passive peer connections totalFlow: type: integer description: Total network traffic flow peerInfoList: type: array description: List of connected peers items: type: object properties: lastSyncBlock: type: string remainNum: type: integer lastBlockUpdateTime: type: integer syncFlag: type: boolean headBlockTimeWeBothHave: type: integer needSyncFromPeer: type: boolean needSyncFromUs: type: boolean host: type: string port: type: integer nodeId: type: string configNodeInfo: type: object description: Node configuration information properties: codeVersion: type: string p2pVersion: type: string listenPort: type: integer discoverEnable: type: boolean activeNodeSize: type: integer passiveNodeSize: type: integer sendNodeSize: type: integer maxConnectCount: type: integer sameIpMaxConnectCount: type: integer backupListenPort: type: integer backupMemberSize: type: integer backupPriority: type: integer dbVersion: type: integer minParticipationRate: type: integer supportConstant: type: boolean minTimeRatio: type: number maxTimeRatio: type: number allowCreationOfContracts: type: integer allowAdaptiveEnergy: type: integer machineInfo: type: object description: Machine and system information properties: threadCount: type: integer deadLockThreadCount: type: integer cpuCount: type: integer totalMemory: type: integer freeMemory: type: integer cpuRate: type: number javaVersion: type: string osName: type: string jvmTotalMemory: type: integer jvmFreeMemory: type: integer processCpuRate: type: number cheatWitnessInfoMap: type: object description: Information about witnesses flagged for cheating /getnowblock: post: tags: - General summary: Wallet/Getnowblock operationId: getNowBlock requestBody: required: false content: application/json: schema: type: object responses: '200': description: Current block information content: application/json: schema: type: object properties: blockID: type: string block_header: type: object properties: raw_data: type: object witness_signature: type: string transactions: type: array /getpaginatedassetissuelist: post: tags: - General summary: Wallet/Getpaginatedassetissuelist operationId: getPaginatedAssetIssueList requestBody: required: true content: application/json: schema: type: object properties: offset: type: number description: Number of records to skip from the beginning limit: type: number description: Maximum number of tokens to return required: - offset - limit example: offset: 0 limit: 20 responses: '200': description: Paginated list of TRC10 tokens content: application/json: schema: type: object properties: assetIssue: type: array description: Array of TRC10 token information items: type: object properties: id: type: string description: Unique token ID owner_address: type: string description: Address of token issuer name: type: string description: Token name in hex format abbr: type: string description: Token abbreviation in hex format total_supply: type: number description: Total supply of the token trx_num: type: number description: TRX amount in exchange ratio precision: type: number description: Token decimal places num: type: number description: Token amount in exchange ratio start_time: type: number description: Token sale start timestamp end_time: type: number description: Token sale end timestamp description: type: string description: Token description in hex format url: type: string description: Token website URL in hex format free_asset_net_limit: type: number description: Free bandwidth allocation per account public_free_asset_net_limit: type: number description: Total public free bandwidth limit frozen_supply: type: array description: Frozen token supply details /getpaginatedproposallist: post: tags: - General summary: Wallet/Getpaginatedproposallist operationId: getPaginatedProposalList requestBody: required: false content: application/json: schema: type: object properties: offset: type: integer default: 0 minimum: 0 limit: type: integer default: 10 minimum: 1 maximum: 100 responses: '200': description: Paginated list of proposals content: application/json: schema: type: object properties: proposals: type: array items: type: object properties: proposal_id: type: integer proposer_address: type: string parameters: type: object additionalProperties: type: integer expiration_time: type: integer create_time: type: integer approvals: type: array items: type: string state: type: string enum: - PENDING - DISAPPROVED - APPROVED - CANCELED /getpendingsize: get: tags: - General summary: Wallet/Getpendingsize operationId: getPendingSize responses: '200': description: Current size of the pending transaction pool content: application/json: schema: type: object properties: pendingSize: type: integer description: Number of pending transactions in the mempool example: 1247 /getproposalbyid: post: tags: - General summary: Wallet/Getproposalbyid operationId: getProposalById requestBody: required: true content: application/json: schema: type: object required: - id properties: id: type: integer default: 1 responses: '200': description: Proposal information content: application/json: schema: type: object properties: proposal_id: type: integer proposer_address: type: string parameters: type: object additionalProperties: type: integer expiration_time: type: integer create_time: type: integer approvals: type: array items: type: string state: type: string enum: - PENDING - DISAPPROVED - APPROVED - CANCELED /getreward: get: tags: - General summary: wallet/getReward operationId: getReward parameters: - name: address in: query required: true schema: type: string description: Account address in hex format (21-byte, starts with 41) example: 41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b responses: '200': description: Witness rewards information content: application/json: schema: type: object properties: reward: type: number description: Total reward amount in sun (1 TRX = 1,000,000 sun) example: reward: 1500000000 /gettransactionbyid: post: tags: - General summary: Wallet/Gettransactionbyid operationId: getTransactionById requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string default: d5ec749ecc2a615399d6573b3550650b4e6606d9ff0d123cd5bdc0bc6a33b0a2 visible: type: boolean default: false responses: '200': description: Transaction details content: application/json: schema: type: object properties: ret: type: array items: type: object properties: contractRet: type: string fee: type: integer signature: type: array items: type: string txID: type: string net_usage: type: integer raw_data_hex: type: string net_fee: type: integer energy_usage: type: integer blockNumber: type: integer block_timestamp: type: integer contract_result: type: array items: type: string /gettransactionfrompending: post: tags: - General summary: Wallet/Gettransactionfrompending operationId: getTransactionFromPending requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: Transaction ID hash of the pending transaction to retrieve required: - value example: value: f34f1c799700a9d83b67fdcadd7be697010a8dbbcd520de4ac46a648e3e7ae3d responses: '200': description: Specific pending transaction details content: application/json: schema: type: object properties: txID: type: string description: Unique transaction identifier hash example: f34f1c799700a9d83b67fdcadd7be697010a8dbbcd520de4ac46a648e3e7ae3d raw_data: type: object properties: contract: type: array description: Transaction contract details items: type: object properties: type: type: string example: TransferContract parameter: type: object properties: type_url: type: string example: type.googleapis.com/protocol.TransferContract value: type: object ref_block_bytes: type: string description: Reference block bytes for validation example: 6f80 ref_block_hash: type: string description: Hash of the reference block example: 1c9c4b8c43c5e0b1 expiration: type: integer description: Transaction expiration timestamp example: 1704067260000 timestamp: type: integer description: Transaction creation timestamp example: 1704067200000 fee_limit: type: integer description: Maximum fee allowed for this transaction example: 100000000 signature: type: array description: Array of transaction signatures items: type: string ret: type: array description: Transaction result information items: type: object properties: contractRet: type: string example: SUCCESS /gettransactioninfobyblocknum: post: tags: - General summary: Wallet/Gettransactioninfobyblocknum operationId: getTransactionInfoByBlockNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer default: 66677878 visible: type: boolean default: true responses: '200': description: Transaction information for all transactions in the block content: application/json: schema: type: array items: type: object properties: id: type: string fee: type: integer blockNumber: type: integer blockTimeStamp: type: integer contractResult: type: array items: type: string receipt: type: object log: type: array items: type: object /gettransactioninfobyid: post: tags: - General summary: Wallet/Gettransactioninfobyid operationId: getTransactionInfoById requestBody: required: true content: application/json: schema: type: object properties: value: type: string description: The transaction ID (hash) in hexadecimal format required: - value example: value: 4c85b7a5c6e1d5f6e1d5c6f7e1d5c6f7e1d5c6f7e1d5c6f7e1d5c6f7e1d5c6f7 responses: '200': description: Transaction receipt and execution information content: application/json: schema: type: object properties: id: type: string description: Transaction ID blockNumber: type: number description: Block number where transaction was included blockTimeStamp: type: number description: Block timestamp in milliseconds contractResult: type: array description: Smart contract execution results items: type: string contract_address: type: string description: Contract address if contract creation transaction receipt: type: object properties: energy_usage: type: number description: Energy consumed by the transaction energy_fee: type: number description: Energy fee in SUN origin_energy_usage: type: number description: Original energy usage energy_usage_total: type: number description: Total energy usage net_usage: type: number description: Bandwidth consumed net_fee: type: number description: Bandwidth fee in SUN result: type: string description: Transaction execution result log: type: array description: Event logs from smart contract execution items: type: object result: type: string description: Overall transaction result status resMessage: type: string description: Result message if transaction failed /gettransactionlistfrompending: get: tags: - General summary: Wallet/Gettransactionlistfrompending operationId: getTransactionListFromPending responses: '200': description: List of all pending transactions content: application/json: schema: type: object properties: transactions: type: array description: Array of pending transaction objects items: type: object properties: txID: type: string description: Unique transaction identifier hash example: f34f1c799700a9d83b67fdcadd7be697010a8dbbcd520de4ac46a648e3e7ae3d raw_data: type: object properties: contract: type: array description: Transaction contract details items: type: object properties: type: type: string example: TransferContract parameter: type: object ref_block_bytes: type: string description: Reference block bytes for validation example: 6f80 ref_block_hash: type: string description: Hash of the reference block example: 1c9c4b8c43c5e0b1 expiration: type: integer description: Transaction expiration timestamp example: 1704067260000 timestamp: type: integer description: Transaction creation timestamp example: 1704067200000 fee_limit: type: integer description: Maximum fee allowed for this transaction example: 100000000 signature: type: array description: Array of transaction signatures items: type: string ret: type: array description: Transaction result information items: type: object properties: contractRet: type: string example: SUCCESS /gettriggerinputforshieldedtrc20contract: post: tags: - General summary: Wallet/Gettriggerinputforshieldedtrc20Contract operationId: getTriggerInputForShieldedTRC20Contract requestBody: required: true content: application/json: schema: type: object required: - shielded_TRC20_Parameters - spend_authority_signature properties: shielded_TRC20_Parameters: type: object description: Shielded TRC20 transaction parameters required: - spend_description - binding_signature - message_hash - parameter_type properties: spend_description: type: array description: Array of spend descriptions for inputs items: type: object properties: value_commitment: type: string description: Value commitment (hex without 0x prefix) example: 219ed48bc4bfe14cc2953ab5027528353e177e2263479122ea97c609ce187986 anchor: type: string description: Merkle root of note commitment tree (hex without 0x prefix) example: c1dda86b7af8ce842e349347b364936baf24ad36be65046e2fd7349640bba873 nullifier: type: string description: Nullifier to prevent double spending (hex without 0x prefix) example: 79e938e0951d4d6cf6acd679fc6bb59147a6abc2f9e2828185328e93a83ab2f1 rk: type: string description: Public key for spend authorization signature verification (hex without 0x prefix) example: 99c0c1fbe3ad8a6e27d712632064fdeeb10952624c60a0ddcba0eb233bbf4e8b zkproof: type: string description: Zero-knowledge proof data (hex without 0x prefix) example: b536d0f442f6e0517930a9ccdb551c9e551a148c41fcf1e4748d1330d6c3e6f9 receive_description: type: array description: Array of receive descriptions for outputs (required for transfer operations) items: type: object properties: value_commitment: type: string description: Value commitment (hex without 0x prefix) example: 19ac352ba8d7f5167ef43a5b9c225056db2c44fb19f7fe8c63e0d2b956771656 note_commitment: type: string description: Note commitment (hex without 0x prefix) example: e40b9da38887963c8cd1e163b4b7d4b999502c32e1204b791242633aebcdbb6d epk: type: string description: Ephemeral public key (hex without 0x prefix) example: b1675f0b5331371466ff30d621991f0a30c9bc4d34c322be44619a0acf932905 c_enc: type: string description: Encrypted note ciphertext (hex without 0x prefix) example: b69f20ae969de55319d2b7617bf7351a4683098af1e7b16fa64d44ff758471f3 c_out: type: string description: Output ciphertext for auditing (hex without 0x prefix) example: 1e5333e35985d343697dcce92703c2536a861eb49722e1c83a112cf004006e9c zkproof: type: string description: Zero-knowledge proof data (hex without 0x prefix) example: a6b41694f8fa378886ef77d5bd07de56de55b9ad7c8438d05380dd5fa1ce2e7d binding_signature: type: string description: Binding signature for the transaction (hex without 0x prefix) example: c7f303709c57e49264fd5ae5922bf977ef2a57ccc84d746effc5c6937eecf36e05b09faf95e5f869aeaf1aa87b24570eb723a4d8c77edea32c31b2909c84eb04 message_hash: type: string description: Hash of the transaction message (hex without 0x prefix) example: 7fb99e66df052f430d50e80a3f197c319a4e35184ed48a433d6219e025741337 parameter_type: type: string description: Type of shielded operation enum: - mint - burn - transfer example: transfer spend_authority_signature: type: array description: Array of spend authority signatures, one for each spend description items: type: object properties: value: type: string description: Spend authorization signature (hex without 0x prefix) example: 66c806bc592a7599e65833bf25c3c7005c8b21b7895dd835a84c97d7bec49d0f1493d2c73a68eeb9b9699b92cae42406f9e44ebe19acaea3d5febfe28de57109 responses: '200': description: Successfully generated trigger input parameters content: application/json: schema: type: object properties: trigger_contract_input: type: string description: Formatted input data for triggering the shielded TRC20 contract example: a9059cbb000000000000000000000041... /isshieldedtrc20contractnotespent: post: tags: - General summary: Wallet/Isshieldedtrc20Contractnotespent operationId: isShieldedTRC20ContractNoteSpent requestBody: required: true content: application/json: schema: type: object required: - note - ak - nk - position - shielded_TRC20_contract_address properties: note: type: object description: The note to check for spending status required: - value - payment_address - rcm properties: value: type: integer description: Scaled value (multiplied by contract's scalingFactor) example: 40 payment_address: type: string description: Shielded payment address example: ztron1768kf7dy4qquefp46szk978d65eeua66yhr4zv260c0uzj68t3tfjl3en9lhyyfxalv4jus30xs rcm: type: string description: Random commitment trapdoor (64 hex characters, no 0x prefix) example: 296070782a94c6936b0b4f6daf8d7c7605a4374fe595b96148dc0f4b59015d0d ak: type: string description: Authorization key (64 hex characters, no 0x prefix) example: 8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64 nk: type: string description: Nullifier key (64 hex characters, no 0x prefix) example: 590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14 position: type: integer description: Leaf position index in Merkle tree example: 272 shielded_TRC20_contract_address: type: string description: Shielded TRC20 contract address (hex format, no 0x prefix) example: 41274fc7464fadac5c00c893c58bce6c39bf59e4c7 responses: '200': description: Successfully checked nullifier spending status content: application/json: schema: type: object properties: is_spent: type: boolean description: Whether the note has been spent (true = spent, false = unspent) example: false /jsonrpc_eth_accounts: post: tags: - General summary: Eth_Accounts operationId: ethAccounts requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_accounts default: eth_accounts params: type: array items: {} default: [] id: oneOf: - type: string - type: integer default: 1 responses: '200': description: Array of addresses owned by the client content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 1 result: type: array description: Array of addresses owned by the client items: type: string example: - '0x407d73d8a49eeb85d32cf465507dd71d507100c1' /jsonrpc_eth_blocknumber: post: tags: - General summary: eth_blockNumber operationId: blockNumber requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_blockNumber id: type: integer default: 1 params: type: array default: [] items: {} responses: '200': description: Current block number in hexadecimal format content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The current block number encoded as hexadecimal. /jsonrpc_eth_blocknumber_test: post: summary: eth_blockNumber requestBody: required: true content: application/json: schema: type: object properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_blockNumber params: type: array default: [] id: type: integer default: 1 responses: '200': description: Success content: application/json: schema: type: object tags: - General operationId: jsonrpc_eth_blocknumber_test /jsonrpc_eth_call: post: tags: - General summary: Eth_Call operationId: call requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_call id: type: integer default: 1 params: type: array default: - to: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b' data: '0x70a08231000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b' - latest items: oneOf: - type: object description: Transaction object with to, from, gas, gasPrice, value, data fields - type: string description: Block parameter (latest, earliest, pending, or hex block number) minItems: 2 maxItems: 2 responses: '200': description: Return value of the executed contract function content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The return value of the executed contract function as hex string /jsonrpc_eth_chainid: post: tags: - General summary: eth_chainId operationId: ethChainId requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_chainId default: eth_chainId params: type: array items: {} default: [] id: oneOf: - type: string - type: integer default: 1 responses: '200': description: Chain ID in hexadecimal format content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 1 result: type: string description: 'Chain ID as hexadecimal string (TRON mainnet: 0x2b6653dc, testnet: 0x94a9059e)' example: '0x2b6653dc' /jsonrpc_eth_coinbase: post: tags: - General summary: Eth_Coinbase operationId: ethCoinbase requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_coinbase default: eth_coinbase params: type: array items: {} default: [] id: oneOf: - type: string - type: integer default: 1 responses: '200': description: Coinbase address content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 1 result: type: string description: Coinbase address as hexadecimal string example: '0x407d73d8a49eeb85d32cf465507dd71d507100c1' /jsonrpc_eth_estimateGas: post: tags: - General summary: eth_estimateGas operationId: estimateGas requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_estimateGas id: type: integer default: 1 params: type: array default: - to: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b' from: '0xb60e8dd61c5d32be8058bb8eb970870f07233155' value: '0x9184e72a' items: type: object description: Transaction object with to, from, gas, gasPrice, value, data fields responses: '200': description: Estimated gas amount needed for the transaction content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The estimated gas amount as hex string /jsonrpc_eth_gasPrice: post: tags: - General summary: eth_gasPrice operationId: gasPrice requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_gasPrice id: type: integer default: 1 params: type: array default: [] items: {} responses: '200': description: Current gas price in wei content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The current gas price in wei as hex string /jsonrpc_eth_getBlockByHash: post: tags: - General summary: eth_getBlockByHash operationId: getBlockByHash requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getBlockByHash id: type: integer default: 1 params: type: array default: - '0x1b4' - true items: oneOf: - type: string description: Block hash - type: boolean description: If true, return full transaction objects; if false, only hashes minItems: 2 maxItems: 2 responses: '200': description: Block information including transactions content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: object description: Block object containing block information /jsonrpc_eth_getBlockByNumber: post: tags: - General summary: eth_getBlockByNumber operationId: getBlockByNumber requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getBlockByNumber id: type: integer default: 1 params: type: array default: - latest - true items: oneOf: - type: string description: Block number in hex or 'latest'|'earliest'|'pending' - type: boolean description: If true, return full transaction objects; if false, only hashes minItems: 2 maxItems: 2 responses: '200': description: Block information including transactions content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: object description: Block object containing block information /jsonrpc_eth_getBlockTransactionCountByHash: post: tags: - General summary: eth_getBlockTransactionCountByHash operationId: ethGetBlockTransactionCountByHash requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_getBlockTransactionCountByHash default: eth_getBlockTransactionCountByHash params: type: array items: type: string default: - '0x00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b' id: oneOf: - type: string - type: integer default: 1 responses: '200': description: Number of transactions in the specified block content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 1 result: type: string description: Number of transactions in the block as hexadecimal example: '0x1' /jsonrpc_eth_getBlockTransactionCountByNumber: post: tags: - General summary: eth_getBlockTransactionCountByNumber operationId: ethGetBlockTransactionCountByNumber requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_getBlockTransactionCountByNumber default: eth_getBlockTransactionCountByNumber params: type: array items: type: string default: - '0xF96B0F' id: oneOf: - type: string - type: integer default: 1 responses: '200': description: Number of transactions in the specified block content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 1 result: type: string description: Number of transactions in the block as hexadecimal example: '0x2' /jsonrpc_eth_getCode: post: tags: - General summary: eth_getCode operationId: getCode requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getCode id: type: integer default: 1 params: type: array default: - '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b' - latest items: type: string minItems: 2 maxItems: 2 responses: '200': description: Contract bytecode at the specified address content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: Contract bytecode as hex string (returns '0x' for non-contract addresses) /jsonrpc_eth_getFilterChanges: post: tags: - General summary: eth_getFilterChanges operationId: getFilterChanges requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getFilterChanges id: type: integer default: 71 params: type: array default: - '0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996' items: type: string description: The filter ID returned by eth_newFilter or eth_newBlockFilter responses: '200': description: Array of log objects or block hashes since last poll content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: array description: Array of log objects (for log filters) or block hashes (for block filters) items: {} /jsonrpc_eth_getFilterLogs: post: tags: - General summary: eth_getFilterLogs operationId: getFilterLogs requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getFilterLogs id: type: integer default: 71 params: type: array default: - '0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996' items: type: string description: The filter ID returned by eth_newFilter responses: '200': description: Array of all log objects matching the filter criteria content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: array description: Array of all log objects that match the filter criteria items: {} /jsonrpc_eth_getLogs: post: tags: - General summary: eth_getLogs operationId: getLogs requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getLogs id: type: integer default: 1 params: type: array default: - fromBlock: '0x1' toBlock: '0x2' address: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b' topics: - '0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b' items: type: object description: Filter object with fromBlock, toBlock, address, and topics responses: '200': description: Array of log objects matching the filter criteria content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: array description: Array of log objects matching the filter criteria /jsonrpc_eth_getStorageAt: post: tags: - General summary: eth_getStorageAt operationId: getStorageAt requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getStorageAt id: type: integer default: 1 params: type: array default: - '0x407d73d8a49eeb85d32cf465507dd71d507100c1' - '0x0' - latest items: type: string minItems: 3 maxItems: 3 responses: '200': description: Storage value at the specified position content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The value at the storage position as hex string /jsonrpc_eth_getTransactionByBlockHashAndIndex: post: tags: - General summary: eth_getTransactionByBlockHashAndIndex operationId: ethGetTransactionByBlockHashAndIndex requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_getTransactionByBlockHashAndIndex default: eth_getTransactionByBlockHashAndIndex params: type: array items: type: string default: - 00000000020ef11c87517739090601aa0a7be1de6faebf35ddb14e7ab7d1cc5b - '0x0' minItems: 2 maxItems: 2 id: oneOf: - type: string - type: integer default: 64 responses: '200': description: Transaction object or null if not found content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 64 result: type: object nullable: true description: Transaction object with Ethereum-compatible fields or null /jsonrpc_eth_getTransactionByBlockNumberAndIndex: post: tags: - General summary: eth_getTransactionByBlockNumberAndIndex operationId: ethGetTransactionByBlockNumberAndIndex requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_getTransactionByBlockNumberAndIndex default: eth_getTransactionByBlockNumberAndIndex params: type: array items: type: string default: - '0xfb82f0' - '0x0' minItems: 2 maxItems: 2 id: oneOf: - type: string - type: integer default: 64 responses: '200': description: Transaction object or null if not found content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 64 result: type: object nullable: true description: Transaction object with Ethereum-compatible fields or null /jsonrpc_eth_getTransactionByHash: post: tags: - General summary: eth_getTransactionByHash operationId: getTransactionByHash requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getTransactionByHash id: type: integer default: 1 params: type: array default: - '0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b' items: type: string description: Transaction hash responses: '200': description: Transaction information content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: object description: Transaction object containing transaction details /jsonrpc_eth_getTransactionReceipt: post: tags: - General summary: eth_getTransactionReceipt operationId: getTransactionReceipt requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getTransactionReceipt id: type: integer default: 1 params: type: array default: - '0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b' items: type: string description: Transaction hash responses: '200': description: Transaction receipt including execution results and logs content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: object description: Receipt object containing transaction execution results /jsonrpc_eth_getWork: post: tags: - General summary: eth_getWork operationId: ethGetWork requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_getWork default: eth_getWork params: type: array items: {} default: [] minItems: 0 maxItems: 0 id: oneOf: - type: string - type: integer default: 73 responses: '200': description: Work data or null if not available content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 73 result: type: array nullable: true description: Array containing [current block hash, seed hash, boundary condition] or null items: type: string /jsonrpc_eth_getbalance: post: tags: - General summary: eth_getBalance operationId: getBalance requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_getBalance id: type: integer default: 1 params: type: array default: - '0x407d73d8a49eeb85d32cf465507dd71d507100c1' - latest items: type: string minItems: 2 maxItems: 2 responses: '200': description: Account balance in wei (hexadecimal format) content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The account balance in wei as hexadecimal string /jsonrpc_eth_newBlockFilter: post: tags: - General summary: eth_newBlockFilter operationId: newBlockFilter requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_newBlockFilter id: type: integer default: 1 params: type: array default: [] items: {} description: Empty array - no parameters required responses: '200': description: Filter ID for use with other filter methods content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: A filter ID (hex-encoded string) for use with other filter methods /jsonrpc_eth_newFilter: post: tags: - General summary: eth_newFilter operationId: newFilter requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_newFilter id: type: integer default: 1 params: type: array default: - address: - cc2e32f2388f0096fae9b055acffd76d4b3e5532 - E518C608A37E2A262050E10BE0C9D03C7A0877F3 fromBlock: '0x989680' toBlock: '0x9959d0' topics: - '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' - null - - '0x0000000000000000000000001806c11be0f9b9af9e626a58904f3e5827b67be7' - '0x0000000000000000000000003c8fb6d064ceffc0f045f7b4aee6b3a4cefb4758' items: type: object description: Filter object with address, fromBlock, toBlock, and topics responses: '200': description: Filter ID for use with other filter methods content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: A filter ID (hex-encoded string) for use with other filter methods /jsonrpc_eth_protocolVersion: post: tags: - General summary: eth_protocolVersion operationId: ethProtocolVersion requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_protocolVersion default: eth_protocolVersion params: type: array items: {} default: [] id: oneOf: - type: string - type: integer default: 64 responses: '200': description: Current Ethereum protocol version content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 64 result: type: string description: Ethereum protocol version as hexadecimal string example: '0x41' /jsonrpc_eth_syncing: post: tags: - General summary: Eth_Syncing operationId: ethSyncing requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params - id properties: jsonrpc: type: string enum: - '2.0' default: '2.0' method: type: string enum: - eth_syncing default: eth_syncing params: type: array items: {} default: [] id: oneOf: - type: string - type: integer default: 64 responses: '200': description: Sync status object or false if not syncing content: application/json: schema: type: object properties: jsonrpc: type: string example: '2.0' id: oneOf: - type: string - type: integer example: 64 result: oneOf: - type: boolean description: False if not syncing example: false - type: object description: Sync status object properties: startingBlock: type: string description: Block at which sync started currentBlock: type: string description: Current block being processed highestBlock: type: string description: Highest known block /jsonrpc_eth_uninstallFilter: post: tags: - General summary: eth_uninstallFilter operationId: uninstallFilter requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: eth_uninstallFilter id: type: integer default: 71 params: type: array default: - '0xc11a84d5e906ecb9f5c1eb65ee940b154ad37dce8f5ac29c80764508b901d996' items: type: string description: The filter ID returned by eth_newFilter or eth_newBlockFilter minItems: 1 maxItems: 1 responses: '200': description: Boolean indicating whether the filter was successfully uninstalled content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: boolean description: True if the filter was successfully uninstalled, false otherwise /jsonrpc_net_listening: post: tags: - General summary: Net_Listening operationId: netListening requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: net_listening id: type: integer default: 64 params: type: array default: [] items: {} description: Empty array - no parameters required responses: '200': description: Boolean indicating whether the client is listening for connections content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: boolean description: True if the client is actively listening for network connections, false otherwise /jsonrpc_net_peerCount: post: tags: - General summary: net_peerCount operationId: netPeerCount requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: net_peerCount id: type: integer default: 64 params: type: array default: [] items: {} description: Empty array - no parameters required responses: '200': description: Hex-encoded number of connected peers content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: Hex-encoded string representing the number of connected peers /jsonrpc_net_version: post: tags: - General summary: Net_Version operationId: netVersion requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id properties: jsonrpc: type: string default: '2.0' method: type: string default: net_version id: type: integer default: 1 params: type: array default: [] items: {} responses: '200': description: Current network ID content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: The network ID as a string /jsonrpc_web3_clientVersion: post: tags: - General summary: web3_clientVersion operationId: web3ClientVersion requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: web3_clientVersion id: type: integer default: 1 params: type: array default: [] items: {} description: Empty array - no parameters required responses: '200': description: Client version string content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: String containing the client version information /jsonrpc_web3_sha3: post: tags: - General summary: Web3_Sha3 operationId: web3Sha3 requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - id - params properties: jsonrpc: type: string default: '2.0' method: type: string default: web3_sha3 id: type: integer default: 1 params: type: array default: - '0x68656c6c6f20776f726c64' items: type: string description: Hex-encoded data to be hashed responses: '200': description: Keccak-256 hash of the input data content: application/json: schema: type: object properties: jsonrpc: type: string id: type: integer result: type: string description: Hex-encoded Keccak-256 hash of the input data /listexchanges: post: summary: List all trading pairs on the decentralized exchange description: Retrieves a list of all trading pairs available on the TRON decentralized exchange operationId: listExchanges requestBody: required: true content: application/json: schema: type: object properties: visible: type: boolean description: Whether to return human-readable addresses default: false examples: default: summary: Default request value: visible: true responses: '200': description: Successful response with list of exchanges content: application/json: schema: type: object properties: exchanges: type: array items: type: object properties: exchange_id: type: integer description: Unique identifier for the exchange pair creator_address: type: string description: Address that created the exchange pair create_time: type: integer description: Timestamp when the exchange was created first_token_id: type: string description: Token ID of the first token in the pair first_token_balance: type: string description: Current balance of the first token second_token_id: type: string description: Token ID of the second token in the pair second_token_balance: type: string description: Current balance of the second token examples: success: summary: Successful response value: exchanges: - exchange_id: 1 creator_address: TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH create_time: 1672531200000 first_token_id: '1000001' first_token_balance: '1000000000000' second_token_id: _ second_token_balance: '5000000000' - exchange_id: 2 creator_address: TKcEU8ekq2ZoFzLSGBSC2xps5c4yssLYVB create_time: 1672617600000 first_token_id: '1000002' first_token_balance: '500000000000' second_token_id: '1000001' second_token_balance: '2000000000000' '400': description: Bad request content: application/json: schema: type: object properties: Error: type: string examples: error: summary: Error response value: Error: Invalid request format tags: - General /listnodes: post: tags: - General summary: Wallet/Listnodes operationId: listNodes requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: List of network nodes content: application/json: schema: type: object properties: nodes: type: array items: type: object properties: address: type: object properties: host: type: string port: type: integer /listproposals: post: tags: - General summary: Wallet/Listproposals operationId: listProposals requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: List of all proposals content: application/json: schema: type: object properties: proposals: type: array items: type: object properties: proposal_id: type: integer proposer_address: type: string parameters: type: object additionalProperties: type: integer expiration_time: type: integer create_time: type: integer approvals: type: array items: type: string state: type: string enum: - PENDING - DISAPPROVED - APPROVED - CANCELED /listwitnesses: post: tags: - General summary: Wallet/Listwitnesses operationId: listWitnesses requestBody: required: false content: application/json: schema: type: object responses: '200': description: List of all witnesses on the network content: application/json: schema: type: object properties: witnesses: type: array description: Array of witness information items: type: object properties: address: type: string description: Witness address in hex format voteCount: type: number description: Total votes received by this witness pubKey: type: string description: Public key of the witness url: type: string description: Witness website URL totalProduced: type: number description: Total blocks produced by this witness totalMissed: type: number description: Total blocks missed by this witness latestBlockNum: type: number description: Latest block number produced latestSlotNum: type: number description: Latest slot number assigned isJobs: type: boolean description: Whether witness is currently active /marketbuyasset: post: tags: - General summary: Wallet/Marketbuyasset operationId: marketBuyAsset deprecated: true requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Account address placing the buy order sell_token_id: type: string description: TRC10 token ID being offered, as a numeric string. sell_token_quantity: type: integer description: Amount to offer as an integer (token base units; if TRX, sun). buy_token_id: type: string description: TRC10 token ID desired to purchase, as a numeric string. buy_token_quantity: type: integer description: Desired amount as an integer (token base units; if TRX, sun). visible: type: boolean description: When true, addresses are base58; when false, hex. default: true required: - owner_address - sell_token_id - sell_token_quantity - buy_token_id - buy_token_quantity example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC sell_token_id: '1000006' sell_token_quantity: 100000000 buy_token_id: '1002000' buy_token_quantity: 1000000 visible: true responses: '200': description: Market buy order transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for buy order raw_data: type: object properties: contract: type: array description: Contract details for market buy order ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /marketcancelorder: post: tags: - General summary: Wallet/Marketcancelorder operationId: marketCancelOrder requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Account address that created the order order_id: type: string description: Unique identifier of the order to cancel (hex string, no 0x prefix) required: - owner_address - order_id example: owner_address: 41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b order_id: 1234567890abcdef1234567890abcdef12345678 responses: '200': description: Order cancellation transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for order cancellation raw_data: type: object properties: contract: type: array description: Contract details for order cancellation ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /marketsellasset: post: tags: - General summary: Wallet/Marketsellasset operationId: marketSellAsset requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Account address placing the sell order sell_token_id: type: string description: Token ID being sold (empty string for TRX) sell_token_quantity: type: integer description: Quantity of tokens to sell (integer in token base units; if TRX, sun) buy_token_id: type: string description: Token ID desired in exchange (empty string for TRX) buy_token_quantity: type: integer description: Quantity of tokens desired in exchange (integer in token base units; if TRX, sun) visible: type: boolean description: When true, addresses are base58; when false, hex. default: true required: - owner_address - sell_token_id - sell_token_quantity - buy_token_id - buy_token_quantity example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC sell_token_id: '1000006' sell_token_quantity: 1000000 buy_token_id: '1002000' buy_token_quantity: 1000000 visible: true responses: '200': description: Market sell order transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for sell order raw_data: type: object properties: contract: type: array description: Contract details for market sell order ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /participateassetissue: post: tags: - General summary: Wallet/Participateassetissue operationId: participateAssetIssue requestBody: required: true content: application/json: schema: type: object required: - owner_address - to_address - asset_name - amount properties: owner_address: type: string description: Address participating in token offering default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g to_address: type: string description: Token issuer address default: TFgY1uN8buRxAtV2r6Zy5sG3ACko6pJT1y asset_name: type: string description: Name or ID of the TRC10 token default: MyToken amount: type: integer description: Amount of TRX to spend on tokens default: 1000000 visible: type: boolean description: Use base58 address format default: true responses: '200': description: Unsigned participate asset issue transaction content: application/json: schema: type: object properties: visible: type: boolean description: Address format indicator txID: type: string description: Transaction hash raw_data: type: object description: Raw transaction data properties: contract: type: array description: Contract array ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Hexadecimal raw transaction /proposalapprove: post: tags: - General summary: Wallet/Proposalapprove operationId: proposalApprove requestBody: required: true content: application/json: schema: type: object required: - owner_address - proposal_id - is_add_approval properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g proposal_id: type: integer default: 1 is_add_approval: type: boolean default: true visible: type: boolean default: true responses: '200': description: Proposal approval transaction content: application/json: schema: type: object properties: txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string signature: type: array items: type: string /proposalcreate: post: tags: - General summary: Wallet/Proposalcreate operationId: proposalCreate requestBody: required: true content: application/json: schema: type: object required: - owner_address - parameters properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g parameters: type: object properties: '0': type: integer description: Parameter ID and its new value default: '0': 3000000 visible: type: boolean default: true responses: '200': description: Proposal creation transaction content: application/json: schema: type: object properties: txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string signature: type: array items: type: string /proposaldelete: post: tags: - General summary: Wallet/Proposaldelete operationId: proposalDelete requestBody: required: true content: application/json: schema: type: object required: - owner_address - proposal_id properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g proposal_id: type: integer default: 1 visible: type: boolean default: true responses: '200': description: Proposal deletion transaction content: application/json: schema: type: object properties: txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string signature: type: array items: type: string /shielded_createshieldedtransaction: post: tags: - General summary: Wallet/Createshieldedtransaction operationId: createShieldedTransaction requestBody: required: true content: application/json: schema: type: object required: - to_address - to_amount properties: transparent_from_address: type: string description: Transparent TRX address sending funds example: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE from_amount: type: integer description: Amount to send from transparent address in sun example: 1000000 spend_authority_signature: type: array description: Array of spending authority signatures items: type: string ask: type: string description: Authentication secret key (64 hex characters, no 0x prefix) example: 08a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890 nsk: type: string description: Nullifier secret key (64 hex characters, no 0x prefix) example: 09a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890 ovk: type: string description: Outgoing viewing key (64 hex characters, no 0x prefix) example: 0aa1b2c3d4e5f6789012345678901234567890123456789012345678901234567890 to_address: type: string description: Recipient shielded address example: ztron1a2b3c4d5e6f7g8h9j0k1l2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f1g2h3j4k5l6m7n8p9 to_amount: type: integer description: Amount to send to shielded address in sun example: 1000000 responses: '200': description: Successfully created shielded transaction content: application/json: schema: type: object properties: txID: type: string description: Transaction ID hash (64 hex characters, no 0x prefix) example: 1a2b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890 raw_data_hex: type: string description: Raw transaction data in hexadecimal raw_data: type: object description: Structured raw transaction data /shielded_createshieldedtransactionwithoutspendauthsig: post: tags: - General summary: Wallet/Createshieldedtransactionwithoutspendauthsig operationId: createShieldedTransactionWithoutSpendAuthSig requestBody: required: true content: application/json: schema: type: object required: - to_address - to_amount properties: transparent_from_address: type: string description: Transparent TRX address sending funds example: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE from_amount: type: integer description: Amount to send from transparent address in sun example: 1000000 shielded_spends: type: array description: Array of shielded input specifications items: type: object shielded_receives: type: array description: Array of shielded output specifications items: type: object to_address: type: string description: Recipient shielded address example: ztron1a2b3c4d5e6f7g8h9j0k1l2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f1g2h3j4k5l6m7n8p9 to_amount: type: integer description: Amount to send to shielded address in sun example: 1000000 responses: '200': description: Successfully created unsigned shielded transaction content: application/json: schema: type: object properties: raw_data_hex: type: string description: Raw unsigned transaction data in hexadecimal raw_data: type: object description: Structured raw unsigned transaction data txID: type: string description: Preliminary transaction ID (will change after signing, 64 hex characters, no 0x prefix) example: 1a2b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890 /shielded_getakfromask: post: tags: - General summary: Wallet/Getakfromask operationId: getAkFromAsk requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: "Authentication secret key (ask) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef responses: '200': description: Successfully derived authentication key content: application/json: schema: type: object properties: value: type: string description: The derived authentication key (ak) in hexadecimal format (no 0x prefix) example: 03b2c3d4e5f6789012345678901234567890123456789abcdef0123456789abcd /shielded_getdiversifier: post: tags: - General summary: Wallet/Getdiversifier operationId: getDiversifier requestBody: required: true content: application/json: schema: type: object properties: {} responses: '200': description: Successfully generated diversifier content: application/json: schema: type: object properties: d: type: string description: The generated diversifier in hexadecimal format (22 hex characters, no 0x prefix) example: 06e5f678901234567890ab /shielded_getexpandedspendingkey: post: tags: - General summary: Wallet/Getexpandedspendingkey operationId: getExpandedSpendingKey requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: "Spending key as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef responses: '200': description: Successfully derived expanded spending key content: application/json: schema: type: object properties: ask: type: string description: Authentication secret key component nsk: type: string description: Nullifier secret key component ovk: type: string description: Outgoing viewing key component /shielded_getincomingviewingkey: post: tags: - General summary: Wallet/Getincomingviewingkey operationId: getIncomingViewingKey requestBody: required: true content: application/json: schema: type: object required: - ak - nk properties: ak: type: string description: "Authentication key (ak) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 03b2c3d4e5f67890123456789012345678901234567890123456789012345678 nk: type: string description: "Nullifier key (nk) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 04c3d4e5f6789012345678901234567890123456789012345678901234567890 responses: '200': description: Successfully derived incoming viewing key content: application/json: schema: type: object properties: ivk: type: string description: The derived incoming viewing key (ivk) in hexadecimal format (no 0x prefix) example: 05d4e5f6789012345678901234567890123456789012345678901234567890abcdef /shielded_getnkfromnsk: post: tags: - General summary: Wallet/Getnkfromnsk operationId: getNkFromNsk requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: "Nullifier secret key (nsk) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd responses: '200': description: Successfully derived nullifier key content: application/json: schema: type: object properties: value: type: string description: The derived nullifier key (nk) in hexadecimal format (no 0x prefix) example: 04b2c3d4e5f6789012345678901234567890123456789abcdef0123456789abcd /shielded_getshieldedpaymentaddress: post: tags: - General summary: Wallet/Getshieldedpaymentaddress operationId: getShieldedPaymentAddress requestBody: required: true content: application/json: schema: type: object required: - ivk - d properties: ivk: type: string description: "Incoming viewing key (ivk) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef d: type: string description: Diversifier as 11 bytes (22 hex) without 0x prefix. pattern: ^[0-9a-fA-F]{22}$ example: 06a1b2c3d4e5f6789012ab responses: '200': description: Successfully generated shielded payment address content: application/json: schema: type: object properties: pkd: type: string description: The payment address public key in hexadecimal format (no 0x prefix) example: 07a1b2c3d4e5f6789012345678901234567890123456789012345678901234567890 payment_address: type: string description: The complete shielded payment address example: ztron1a2b3c4d5e6f7g8h9j0k1l2m3n4p5q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f1g2h3j4k5l6m7n8p9 /shielded_getspendingkey: post: tags: - General summary: Wallet/Getspendingkey operationId: getSpendingKey requestBody: required: true content: application/json: schema: type: object properties: {} responses: '200': description: Successfully generated spending key content: application/json: schema: type: object properties: value: type: string description: The generated spending key in hexadecimal format (64 hex characters, no 0x prefix) example: 02a1b2c3d4e5f67890123456789012345678901234567890123456789012345678 /shielded_getzenpaymentaddress: post: tags: - General summary: Wallet/Getzenpaymentaddress operationId: getZenPaymentAddress requestBody: required: true content: application/json: schema: type: object required: - ivk - d properties: ivk: type: string description: "Incoming viewing key (ivk) as a 32\u2011byte (64\u2011hex) string without 0x prefix." pattern: ^[0-9a-fA-F]{64}$ example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef d: type: string description: Diversifier as 11 bytes (22 hex) without 0x prefix. pattern: ^[0-9a-fA-F]{22}$ example: 06e5f67890123456789012 responses: '200': description: Successfully generated shielded payment address content: application/json: schema: type: object properties: pkD: type: string description: Payment address public key component in hex (no 0x) example: 07f6789012345678901234567890123456789012345678901234567890abcdef01 payment_address: type: string description: Complete shielded payment address example: ztron1abcdefghijk123456789... /shielded_scanshieldedtrc20notesbyivk: post: tags: - General summary: Wallet/Scanshieldedtrc20Notesbyivk operationId: scanShieldedTRC20NotesByIvk requestBody: required: true content: application/json: schema: type: object required: - start_block_index - end_block_index - ivk - ak - nk - shielded_TRC20_contract_address properties: start_block_index: type: integer description: Starting block number for scanning example: 10000000 end_block_index: type: integer description: Ending block number for scanning example: 10000001 ivk: type: string description: Incoming viewing key for decrypting notes (64 hex characters, no 0x prefix) example: 9f8e74bb3d7188a2781dc1db38810c6914eef4570a79e8ec8404480948e4e305 ak: type: string description: Authentication key for verification (64 hex characters, no 0x prefix) example: 8072d9110c9de9d9ade33d5d0f5890a7aa65b0cde42af7816d187297caf2fd64 nk: type: string description: Nullifier key for note identification (64 hex characters, no 0x prefix) example: 590bf33f93f792be659fd404df91e75c3b08d38d4e08ee226c3f5219cf598f14 shielded_TRC20_contract_address: type: string description: Shielded TRC20 contract address to scan (hex format, no 0x prefix) example: 41274fc7464fadac5c00c893c58bce6c39bf59e4c7 responses: '200': description: Successfully scanned for shielded notes content: application/json: schema: type: object properties: noteTxs: type: array description: Array of found shielded note transactions items: type: object properties: txid: type: string description: Transaction ID containing the note index: type: integer description: Index of note within transaction note: type: object description: Decrypted note details properties: value: type: integer description: Note value payment_address: type: string description: Shielded payment address rcm: type: string description: Randomness commitment memo: type: string description: Optional memo field position: type: integer description: Position in the merkle tree is_spent: type: boolean description: Whether the note has been spent /shielded_scanshieldedtrc20notesbyovk: post: tags: - General summary: Wallet/Scanshieldedtrc20Notesbyovk operationId: scanShieldedTRC20NotesByOvk requestBody: required: true content: application/json: schema: type: object required: - start_block_index - end_block_index - ovk - shielded_TRC20_contract_address properties: start_block_index: type: integer description: Starting block number for scanning example: 10000000 end_block_index: type: integer description: Ending block number for scanning example: 10000001 ovk: type: string description: Outgoing viewing key for decrypting sent notes (64 hex characters, no 0x prefix) example: 0ff58efd75e083fe4fd759c8701e1c8cb6961c4297a12b2c800bdb7b2bcab889 shielded_TRC20_contract_address: type: string description: Shielded TRC20 contract address to scan (hex format, no 0x prefix) example: 41274fc7464fadac5c00c893c58bce6c39bf59e4c7 responses: '200': description: Successfully scanned for outgoing shielded notes content: application/json: schema: type: object properties: noteTxs: type: array description: Array of found outgoing shielded note transactions items: type: object properties: txid: type: string description: Transaction ID containing the note index: type: integer description: Index of note within transaction note: type: object description: Decrypted note details properties: value: type: integer description: Note value payment_address: type: string description: Recipient shielded payment address rcm: type: string description: Randomness commitment memo: type: string description: Optional memo field position: type: integer description: Position in the merkle tree is_spent: type: boolean description: Whether the note has been spent /test_jsonrpc: post: summary: Test method responses: '200': description: Success tags: - General operationId: test_jsonrpc /transferasset: post: tags: - General summary: Wallet/Transferasset operationId: transferAsset requestBody: required: true content: application/json: schema: type: object required: - owner_address - to_address - asset_name - amount properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g to_address: type: string default: TFgY1uN8buRxAtV2r6Zy5sG3ACko6pJT1y asset_name: type: string default: TOKEN_NAME amount: type: integer default: 1000000 visible: type: boolean default: true responses: '200': description: Unsigned TRC10 asset transfer transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object raw_data_hex: type: string /triggerconstantcontract: post: tags: - General summary: Wallet/Triggerconstantcontract operationId: triggerConstantContract requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address calling the contract method in hex format contract_address: type: string description: Smart contract address in hex format function_selector: type: string description: Function selector (method signature) to call parameter: type: string description: Encoded parameters for the function call required: - contract_address - function_selector example: owner_address: 41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b contract_address: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c function_selector: balanceOf(address) parameter: 000000000000000000000000b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b responses: '200': description: Contract call result content: application/json: schema: type: object properties: result: type: object properties: result: type: boolean description: Whether the call was successful energy_used: type: number description: Energy that would be consumed (for estimation) constant_result: type: array description: Return values from the contract method call items: type: string transaction: type: object description: Transaction object that would be created (not executed) /triggersmartcontract: post: tags: - General summary: Wallet/Triggersmartcontract operationId: triggerSmartContract requestBody: required: true content: application/json: schema: type: object required: - contract_address - function_selector - parameter - owner_address properties: contract_address: type: string default: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c function_selector: type: string default: transfer(address,uint256) parameter: type: string default: 000000000000000000000000e9d79cc47518930bc322d9bf7cddd260a0260a8d00000000000000000000000000000000000000000000000000000000000003e8 owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e call_value: type: integer default: 0 fee_limit: type: integer default: 10000000 visible: type: boolean default: false responses: '200': description: Smart contract execution result content: application/json: schema: type: object properties: result: type: object properties: result: type: boolean code: type: string message: type: string energy_used: type: integer constant_result: type: array items: type: string transaction: type: object logs: type: array /undelegateresource: post: tags: - General summary: Wallet/Undelegateresource operationId: undelegateResource requestBody: required: true content: application/json: schema: type: object required: - owner_address - receiver_address - balance - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e receiver_address: type: string default: 41e552f6487585c2b58bc2c9bb4492bc1f17132cd0 balance: type: integer default: 1000000 resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH visible: type: boolean default: false responses: '200': description: Undelegate resource transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string /unfreezeasset: post: tags: - General summary: Wallet/Unfreezeasset operationId: unfreezeAsset requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string description: Address that issued the token default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean description: Use base58 address format default: true responses: '200': description: Unsigned unfreeze asset transaction content: application/json: schema: type: object properties: visible: type: boolean description: Address format indicator txID: type: string description: Transaction hash raw_data: type: object description: Raw transaction data properties: contract: type: array description: Contract array ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Hexadecimal raw transaction /unfreezebalance: post: tags: - General summary: Wallet/Unfreezebalance operationId: unfreezeBalance deprecated: true requestBody: required: true content: application/json: schema: type: object required: - owner_address - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH receiver_address: type: string description: Optional. Address that was receiving the resources. Omit to unfreeze to yourself. Must not equal `owner_address`. visible: type: boolean default: false example: owner_address: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e resource: BANDWIDTH visible: false responses: '200': description: Unfreeze balance transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string '400': description: Validation error (bad receiver address) content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.ContractValidateException : receiverAddress must not be the same as ownerAddress' /unfreezebalancev2: post: tags: - General summary: Wallet/Unfreezebalancev2 operationId: unfreezeBalanceV2 requestBody: required: true content: application/json: schema: type: object required: - owner_address - unfreeze_balance - resource properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e unfreeze_balance: type: integer default: 1000000 resource: type: string enum: - BANDWIDTH - ENERGY default: BANDWIDTH visible: type: boolean default: false responses: '200': description: Unfreeze balance v2 transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string /updateaccount: post: tags: - General summary: Wallet/Updateaccount operationId: updateAccount requestBody: required: true content: application/json: schema: type: object required: - owner_address - account_name properties: owner_address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g account_name: type: string default: '0x7570646174654e616d6531353330383933343635353139' visible: type: boolean default: true responses: '200': description: Unsigned account update transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object raw_data_hex: type: string /updateasset: post: tags: - General summary: Wallet/Updateasset operationId: updateAsset requestBody: required: true content: application/json: schema: type: object required: - owner_address - description - url properties: owner_address: type: string description: Address that issued the token default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g description: type: string description: New token description default: Updated description for the TRC10 token url: type: string description: New token project website default: https://updated-example.com new_limit: type: integer description: New bandwidth limit for token operations default: 2000000 new_public_limit: type: integer description: New public bandwidth limit default: 2000000 visible: type: boolean description: Use base58 address format default: true responses: '200': description: Unsigned update asset transaction content: application/json: schema: type: object properties: visible: type: boolean description: Address format indicator txID: type: string description: Transaction hash raw_data: type: object description: Raw transaction data properties: contract: type: array description: Contract array ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Hexadecimal raw transaction /updatebrokerage: post: tags: - General summary: wallet/updateBrokerage operationId: updateBrokerage requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: 'Witness account address. Use base58 with `visible: true`, or hex with `visible: false`.' brokerage: type: number description: New brokerage percentage (0-100) visible: type: boolean description: When true, addresses are base58; when false, hex. default: true required: - owner_address - brokerage example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC brokerage: 15 visible: true responses: '200': description: Brokerage update transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the brokerage update raw_data: type: object properties: contract: type: array description: Contract details for brokerage update ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /updateenergylimit: post: tags: - General summary: Wallet/Updateenergylimit operationId: updateEnergyLimit requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address of the contract owner contract_address: type: string description: Address of the smart contract origin_energy_limit: type: number description: Maximum energy amount the contract creator provides (energy units) visible: type: boolean description: Whether to use visible (Base58) address format required: - owner_address - contract_address - origin_energy_limit example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC contract_address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t origin_energy_limit: 100000000 visible: true responses: '200': description: Contract energy limit update transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the energy limit update raw_data: type: object properties: contract: type: array description: Contract update details ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format '400': description: Validation error (e.g., account not found or not owner) content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.ContractValidateException : Account[41b3dcf27c251da9363f1a4888257c16676cf54edf] does not exist' /updatesetting: post: tags: - General summary: Wallet/Updatesetting operationId: updateSetting requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address of the contract owner contract_address: type: string description: Address of the smart contract consume_user_resource_percent: type: number description: Percentage (0-100) of caller's resources to consume minimum: 0 maximum: 100 visible: type: boolean description: Whether to use visible (Base58) address format required: - owner_address - contract_address - consume_user_resource_percent example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC contract_address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t consume_user_resource_percent: 10 visible: true responses: '200': description: Contract setting update transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the setting update raw_data: type: object properties: contract: type: array description: Contract update details ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format '400': description: Validation error (e.g., account not found or not owner) content: application/json: schema: type: object properties: Error: type: string example: Error: 'class org.tron.core.exception.ContractValidateException : Account[41b3dcf27c251da9363f1a4888257c16676cf54edf] does not exist' /updatewitness: post: tags: - General summary: Wallet/Updatewitness operationId: updateWitness requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Hexadecimal address of the witness account to update update_url: type: string description: New URL string for the witness (maximum 256 bytes) visible: type: boolean description: Whether addresses should be in visible format (Base58Check) required: - owner_address example: owner_address: TPswDDCAWhJAZGdHPidFg5nEf8TkNToDX1 update_url: https://example.com/witness visible: true responses: '200': description: Witness update transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for witness update transaction raw_data: type: object properties: contract: type: array description: Contract details for witness update items: type: object properties: type: type: string example: UpdateWitnessContract parameter: type: object properties: type_url: type: string example: type.googleapis.com/protocol.UpdateWitnessContract value: type: object properties: owner_address: type: string update_url: type: string ref_block_bytes: type: string description: Reference block bytes for validation ref_block_hash: type: string description: Hash of the reference block expiration: type: integer description: Transaction expiration timestamp timestamp: type: integer description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /validateaddress: post: tags: - General summary: Wallet/Validateaddress operationId: validateAddress requestBody: required: true content: application/json: schema: type: object required: - address properties: address: type: string default: TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs visible: type: boolean default: true responses: '200': description: Address validation result content: application/json: schema: type: object properties: result: type: boolean message: type: string /votewitnessaccount: post: tags: - General summary: Wallet/Votewitnessaccount operationId: voteWitnessAccount requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: 'Voting account address. Use base58 with `visible: true`, or hex with `visible: false`.' votes: type: array description: Array of vote allocations items: type: object properties: vote_address: type: string description: 'Witness address to vote for (base58 with `visible: true`, or hex with `visible: false`).' vote_count: type: number description: Number of votes to allocate required: - vote_address - vote_count visible: type: boolean description: When true, addresses are base58; when false, hex. default: true required: - owner_address - votes example: owner_address: THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC votes: - vote_address: TDdeM7G4HSxhn2MfovsiMWwXZkiFaHhjMB vote_count: 1000000 - vote_address: TAybtvPZCSj5kumiU4myD28xBy6WFtkgCu vote_count: 500000 visible: true responses: '200': description: Vote transaction for witnesses content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the vote raw_data: type: object properties: contract: type: array description: Contract details for witness voting ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /walletsolidity_getaccount: post: tags: - General summary: Walletsolidity/Getaccount operationId: getSolidityAccount requestBody: required: true content: application/json: schema: type: object required: - address properties: address: type: string default: TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g visible: type: boolean default: true responses: '200': description: Account information from solidified database content: application/json: schema: type: object properties: account_name: type: string address: type: string balance: type: integer create_time: type: integer latest_opration_time: type: integer asset: type: object assetV2: type: array items: type: object frozen: type: array items: type: object net_usage: type: object energy_usage: type: object owner_permission: type: object witness_permission: type: object active_permission: type: array items: type: object /walletsolidity_getblockbyid: post: tags: - General summary: Walletsolidity/Getblockbyid operationId: getSolidityBlockById requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: Block ID (hash) in hexadecimal format example: 0000000004326f801c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c1 responses: '200': description: Solidified block information content: application/json: schema: type: object properties: blockID: type: string description: Block hash identifier example: 0000000004326f801c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c1 block_header: type: object properties: raw_data: type: object properties: number: type: integer example: 70000000 txTrieRoot: type: string example: d41c56e7e8b4a9d4e7c8c7b4f3e6d5a2b1c9d8e7f6a5b4c3d2e1f0e9d8c7b6 parentHash: type: string example: 0000000004326f7f2c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c0 timestamp: type: integer example: 1704067200000 witness_address: type: string example: 41e38c95e0d7e9b68f7c8f7b4d3e6a5c2b1f9e8d7c6b5a4f3e2d1c0b9a8 witness_signature: type: string description: Witness signature for the block transactions: type: array description: Array of transactions in the block items: type: object properties: txID: type: string raw_data: type: object signature: type: array items: type: string blockSize: type: integer description: Size of the block in bytes example: 1024 /walletsolidity_getblockbylatestnum: post: tags: - General summary: Walletsolidity/Getblockbylatestnum operationId: getSolidityBlockByLatestNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer description: Number of latest blocks to retrieve example: 5 minimum: 1 maximum: 100 responses: '200': description: Array of the latest solidified blocks content: application/json: schema: type: object properties: block: type: array items: type: object properties: blockID: type: string description: Block hash identifier block_header: type: object properties: raw_data: type: object properties: number: type: integer timestamp: type: integer parentHash: type: string witness_address: type: string witness_signature: type: string transactions: type: array description: Transactions in the block items: type: object blockSize: type: integer description: Size of the block in bytes /walletsolidity_getblockbylimitnext: post: tags: - General summary: Walletsolidity/Getblockbylimitnext operationId: getSolidityBlockByLimitNext requestBody: required: true content: application/json: schema: type: object required: - startNum - endNum properties: startNum: type: integer description: Starting block number example: 70000000 endNum: type: integer description: Ending block number example: 70000010 responses: '200': description: Array of solidified blocks in the specified range content: application/json: schema: type: object properties: block: type: array items: type: object properties: blockID: type: string description: Block hash identifier block_header: type: object properties: raw_data: type: object properties: number: type: integer timestamp: type: integer parentHash: type: string witness_address: type: string witness_signature: type: string transactions: type: array description: Transactions in the block items: type: object blockSize: type: integer description: Size of the block in bytes /walletsolidity_getblockbynum: post: tags: - General summary: Walletsolidity/Getblockbynum operationId: getSolidityBlockByNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer description: Block number to retrieve example: 70000000 responses: '200': description: Solidified block information content: application/json: schema: type: object properties: blockID: type: string description: Block hash identifier example: 0000000004326f801c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c1 block_header: type: object properties: raw_data: type: object properties: number: type: integer example: 70000000 txTrieRoot: type: string example: d41c56e7e8b4a9d4e7c8c7b4f3e6d5a2b1c9d8e7f6a5b4c3d2e1f0e9d8c7b6 parentHash: type: string example: 0000000004326f7f2c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c0 timestamp: type: integer example: 1704067200000 witness_address: type: string example: 41e38c95e0d7e9b68f7c8f7b4d3e6a5c2b1f9e8d7c6b5a4f3e2d1c0b9a8 witness_signature: type: string description: Witness signature for the block transactions: type: array description: Array of transactions in the block items: type: object properties: txID: type: string raw_data: type: object signature: type: array items: type: string blockSize: type: integer description: Size of the block in bytes example: 1024 /walletsolidity_getnowblock: post: tags: - General summary: Walletsolidity/Getnowblock operationId: getSolidityNowBlock requestBody: required: false content: application/json: schema: type: object properties: {} responses: '200': description: Current solidified block information content: application/json: schema: type: object properties: blockID: type: string description: Current block hash identifier example: 0000000004326f801c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c1 block_header: type: object properties: raw_data: type: object properties: number: type: integer example: 70000000 description: Current block number txTrieRoot: type: string example: d41c56e7e8b4a9d4e7c8c7b4f3e6d5a2b1c9d8e7f6a5b4c3d2e1f0e9d8c7b6 parentHash: type: string example: 0000000004326f7f2c9c4b8c43c5e0b1f5e7b4c4a8ff6d02ab53a26d2344a5c0 timestamp: type: integer example: 1704067200000 description: Current block timestamp witness_address: type: string example: 41e38c95e0d7e9b68f7c8f7b4d3e6a5c2b1f9e8d7c6b5a4f3e2d1c0b9a8 witness_signature: type: string description: Witness signature for the current block transactions: type: array description: Transactions in the current block items: type: object properties: txID: type: string raw_data: type: object signature: type: array items: type: string blockSize: type: integer description: Size of the current block in bytes example: 1024 /walletsolidity_gettransactionbyid: post: tags: - General summary: Walletsolidity/Gettransactionbyid operationId: getSolidityTransactionById requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string default: 7c2d4206c38a026616067b2f80e3d4bb2d4b7f9ff90db8c98e8b7a89b7c8d3d visible: type: boolean default: true responses: '200': description: Transaction information from solidified database content: application/json: schema: type: object properties: ret: type: array items: type: object signature: type: array items: type: string txID: type: string raw_data: type: object raw_data_hex: type: string /walletsolidity_gettransactioncountbyblocknum: post: tags: - General summary: Walletsolidity/Gettransactioncountbyblocknum operationId: getSolidityTransactionCountByBlockNum requestBody: required: true content: application/json: schema: type: object required: - num properties: num: type: integer description: Block number to get transaction count for example: 70000000 minimum: 0 responses: '200': description: Transaction count in the specified solidified block content: application/json: schema: type: object properties: count: type: integer description: Number of transactions in the block example: 42 blockNumber: type: integer description: Block number queried example: 70000000 /walletsolidity_gettransactioninfobyid: post: tags: - General summary: Walletsolidity/Gettransactioninfobyid operationId: getSolidityTransactionInfoById requestBody: required: true content: application/json: schema: type: object required: - value properties: value: type: string description: Transaction ID (hash) in hexadecimal format example: 7c2d4206c59cc541d4b7eb7a0001bce8a7a77d1a2e3b5c4f7a8b9c0d1e2f3a4b responses: '200': description: Transaction execution information from solidified blocks content: application/json: schema: type: object properties: id: type: string description: Transaction hash identifier example: 7c2d4206c59cc541d4b7eb7a0001bce8a7a77d1a2e3b5c4f7a8b9c0d1e2f3a4b blockNumber: type: integer description: Block number containing the transaction example: 70000000 blockTimeStamp: type: integer description: Block timestamp example: 1704067200000 contractResult: type: array description: Contract execution results items: type: string fee: type: integer description: Transaction fee paid in sun example: 1100000 result: type: string description: Transaction execution result example: SUCCESS enum: - SUCCESS - REVERT - OUT_OF_TIME - OUT_OF_ENERGY resMessage: type: string description: Result message if transaction failed receipt: type: object description: Transaction receipt with resource usage properties: energy_usage: type: integer example: 65000 energy_fee: type: integer example: 1100000 net_usage: type: integer example: 345 net_fee: type: integer example: 0 log: type: array description: Event logs generated by the transaction items: type: object properties: address: type: string topics: type: array items: type: string data: type: string /withdrawbalance: post: tags: - General summary: Wallet/Withdrawbalance operationId: withdrawBalance requestBody: required: true content: application/json: schema: type: object properties: owner_address: type: string description: Address of the Super Representative withdrawing rewards visible: type: boolean description: Whether to use visible (Base58) address format required: - owner_address example: owner_address: TGj1Ej1qRzL9feLTLhjwgxXF4Ct6GTWg2U visible: true responses: '200': description: Witness balance withdrawal transaction content: application/json: schema: type: object properties: visible: type: boolean description: Whether addresses are in visible format txID: type: string description: Transaction ID for the withdrawal raw_data: type: object properties: contract: type: array description: Withdrawal contract details ref_block_bytes: type: string description: Reference block bytes ref_block_hash: type: string description: Reference block hash expiration: type: number description: Transaction expiration timestamp timestamp: type: number description: Transaction creation timestamp raw_data_hex: type: string description: Raw transaction data in hex format /withdrawexpireunfreeze: post: tags: - General summary: Wallet/Withdrawexpireunfreeze operationId: withdrawExpireUnfreeze requestBody: required: true content: application/json: schema: type: object required: - owner_address properties: owner_address: type: string default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e visible: type: boolean default: false responses: '200': description: Withdraw expired unfreeze transaction content: application/json: schema: type: object properties: visible: type: boolean txID: type: string raw_data: type: object properties: contract: type: array ref_block_bytes: type: string ref_block_hash: type: string expiration: type: integer timestamp: type: integer raw_data_hex: type: string