账户
查询单个账户GT余额
返回某个地址的 GT(代币)余额。
https://gatescan.org/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
{
"status":"1",
"message":"success",
"data":"40891626854930000000000"
}
Tip: The
resultis returned to wei.
查询多个账户GT余额
返回一组地址中各账户的余额。
https://gatescan.org/api
?module=account
&action=balancemulti
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae,0x63a9975ba31b0b9626b34300f7f627147df1f526
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| address | 表示待查询余额的地址 字符串 ,使用 , 分隔,每次最多支持 20 个地址 |
{
"status":"1",
"message":"success",
"data":[
{
"account":"0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
"balance":"40891626854930000000000"
},
{
"account":"0x63a9975ba31b0b9626b34300f7f627147df1f526",
"balance":"332567136222827062478"
},
{
"account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
"balance":"0"
}
]
}
Tip: The
resultis returned to wei.
查询账户交易列表
返回由某个地址发起的交易列表,支持可选的分页功能。
注意:此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=txlist
&address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
&startblock=162783
&endblock=162786
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| startblock | 开始搜索交易的区块号,类型为 整数 |
| endblock | 停止搜索交易的区块号,类型为 整数 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":{
"txs":[
{
hash: '0x1dcc56d5d6c6374518975bf4e2e554f143252423bc21021749f4e50af7dee4cd',
nonce: 348,
blockHash: '0x65ca9ceedf7e0d47fd409aba6aab18837fec61d9dd13948b4504495a68c54309',
blockNumber: 162783,
transactionIndex: 0,
from: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
to: '0x87a4515da9212e95aee1ed6e38bc0fba49b09148',
value: '0xde0cd3636594c00',
gas: 3000000,
gasPrice: 5000000000,
input: '0x2233258e0000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000000000550000000000000000000000000000000000000000000000000dcef33a6f838000000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c00000000000000000000000000000000000000000000000000000000612070bf',
blocktime: 1629429677,
status: 0
},
{
hash: '0x8c0a914bb2987682a3acda2d7dafee8a44579f612aa14415cf3b270df31bb496',
nonce: 349,
blockHash: '0x48aac32973520588ca8f92f90feff73d0f2f8429aefd432489815ed501cb950c',
blockNumber: 162786,
transactionIndex: 0,
from: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
to: '0x7734759cf8f9667136362ac58670337e2445eef6',
value: 0,
gas: 54459,
gasPrice: 5000000000,
input: '0x095ea7b300000000000000000000000087a4515da9212e95aee1ed6e38bc0fba49b091480000000000000000000000000000000000000000000000008ac7230489e80000',
blocktime: 1629429743,
status: 1
}
],
"total":10
}
}
根据 Address 查询内部交易列表
返回由某个地址发起的内部交易列表,支持可选的分页功能。
注意:此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=txlistinternal
&address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
&startblock=1
&endblock=10000000
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| startblock | 开始搜索交易的区块号,类型为 整数 |
| endblock | 停止搜索交易的区块号,类型为 整数 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":[
{
block_number: 40327,
time_stamp: 1625798967,
hash: '0x406ce5a5dbbdcf661260f9d46521e9dd10b64605f75279fb60fb08c5cd3f96da',
from: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
to: '',
value: '0',
contract_address: '0x406ce5a5dbbdcf661260f9d46521e9dd10b64605f75279fb60fb08c5cd3f96da',
input: '',
type: 'create',
gas: 2961627,
gas_used: 32000,
trace_id: 1830,
is_error: '',
err_code: ''
},
{
block_number: 40329,
time_stamp: 1625799007,
hash: '0x4aabf5103b10f85445ae5ac230ed10cd76decf2882797531973712db5990c09e',
from: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
to: '',
value: '0',
contract_address: '0x4aabf5103b10f85445ae5ac230ed10cd76decf2882797531973712db5990c09e',
input: '',
type: 'create',
gas: 2946627,
gas_used: 32000,
trace_id: 1830,
is_error: '',
err_code: ''
}
]
}
根据 TxHash 查询内部交易列表
返回某笔交易中执行的内部交易列表。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=txlistinternal
&txhash=0x4ebd7e3d33598a74260d6b5fd281a1356d6a9e2911dd8b9b874796e61129ad8a
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。 用法:
- GRC-20 要查询来自某个地址的 GRC-20 转账,请指定
address参数。 - GRC-20 要查询来自某个合约地址的转账,请指定合约地址参数。
- GRC-20 要查询来自某个地址并按代币合约筛选的转账,请同时指定地址参数和合约地址参数。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| txhash | 表示要查询内部交易的交易哈希的字符串 |
{
"status":"1",
"message":"success",
"data":[
{
block_number: 40329,
time_stamp: 1625799007,
hash: '0x4aabf5103b10f85445ae5ac230ed10cd76decf2882797531973712db5990c09e',
from: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
to: '',
value: '0',
contract_address: '0x4aabf5103b10f85445ae5ac230ed10cd76decf2882797531973712db5990c09e',
input: '',
type: 'create',
gas: 2946627,
gas_used: 32000,
trace_id: 1830,
is_error: '',
err_code: ''
}
]
}
根据 Block Number 查询内部交易列表
返回在区块范围内执行的内部交易列表,支持可选的分页功能。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=txlistinternal
&startblock=1
&endblock=10000000
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| Parameter | Description |
|---|---|
| startblock | 开始搜索交易的区块号,类型为 整数 |
| endblock | 停止搜索交易的区块号,类型为 整数 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":[
{
block_number: 1391095,
time_stamp: 1660792155,
hash: '0x68910424971eb0fa6d024d2804bd91ac491c8fed9b5e1f717eed9b0623c2cdcf',
from: '14903',
to: '1265506215217268269712048268397266551406741525455',
value: '0',
contract_address: '0x68910424971eb0fa6d024d2804bd91ac491c8fed9b5e1f717eed9b0623c2cdcf',
input: '',
type: 'delegatecall',
gas: 14903,
gas_used: 14682,
trace_id: 1078,
is_error: '',
err_code: ''
},
...
]
}
查询 GRC20 token 的交易列表
返回由某个地址发起的 GRC-20 代币转账列表,支持按代币合约进行可选筛选。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=tokentx
&contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
&address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
&page=1
&offset=100
&sort=asc
&apikey=YourApiKeyToken
Usage:
- 要查询来自某个地址的 GRC-20 转账,请指定
address参数。 - 要查询来自某个合约地址的 GRC-20 转账,请指定
合约地址参数。 - 要查询来自某个地址且按代币合约筛选的 GRC-20 转账,请同时指定
地址参数和合约地址参数。在 浏览器 中尝试此端点。
- 请求
- 响应
| Parameter | Description |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| contractaddress | 表示要查询余额的代币合约地址的 字符串 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":[
{
hash: '0xf16da68060d46f85c47db25497df7e13e63f0308bc5cdc71752dfe979015a50f',
nonce: 440,
blockNumber: 783082,
transactionIndex: 0,
from: '0x0000000000000000000000000000000000000000',
to: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
value: '100000000000000000',
gas: 1167926,
gasPrice: 5000000000,
input: '0x60806040526040518060400160405280600a81526020017f5465737420546f6b656e0000....'
contractAddress: '0x02d06ff5867c0797d2b9c338838dc1c3a8bffca2',
status: 1,
blocktime: 1647399710,
tokenName: 'Verify',
tokenSymbol: 'VEF'
}
]
}
查询 GRC721 token 的交易列表
返回由某个地址发起的GRC-721(NFT)代币转账列表,支持按代币合约进行可选筛选。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=tokennfttx
&contractaddress=0x1644fc96c662d6f9cf7fa6e7992b666201a0b000
&address=0xf71700eea83beb6d2e2e15d7303d1e619fd85a46
&page=1
&offset=100
&sort=asc
&apikey=YourApiKeyToken
Usage:
- 要查询来自某个地址的 GRC-721 转账,请指定
address参数。 - 要查询来自某个合约地址的 GRC-721 转账,请指定
合约地址参数。 - 要查询来自某个地址且按代币合约筛选的 GRC-721 转账,请同时指定
地址参数和合约地址参数。在 浏览器 中尝试此端点。
- 请求
- 响应
| 参数 | 描述 |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| contractaddress | 表示要查询余额的代币合约地址的 字符串 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":[
{
hash: '0xbc91921a500265c5409a178c95b178891010224bae213ac162f4accd6018e6d3',
nonce: 478,
blockNumber: 1247950,
transactionIndex: 0,
from: '0x0000000000000000000000000000000000000000',
to: '0xf71700eea83beb6d2e2e15d7303d1e619fd85a46',
value: '0x0',
gas: 139413,
gasPrice: 5000000000,
input: '0x375a069a000000000000000000000000000000000000000000000000000000000000001e',
contractAddress: '0x1644fc96c662d6f9cf7fa6e7992b666201a0b000',
status: 1,
blocktime: 1658336620,
tokenName: 'PETA',
tokenSymbol: 'Petabytes',
tokenDecimals: 0,
tokenId: '1'
},
...
]
}
查询 GRC1155 token 的交易列表
返回由某个地址发起的 GRC-1155(多代币标准)代币转账列表,支持按代币合约进行可选筛选。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=token1155tx
&contractaddress=0x227740e95f0b95872a6f6b6abf05a87b6bfbc078
&address=0x4b81c30495f0cbf112902567918a323dddec2b61
&page=1
&offset=100
&sort=asc
&apikey=YourApiKeyToken
Usage:
- 要查询来自某个地址的 GRC-1155 转账,请指定
address参数。 - 要查询来自某个合约地址的 GRC-1155 转账,请指定
合约地址参数。 - 要查询来自某个地址且按代币合约筛选的 GRC-1155 转账,请同时指定
地址参数和合约地址参数。在 浏览器 中尝试此端点。
- 请求
- Response
| 参数 | 描述 |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| contractaddress | 表示要查询余额的代币合约地址的 字符串 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
| sort | 排序方式,使用 asc 表示升序,desc 表示降序 |
{
"status":"1",
"message":"success",
"data":[
{
hash: '0xa29bdfa2aa36385985f487a1b34a5db3687a9c3bfa7b8fdb61205972aef810dc',
nonce: 29,
blockNumber: 1017566,
transactionIndex: 0,
from: '0x4b81c30495f0cbf112902567918a323dddec2b61',
to: '0x4b81c30495f0cbf112902567918a323dddec2b61',
value: '0xde0b6b3a7640000',
gas: 177189,
gasPrice: 5000000000,
input: '0xab834bab...'
contractAddress: '0x227740e95f0b95872a6f6b6abf05a87b6bfbc078',
status: 1,
blocktime: 1653029775,
tokenName: '',
tokenSymbol: '',
tokenDecimals: 0,
tokenId: '100',
tokenValue: '1'
},
....
]
}
获取按地址挖掘的区块列表
返回由某个地址挖掘的区块列表。
注意 : 此 API 接口最多仅返回 10000 条记录。
https://gatescan.org/api
?module=account
&action=getminedblocks
&address=gt11kwam9ym8ytp6adgg7p5jsrpn27gnvumtwul5aavy69lsmz8jkenjztmg5eueazakxx5dda
&page=1
&offset=100
&apikey=YourApiKeyToken
在 浏览器 中尝试此端点。
- 请求
- 响应
| Parameter | Description |
|---|---|
| address | 表示要查询余额的地址的 字符串 |
| page | 页码编号,类型为 整数,在启用分页时使用 |
| offset | 每页显示的交易数量 |
{
"status":"1",
"message":"success",
"data":[
{ blockNumber: 746700, timeStamp: 1646291509, blockReward: 0.4 },
{ blockNumber: 746706, timeStamp: 1646291690, blockReward: 0.4 },
{ blockNumber: 980185, timeStamp: 1652265780, blockReward: 0.4 },
{ blockNumber: 980197, timeStamp: 1652266044, blockReward: 0.4 },
{ blockNumber: 980198, timeStamp: 1652266050, blockReward: 0.4 },
{ blockNumber: 980202, timeStamp: 1652266114, blockReward: 0.4 },
{ blockNumber: 980217, timeStamp: 1652266410, blockReward: 0.4 },
{ blockNumber: 980218, timeStamp: 1652266414, blockReward: 0.4 },
{ blockNumber: 980247, timeStamp: 1652266950, blockReward: 0.4 },
{ blockNumber: 980248, timeStamp: 1652266954, blockReward: 0.4 }
]
}