波场

生成账户

请求方式:GET

请求地址:{{domain}}/tron/Transaction/newAccount

Query参数名 类型 必需 描述 示例 e.g.
appSecret string 接入密钥

返回示例:

                                {
    "status": 200,
    "data": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
    "key": "",
    "msg": "生成成功!"
}
                            
参数名 描述 类型
key 私钥 string
data 地址 string

查询余额

请求方式:GET

请求地址:{{domain}}/tron/Transaction/getBalance

Query参数名 类型 必需 描述 示例 e.g.
address string 账户地址 TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt

返回示例:

                                {
    "status": 200,
    "data": "99",
    "msg": "获取成功!"
}
                            
参数名 描述 类型
data 余额 string

发送交易

请求方式:POST

请求地址:{{domain}}/tron/Transaction/doTrans

Body参数名 类型 必需 描述 示例 e.g.
toAccount string 收款方账户
fromAccount string 发起方账户
key string 发起方私钥
num string 交易数量
appSecret string 接入方密钥

返回示例:

                                {
    "status": 200,
    "msg": "交易成功!",
    "data": "7b1a7100dbd569e6ab796711c32e1a0169811c7736c6505a3bec299bc056d0ae"
}
                            
参数名 描述 类型
data 交易哈希值 string

交易回调

请求方式:POST

请求地址:无

详细说明:

回调内容

返回示例:

                                {
    "id": "12",
    "app_id": "1",
    "address": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
    "other_address": "TCWKGPJb43jYJchYC3S4WvdRFNYCF7KEMg",
    "amount": "0.100000",
    "status": "1",
    "hash": "7b1a7100dbd569e6ab796711c32e1a0169811c7736c6505a3bec299bc056d0ae",
    "coin": "trx",
    "transaction_type": "2",
    "block": "23255604",
    "create_time": "1592994671",
    "is_done": "0"
}
                            
参数名 描述 类型
address string
other_address 对方地址 string
amount 数量 string
transaction_type 1:转账,2:收款 string
block 区块高度 string

交易状态

请求方式:GET

请求地址:{{domain}}/tron/Transaction/is_success

Query参数名 类型 必需 描述 示例 e.g.
txhash string 交易哈希值

返回示例:

                                {
    "status": 200,
    "data": 1,
    "msg": "交易已完成!"
}
                            
参数名 描述 类型
data 1完成 其他均为待确认 number

交易记录

请求方式:GET

请求地址:{{domain}}/tron/Transaction/getTransactionInner

Query参数名 类型 必需 描述 示例 e.g.
address string 账户地址
limit integer 每页记录数量
page integer 第几页

返回示例:

                                {
    "status": 200,
    "msg": "查询成功!",
    "total": 89,
    "data": [
        {
            "address": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
            "transaction_type": 2,
            "other_address": "TCWKGPJb43jYJchYC3S4WvdRFNYCF7KEMg",
            "amount": "0.10000000",
            "status": 1,
            "hash": "7b1a7100dbd569e6ab796711c32e1a0169811c7736c6505a3bec299bc056d0ae",
            "block": 23255604,
            "create_time": 1566230400,
            "confirms": 589
        }
    ]
}
                            
参数名 描述 类型
total 总记录数 number
data.transaction_type 1:转账,2:收款 number
data.other_address 对方地址 string
data.amount 数量 string
data.status 交易状态 number
data.hash hash值 string
data.block 交易所在块数 number
data.create_time 记录发生时间戳 number
data.confirms 确认数 number

交易记录2

请求方式:GET

请求地址:{{domain}}/tron/Transaction/txRecord

Query参数名 类型 必需 描述 示例 e.g.
address string 账户地址
limit int 每页结果数 默认20,最大200
fingerprint string 翻页参数, 指定上一页的 fingerprint

返回示例:

                                
									{
	"status": 200,
	"data": {
		"success": true,
		"meta": {
			"at": 1600076958981,
			"page_size": 1,
			"fingerprint": "3ARpe2xk8rFzHhznQwZRXgKVzwV73jg9LZMBxTafcZR3wbhjZs3GmwcR8Xt4BMQhJLvjpSkMMgEc8xrdXf7ZRunfYyo4Gp8o",
			"links": {
				"next": "https:\/\/api.trongrid.io:443\/v1\/accounts\/TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt\/transactions?limit=1&fingerprint=3ARpe2xk8rFzHhznQwZRXgKVzwV73jg9LZMBxTafcZR3wbhjZs3GmwcR8Xt4BMQhJLvjpSkMMgEc8xrdXf7ZRunfYyo4Gp8o"
			}
		},
		"data": [{
			"blockNumber": 23255604,
			"block_timestamp": 1600042314000,
			"energy_fee": 0,
			"energy_usage": 0,
			"energy_usage_total": 0,
			"internal_transactions": [],
			"net_fee": 0,
			"net_usage": 267,
			"raw_data": {
				"contract": [{
					"parameter": {
						"type_url": "type.googleapis.com\/protocol.TransferContract",
						"value": {
							"amount": 100000,
							"owner_address": "41d7f52870ac76b4c85d4be940ef27fba81cb73769",
							"to_address": "411bd26021a73aa2f7113f624256e869bca5042197"
						}
					},
					"type": "TransferContract"
				}],
				"expiration": 1600042371000,
				"fee_limit": 0,
				"ref_block_bytes": "da21",
				"ref_block_hash": "e16c9998a6dabf43",
				"timestamp": 1600042312897
			},
			"raw_data_hex": "0a02da212208e16c9998a6dabf4340b88fd4cfc82e5a67080112630a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412320a1541d7f52870ac76b4c85d4be940ef27fba81cb737691215411bd26021a73aa2f7113f624256e869bca504219718a08d0670c1c9d0cfc82e",
			"ret": [{
				"code": "SUCESS",
				"contractRet": "SUCCESS",
				"fee": 0
			}],
			"signature": ["4bbe316d3e15f16eda8375601489de10e8b2ebac34328df5d18508798407547c2c50b3aaa5484423354a6820be9fb44f8bbc465cabbd364419e99760d61e7a2500"],
			"txID": "7b1a7100dbd569e6ab796711c32e1a0169811c7736c6505a3bec299bc056d0ae"
		}]
	}
}
								
                            
参数名 描述 类型
data.raw_data.contract.parameter.value.amount 数量 string
data.ret.contractRet 交易状态 string
data.txID hash值 string
data.blockNumber 交易所在块数 number
data.raw_data.timestamp 记录发生时间戳 number

合约代币

查询合约信息

请求方式:GET

请求地址:{{domain}}/tron/Contract/getContract

Query参数名 类型 必需 描述 示例 e.g.
contract string 合约地址 TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

查询代币余额

请求方式:GET

请求地址:{{domain}}/tron/Contract/getBalance

Query参数名 类型 必需 描述 示例 e.g.
contract string 合约地址 TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
address string 账户地址 TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos
参数名 描述 类型
data 余额 string

代币发送交易

请求方式:POST

请求地址:{{domain}}/tron/Contract/doTrans

Body参数名 类型 必需 描述 示例 e.g.
contract string 合约地址 TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
toAccount string 收款方账户
fromAccount string 发起方账户
key string 发起方私钥
num string 交易数量
appSecret string 接入方密钥

返回示例:

                                {
    "status": 200,
    "msg": "交易成功!",
    "data": "47571260be470668c0ddc010d1aa7bec32bfda10893c072c82eb30d34ee2a953"
}
                            
参数名 描述 类型
data 交易哈希值 string

交易回调

请求方式:POST

请求地址:无

返回示例:

                                {
    "id": "12",
    "app_id": "1",
    "address": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
    "other_address": "TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos",
    "amount": "0.00100000",
    "status": "1",
    "hash": "47571260be470668c0ddc010d1aa7bec32bfda10893c072c82eb30d34ee2a953",
    "coin": "USDT",
    "transaction_type": "2",
    "block": "10327941",
    "create_time": "1592994671",
    "is_done": "0"
}
                            
参数名 描述 类型
address string
other_address 对方地址 string
amount 数量 string
transaction_type 1:转账,2:收款 string
block 区块高度 string

查询代币交易状态

请求方式:GET

请求地址:{{domain}}/tron/Contract/is_success

Query参数名 类型 必需 描述 示例 e.g.
contract string 合约地址
txhash string 交易哈希值
参数名 描述 类型
data 1完成 其他均为待确认 number

查询代币交易记录

请求方式:GET

请求地址:{{domain}}/tron/Transaction/getTransactionDbInner

Query参数名 类型 必需 描述 示例 e.g.
symbol integer 代币简称
address string 账户地址
limit string 每页记录数量
page string 第几页

返回示例:

                                {
    "status": 200,
    "msg": "查询成功!",
    "total": 89,
    "data": [
        {
            "address": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
            "transaction_type": 2,
            "other_address": "TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos",
            "amount": "0.00020000",
            "status": 1,
            "hash": "47571260be470668c0ddc010d1aa7bec32bfda10893c072c82eb30d34ee2a953",
            "block": 0,
            "create_time": 1566230400,
            "confirms": 7428418
        }
    ]
}
                            
参数名 描述 类型
data.create_time 记录发生时间戳 number
data.block 交易所在块数 number
data.hash hash值 string
data.status 交易状态 number
data.amount 数量 string
data.other_address 对方地址 string
data.transaction_type 1:转账,2:收款 number

查询代币交易记录2

请求方式:GET

请求地址:{{domain}}/tron/Contract/txRecord

Query参数名 类型 必需 描述 示例 e.g.
address string 账户地址
contract string 合约地址
limit int 每页结果数
fingerprint string 翻页参数, 指定上一页的 fingerprint

返回示例:

                                {
	"status": 200,
	"data": {
		"success": true,
		"meta": {
			"at": 1600264726288,
			"page_size": 3
		},
		"data": [{
			"from": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
			"to": "TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos",
			"block_timestamp": 1600223502000,
			"value": "1000000000000000000",
			"type": "Transfer",
			"transaction_id": "166dce7ac60d39ba18c1f0f1cdb3c9895bc23b4b569788d6bda90ccdc065aea6",
			"token_info": {
				"name": "bicoin",
				"symbol": "bii",
				"decimals": 18,
				"address": "TRALA7vGQGG8MH3L9StBg45AMznVt4xd6H"
			}
		}, {
			"from": "TVf5yBDEiqVKVTitha3vLFDpXeYVMWPKtt",
			"to": "TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos",
			"block_timestamp": 1600220910000,
			"value": "1000000",
			"type": "Transfer",
			"transaction_id": "de2db78e4a4d600440e80b2a1f83481f7551d21458f53bd54fc736cb7398d7d0",
			"token_info": {
				"name": "bicoin",
				"symbol": "bii",
				"decimals": 18,
				"address": "TRALA7vGQGG8MH3L9StBg45AMznVt4xd6H"
			}
		}, {
			"from": "TCWKGPJb43jYJchYC3S4WvdRFNYCF7KEMg",
			"to": "TE2AyzwCFakg68bZ4rKRjDCDBA4orzPKos",
			"block_timestamp": 1600178844000,
			"value": "50000000000000000000000",
			"type": "Transfer",
			"transaction_id": "b76f0218f685c60da71f50c0e50a023dc9951c49264837d7ee6000aec9668331",
			"token_info": {
				"name": "bicoin",
				"symbol": "bii",
				"decimals": 18,
				"address": "TRALA7vGQGG8MH3L9StBg45AMznVt4xd6H"
			}
		}]
	}
}
                            
参数名 描述 类型
data.value 数量 string
data.from 转出地址 string
data.to 转入地址 string
data.transaction_id hash值 string
data.token_info 合约信息 Json

附录

环境变量

线上环境
变量名 变量值
domain
Top