Links

hmy_getTransactionsHistory

hmy_getTransactionsHistory

Description

hmy_getTransactionsHistory get transactions history for an address
API ENDPOINTS ARE DIFFERENT FROM GENERAL API ENDPOINT:
Mainnet shard 0: e0.t.hmny.io:9500
Mainnet shard 1: e1.t.hmny.io:9500
Mainnet shard 2: e2.t.hmny.io:9500
Mainnet shard 3: e3.t.hmny.io:9500
Testnet shard 0: e0.b.hmny.io:9500
Testnet shard 1: e1.b.hmny.io:9500

Parameters

  • String - one address ("one1...")
  • txHistoryArgs - json args
    • txType - String : optional, Received or Sent, shows all transactions by default
    • fullTx - Bool : optional, shows full transaction or just its hash, default is false
    • pageSize - Number : optional, pagination page size, how much tx to show in single page, default is 100
    • pageIndex - Number : optional, pagination which page to show, default is 0
    • txType - String: optional, "ALL", "RECEIVED", "SENT", default is "ALL"
    • order - String: optional, "ASC", "DESC", default is "ASC", order by timestamp

API v1

Returns
  • Array - either returns list of transactions
    • hash - String: Hash of the transaction.
    • nonce - Number: The number of transactions made by the sender prior to this one.
    • blockHash - String: Hash of the block where this transaction was in. null when it's pending.
    • blockNumber - Number: Block number where this transaction was in. null when it's pending.
    • transactionIndex - Number: Integer of the transaction's index position in the block. null when its pending.
    • from - String: Address of the sender.
    • to - String: Address of the receiver.
    • value - String: Value transferred in ATTO.
    • gasPrice - String: Gas price provided by the sender.
    • gas - Number: Gas provided by the sender.
    • input - String: The data sent along with the transaction.
  • Array of String - or list of transactions hashes
Sample Curl Request 0
curl -d '{
"jsonrpc": "2.0",
"method": "hmy_getTransactionsHistory",
"params": [{
"address": "one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7",
"pageIndex": 0,
"pageSize": 1000,
"fullTx": true,
"txType": "ALL",
"order": "ASC"
}],
"id": 1
}'
Sample Curl Response 0
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactions": [
{
"blockHash": "0x0bde901cd3599aa082482777fd0a7fed3f02b7b5a9096b7ea7b2fcb8addaa05d",
"blockNumber": "0x12",
"from": "one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7",
"gas": "0x5208",
"gasPrice": "0x3b9aca00",
"hash": "0x230798fe22abff459b004675bf827a4089326a296fa4165d0c2ad27688e03e0c",
"input": "0x",
"nonce": "0x0",
"to": "one129r9pj3sk0re76f7zs3qz92rggmdgjhtwge62k",
"transactionIndex": "0x1",
"value": "0x16345785d8a0000",
"shardID": 0,
"toShardID": 0,
"v": "0x27",
"r": "0x57766aa1304e97f8b71a9fa54a61b61ce8ef9ad177fcb337dd81827aad184327",
"s": "0x3b3e5767899e8af5e75d62243a725371f08705b91e2305459e6fd8e8d2646651"
}
]
}
}
Sample Curl Request 1
curl -d '{
"jsonrpc": "2.0",
"method": "hmy_getTransactionsHistory",
"params": [{
"address": "one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7",
"pageIndex": 0,
"pageSize": 1000,
"fullTx": false,
"txType": "ALL",
"order": "ASC"
}],
"id": 1
}'
Sample Curl Response 1
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactions": [
"0x230798fe22abff459b004675bf827a4089326a296fa4165d0c2ad27688e03e0c"
]
}
}

API v2

Returns
  • Array - either returns list of transactions
    • hash - String: Hash of the transaction.
    • nonce - Number: The number of transactions made by the sender prior to this one.
    • blockHash - String: Hash of the block where this transaction was in. null when it's pending.
    • blockNumber - Number: Block number where this transaction was in. null when it's pending.
    • transactionIndex - Number: Integer of the transaction's index position in the block. null when its pending.
    • from - String: Address of the sender.
    • to - String: Address of the receiver.
    • value - Number: Value transferred in ATTO.
    • gasPrice - Number: Gas price provided by the sender.
    • gas - Number: Gas provided by the sender.
    • input - String: The data sent along with the transaction.
  • Array of String - or list of transactions hashes
Sample Curl Request 0
curl -d '{
"jsonrpc": "2.0",
"method": "hmyv2_getTransactionsHistory",
"params": [{
"address": "one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7",
"pageIndex": 0,
"pageSize": 1000,
"fullTx": true,
"txType": "ALL",
"order": "ASC"
}],
"id": 1
}'
Sample Curl Response 0
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactions": [
{
"blockHash": "0x6c92a52b0ef172e9352cf69acc945b310592c743a319d488053635e5caec730a",
"blockNumber": 4,
"from": "one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
"timestamp": 1580422063,
"gas": 21000,
"gasPrice": 1000000000,
"hash": "0x8b8d3e33442828e4eaed0c335cb6fdb953fbdbaef519261bd6ddec83d529d85e",
"input": "0x",
"nonce": 0,
"to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
"transactionIndex": 0,
"value": 100000000000000000,
"shardID": 0,
"toShardID": 1,
"v": "0x27",
"r": "0x55e9f46eca0060821a6bdafe51210132a174e93658ec1b7430ed7cb57a9abc1",
"s": "0x4105b1d6c7310ea4af44759d717d8a5c9b52731e4877ae45110da43f184905f8"
},
{
"blockHash": "0x6e056a09aa5a96bf3533bb21c0ec2b5dcfe0186215146e68fa2d05eb017e0594",
"blockNumber": 10,
"from": "one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
"timestamp": 1580422111,
"gas": 21000,
"gasPrice": 1000000000,
"hash": "0xe3c321cb567de1efaf598364ee343e0d847106b881f4002f894a939de88e8cbc",
"input": "0x",
"nonce": 1,
"to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
"transactionIndex": 0,
"value": 100000000000000000,
"shardID": 0,
"toShardID": 1,
"v": "0x27",
"r": "0xd15867fe581a54ce417d98f94abb52fa4358841b5dedcbba0cab19ecd0c0fd4e",
"s": "0x21c80f304eb1f27875bd1f5baeed6d75cb057e89533886195f2201686fd8e1ff"
}
]
}
}
Sample Curl Request 1
curl -d '{
"jsonrpc": "2.0",
"method": "hmyv2_getTransactionsHistory",
"params": [{
"address": "one103q7qe5t2505lypvltkqtddaef5tzfxwsse4z7",
"pageIndex": 0,
"pageSize": 1000,
"fullTx": false,
"txType": "ALL",
"order": "ASC"
}],
"id": 1
}'
Sample Curl Response 1
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"transactions": [
"0x230798fe22abff459b004675bf827a4089326a296fa4165d0c2ad27688e03e0c"
]
}
}