Accounts

Get GT Balance for a Single Address

Returns the GT balance of a given address.

https://gatescan.org/api
   ?module=account
   &action=balance
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	The string representing the address to check for balance

Response

{
   "status":"1",
   "message":"success",
   "data":"40891626854930000000000"
}

Tip: The result is returned to wei.

Get GT Balance for Multiple Addresses in a Single Call

Returns the balance of the accounts from a list of addresses.

https://gatescan.org/api
   ?module=account
   &action=balancemulti
   &address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae,0x63a9975ba31b0b9626b34300f7f627147df1f526
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	The strings representing the addresses to check for balance, separated by ,up to 20 addresses per call

Response

{
   "status":"1",
   "message":"success",
   "data":[
      {
         "account":"0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
         "balance":"40891626854930000000000"
      },
      {
         "account":"0x63a9975ba31b0b9626b34300f7f627147df1f526",
         "balance":"332567136222827062478"
      },
      {
         "account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
         "balance":"0"
      }
   ]
}

Tip: The result is returned to wei.

Get a list of 'Normal' Transactions By Address

Returns the list of transactions performed by an address, with optional pagination.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=txlist
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &startblock=162783
   &endblock=162786
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the addresses to check for balance
startblock	the integer block number to start searching for transactions
endblock	the integer block number to stop searching for transactions
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

{
  "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
  }
}

Get a list of 'Internal' Transactions by Address

Returns the list of internal transactions performed by an address, with optional pagination.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=txlistinternal
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &startblock=1
   &endblock=10000000
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the addresses to check for balance
startblock	the integer block number to start searching for transactions
endblock	the integer block number to stop searching for transactions
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

{
"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: ''
 }
]
}

Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=txlistinternal
   &txhash=0x4ebd7e3d33598a74260d6b5fd281a1356d6a9e2911dd8b9b874796e61129ad8a
   &apikey=YourApiKeyToken

Try this endpoint in your broswer
Usage:

• GRC-20 transfers from an address, specify the address parameter
• GRC-20 transfers from a contract address, specify the contract address parameter
• GRC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Request

Parameter	Description
txhash	the string representing the transaction hash to check for internal transactions

Response

{
   "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: ''
    }
  ]
}

Get "Internal Transactions" by Block Range

Returns the list of internal transactions performed within a block range, with optional pagination.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=txlistinternal
   &startblock=1
   &endblock=10000000
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
startblock	the integer block number to start searching for transactions
endblock	the integer block number to stop searching for transactions
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

{
   "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: ''
    },
    ...
  ]
}

Get a list of 'GRC20 - Token Transfer Events' by Address

Returns the list of GRC20 tokens transferred by an address, with optional filtering by token contract.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=tokentx
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &page=1
   &offset=100
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

• GRC-20 transfers from an address, specify the address parameter

• GRC-20 transfers from a contract address, specify the contract address parameter

• GRC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.

  Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
contractaddress	the string representing the token contract address to check for balance
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

Response

{
"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'
}
]
}

Get a list of 'GRC721 - Token Transfer Events' by Address

Returns the list of GRC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0x1644fc96c662d6f9cf7fa6e7992b666201a0b000
   &address=0xf71700eea83beb6d2e2e15d7303d1e619fd85a46
   &page=1
   &offset=100
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

• GRC-721 transfers from an address, specify the address parameter

• GRC-721 transfers from a contract address, specify the contract address parameter

• GRC-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.

  Try this endpoint in your broswer

  Request

  Parameter	Description
  address	the string representing the address to check for balance
  contractaddress	the string representing the token contract address to check for balance
  page	the integer page number, if pagination is enabled
  offset	the number of transactions displayed per page
  sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

  Response

  {
  "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'
      },
      ...
  ]
  }

Get a list of 'GRC1155 - Token Transfer Events' by Address

Returns the list of GRC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=token1155tx
   &contractaddress=0x227740e95f0b95872a6f6b6abf05a87b6bfbc078
   &address=0x4b81c30495f0cbf112902567918a323dddec2b61
   &page=1
   &offset=100
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

• GRC-1155 transfers from an address, specify the address parameter

• GRC-1155 transfers from a contract address, specify the contract address parameter

• GRC-1155 transfers from an address filtered by a token contract, specify both address and contract address parameters.

  Try this endpoint in your broswer

  Request

  Parameter	Description
  address	the string representing the address to check for balance
  contractaddress	the string representing the token contract address to check for balance
  page	the integer page number, if pagination is enabled
  offset	the number of transactions displayed per page
  sort	the sorting preference, use asc to sort by ascending and desc to sort by descending

  Response

  {
  "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'
    },
  ....
  ]
  }

Get list of Blocks Mined by Address

Returns the list of blocks mined by an address.

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=getminedblocks
   &address=gt11kwam9ym8ytp6adgg7p5jsrpn27gnvumtwul5aavy69lsmz8jkenjztmg5eueazakxx5dda
   &page=1
   &offset=100
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

{
   "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 }
  ]
}

Get GateChain assets By Address

Note : This API endpoint returns a maximum of 10000 records only.

https://gatescan.org/api
   ?module=account
   &action=tokenholding
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &page=1
   &offset=10
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

{
"status": 1,
"message": "success",
"data": {
"assets": [
  {
    "contractAddress": "0x4151Ab5072198D0843CD2999590Ef292F49d6c66",
    "name": "USDT",
    "symbol": "USDT",
    "quantity": "1",
    "status": 1
  },
  {
    "contractAddress": "0x672f30407A71fa8737A3A14474ff37E09c7Fc44a",
    "name": "Wrapped GT",
    "symbol": "WGT",
    "quantity": "0.001",
    "status": 1
  },
  {
    "contractAddress": "0xf3067befCb757e3d3bf7cFA16AfC7E7ef39282d0",
    "name": "Jin",
    "symbol": "JIN",
    "quantity": "1000000000000000",
    "status": 0
  },
  {
    "contractAddress": "0xAa5e0b2F0F308e6402C63Be0A8155531f12Cd8E2",
    "name": "NiHao",
    "symbol": "NH1",
    "quantity": "1000000000000000",
    "status": 0
  },
  {
    "contractAddress": "0xe340692cc0f24F4685a6A4145f26891B1c56De0b",
    "name": "Tian",
    "symbol": "TIAN",
    "quantity": "1000000000000000",
    "status": 0
  },
  {
    "contractAddress": "0xEe9c7e2c92f352ebF333795d54F1839eeD5B2a16",
    "name": "RwardB",
    "symbol": "RB",
    "quantity": "999999870000000",
    "status": 0
  },
  {
    "contractAddress": "0xF78a57451872cA55450a2ECD7B74c21ab630F8A4",
    "name": "RewardA",
    "symbol": "RA",
    "quantity": "9730750959.94876405",
    "status": 0
  },
  {
    "contractAddress": "0x3Bf989c00778C5C79A55Ab72A84F0701420eB0dB",
    "name": "L Token",
    "symbol": "L",
    "quantity": "4999999000.9940159631",
    "status": 0
  },
  {
    "contractAddress": "0x70e5984BD27D9dAD8aB7Ba69c9bEd01F85238187",
    "name": "te",
    "symbol": "RC",
    "quantity": "1009999973.9144447733",
    "status": 0
  },
  {
    "contractAddress": "0xEa9B04161476468400b08E16c6A12F63F6aD38c0",
    "name": "qq",
    "symbol": "kk",
    "quantity": "999870000",
    "status": 0
  }
],
"total": 65
}
}

Last updated on 2025/06/05