1 of 21

Transaction Related Methods

hmy_getStakingTransactionByBlockHashAndIndex

Get staking transaction at an index from a given block, specified by block hash.

API v1

Parameters

String - The block hash.
Number - The staking transaction index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getStakingTransactionByBlockHashAndIndex",
    "params":[
        "0x428ead93e632d5255ea3d1fb61b02ab8493cf562a398af2159c33ecd53c62c16",
        "0x0"
    ],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

API v2

Parameters

String - The block hash.
Number - The staking transaction index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getStakingTransactionByBlockHashAndIndex",
    "params":[
        "0x428ead93e632d5255ea3d1fb61b02ab8493cf562a398af2159c33ecd53c62c16",
        0
    ],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

hmy_getStakingTransactionByBlockNumberAndIndex

Get staking transaction at an index from a given block, specified by number.

API v1

Parameters

String - The block's index in the chain.
String - The staking transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

Sample Curl Response

API v2

Parameters

Number- The block's index in the chain.
Number - The transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

Sample Curl Response

hmy_getStakingTransactionByHash

Get staking transaction by its hash.

API v1

Parameters

String - The staking transaction hash.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getStakingTransactionByHash",
    "params":[
      "0x1dff358dad4d0fc95b11acc9826b190d8b7971ac26b3f7ebdee83c10cafaf86f"
    ],
    "id":1
}' -H 'Content-Type:application/json' -X POST 'https://api.s0.b.hmny.io'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

API v2

Parameters

String- The staking transaction hash.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
timestamp - Number: transaction timestamp
from - String: Address of the sender.
value - String: Value transferred in ATTO.
gasPrice - String: Gas price provided by the sender.
gas - Number: Gas provided by the sender.
v - String: signature V
r - String: signature R
s - String: signature S
type - String: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg - StakingMsg:
- CreateValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - maxCommissionRate - Number: validator commission rate
  - maxChangeRate - Number: validator max commission rate change
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - amount - Number: stake amount for validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeys - []String: validator bls pub keys
- EditValidator:
  - validatorAddress - String: validator address
  - name - String: validator name
  - commissionRate - Number: validator commission rate
  - minSelfDelegation - Number: min how much validator self delegates
  - maxTotalDelegation - Number: max total delegation to validator
  - website - String: validator website
  - identity - String: validator kyc identity
  - securityContact - String: validator security contact
  - details - String: additional validator info
  - slotPubKeyToAdd - String: validator bls pub key to add
  - slotPubKeyToRemove - String: validator bls pub key to remove
- CollectRewards:
  - delegatorAddress - String: address to send rewards
- Delegate:
  - delegatorAddress - String: delegation delegator address
  - validatorAddress - String: delegation validator address
  - amount - Number: big.Int amount for delegation to validator
- Undelegate:
  - delegatorAddress - String: undelegation delegator address
  - validatorAddress - String: undelegation validator address
  - amount - Number: big.Int amount for undelegation to delegator

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getStakingTransactionByHash",
    "params":[
       "0x1dff358dad4d0fc95b11acc9826b190d8b7971ac26b3f7ebdee83c10cafaf86f"
    ],
    "id":1
}' -H 'Content-Type:application/json' -X POST 'https://api.s0.b.hmny.io'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

hmy_getCurrentTransactionErrorSink

API v1

Returns

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmy_getCurrentTransactionErrorSink",
    "params": [],
    "id": 1
}'

Sample Curl Response

API v2

Returns

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmyv2_getCurrentTransactionErrorSink",
    "params": [],
    "id": 1
}'

Sample Curl Response

hmy_getPendingCrossLinks

API v1

Returns

See latest header and blocks format

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmy_getPendingCrossLinks",
    "params": [],
    "id": 1
}'

Sample Curl Response

See latest header and blocks response

API v2

Returns

See latest header and blocks format

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmyv2_getPendingCrossLinks",
    "params": [],
    "id": 1
}'

Sample Curl Response

See latest header and blocks response

hmy_getPendingCXReceipts

API v1

Returns

Array of pending cx receipts in tx pool. See hmy_getCXReceiptByHash for format

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmy_getPendingCXReceipts",
    "params": [],
    "id": 1
}'

Sample Curl Response

See hmy_getCXReceiptByHash response

API v2

Returns

Array of pending cx receipts in tx pool. See hmy_getCXReceiptByHash for format

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmyv2_getPendingCXReceipts",
    "params": [],
    "id": 1
}'

Sample Curl Response

See hmy_getCXReceiptByHash response

hmy_getCXReceiptByHash

API v1

Parameters

String - transactions hash for cx receipt

Returns

blockHash - String - block hash
blockNumber - Number - block number
hash - String - transaction hash
from - String - from one address
to - String - to one address
shardID - Number - shard id from where transaction sent
toShardID - Number - shard id to where transaction sent
value - Number - transaction sent value

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmy_getCXReceiptByHash",
    "params": [
        "0x6b106dc5619c86b6c0cb64b17e5c464e8008e08cf0f1bb0e3fa2657fb42daade"
    ],
    "id": 1
}'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x864e39e8bd21bd983cd78231b5d14bb43a7f43d45bfa6111439956ce4be8bb5d",
        "blockNumber": "0x2b",
        "hash": "0x6b106dc5619c86b6c0cb64b17e5c464e8008e08cf0f1bb0e3fa2657fb42daade",
        "from": "one1uyshu2jgv8w465yc8kkny36thlt2wvel89tcmg",
        "to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
        "shardID": 1,
        "toShardID": 0,
        "value": "0x16345785d8a0000"
    }
}

API v2

Parameters

String - transactions hash for cx receipt

Returns

blockHash - String - block hash
blockNumber - Number - block number
hash - String - transaction hash
from - String - from one address
to - String - to one address
shardID - Number - shard id from where transaction sent
toShardID - Number - shard id to where transaction sent
value - Number - transaction sent value

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmyv2_getCXReceiptByHash",
    "params": [
        "0xc6da1349d2c2fbb5724126fe9e462996f8f8b415275e411d39a72945d3cb05ef"
    ],
    "id": 1
}'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x864e39e8bd21bd983cd78231b5d14bb43a7f43d45bfa6111439956ce4be8bb5d",
        "blockNumber": 43,
        "hash": "0x6b106dc5619c86b6c0cb64b17e5c464e8008e08cf0f1bb0e3fa2657fb42daade",
        "from": "one1uyshu2jgv8w465yc8kkny36thlt2wvel89tcmg",
        "to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
        "shardID": 1,
        "toShardID": 0,
        "value": 100000000000000000
    }
}

hmy_pendingTransactions

API v1

Returns list of pending transactions object. See hmy_getTransactionByHash for result format.

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmy_pendingTransactions",
    "params": [],
    "id": 1
}'

API v2

Returns list of pending transactions object. See hmy_getTransactionByHash for result format.

Sample Curl Request

curl --location --request POST 'https://api.s0.b.hmny.io/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "hmyv2_pendingTransactions",
    "params": [],
    "id": 1
}'

hmy_sendRawStakingTransaction

SendRawStakingTransaction

Overview

A staking transaction is like a plain sharded transaction, hmy_sendRawTransaction, but with a single field that is not known ahead of time. This field is the staking message itself, which in the harmony go code base, we refer to as StakeMsg

Input

The input is a single RLP encoded version of a StakingTransaction

Parameters

String - Transaction encoded in bytes.

Returns

String - Raw transaction's hash.

Sample Curl Request

curl --location --header 'Content-Type: application/json' --request POST 'https://api.s0.b.hmny.io/' -d '{
    "jsonrpc":"2.0",
    "method":"hmy_sendRawStakingTransaction",
    "params":[
      "0xf869808082520880809410a02a0a6e95a676ae23e2db04bea3d1b8b7ca2e880de0b6b3a7640000801ba0c8d0c5390086999b5b5a93373953c3c94b44dc8fd06d88a421a7c2461e9e4482a0730d7859d1e3109d499bcd75f00700729b9bc17b03940da4f84b6ea784f51eb1"
    ],
    "id":1
}'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1156a044c73f85d876780f3bd86d7b0665c2d1b6c8a1abaaaedc08c13968a598"
}

hmy_getTransactionsHistory

Description

hmy_getTransactionsHistory get transactions history for an address

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
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

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
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

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
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

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
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response 1

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "transactions": [
            "0x230798fe22abff459b004675bf827a4089326a296fa4165d0c2ad27688e03e0c"
        ]
    }
}

hmy_sendRawTransaction

SendRawTransaction

Send a raw transaction encoded in bytes.

Parameters

String - Transaction encoded in bytes.

Returns

String - Raw transaction's hash.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_sendRawTransaction",
    "params":[
      "0xf869808082520880809410a02a0a6e95a676ae23e2db04bea3d1b8b7ca2e880de0b6b3a7640000801ba0c8d0c5390086999b5b5a93373953c3c94b44dc8fd06d88a421a7c2461e9e4482a0730d7859d1e3109d499bcd75f00700729b9bc17b03940da4f84b6ea784f51eb1"
    ],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1156a044c73f85d876780f3bd86d7b0665c2d1b6c8a1abaaaedc08c13968a598"
}

hmy_getTransactionReceipt

GetTransactionReceipt

Get transaction receipt from transaction hash.

API v1

Parameters

String - The transaction hash.

Returns

blockHash 32 Bytes - String: Hash of the block where this transaction was in.
blockNumber - Number: Block number where this transaction was in.
transactionHash 32 Bytes - String: Hash of the transaction.
transactionIndex- Number: Integer of the transactions index position in the block.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
contractAddress - String: The contract address created, if the transaction was a contract creation, otherwise null.
cumulativeGasUsed - Number: The total amount of gas used when this transaction was executed in the block.
gasUsed- Number: The amount of gas used by this specific transaction alone.
logs - Array: Array of log objects, which this transaction generated.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getTransactionReceipt",
    "params":[
    "0x2fa714e40389cbbceda0f77e707035c0ec8aa940e8e10c0d445813177ea71e7d"],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x6f45cf41eb252b8fc8482082992b516cbb42aa6f39002070e87d287f6007a29c",
    "blockNumber": "0x112e",
    "contractAddress": null,
    "cumulativeGasUsed": "0x5208",
    "from": "0x13e88a505dd804971410ac5538c504c376464227",
    "gasUsed": "0x5208",
    "logs": [],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "root": "0xf28ed9c84cc99e92ff61aa5c6076f697fcc4b288cd86c30048e1387f4e7928fa",
    "shardID": 0,
    "to": "0xe1217e2a4861dd5d50983dad32474bbfd6a7333f",
    "transactionHash": "0x2fa714e40389cbbceda0f77e707035c0ec8aa940e8e10c0d445813177ea71e7d",
    "transactionIndex": "0x0"
  }
}

API v2

Parameters

String - The transaction hash.

Returns

blockHash 32 Bytes - String: Hash of the block where this transaction was in.
blockNumber - Number: Block number where this transaction was in.
transactionHash 32 Bytes - String: Hash of the transaction.
transactionIndex- Number: Integer of the transactions index position in the block.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
contractAddress - String: The contract address created, if the transaction was a contract creation, otherwise null.
cumulativeGasUsed - Number: The total amount of gas used when this transaction was executed in the block.
gasUsed- Number: The amount of gas used by this specific transaction alone.
logs - Array: Array of log objects, which this transaction generated.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getTransactionReceipt",
    "params":[
    "0x2fa714e40389cbbceda0f77e707035c0ec8aa940e8e10c0d445813177ea71e7d"],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x86a26a6a2ed82c5bdfcbdde757243b35687363723c7d683f54b11c4f747a284b",
        "blockNumber": 17,
        "contractAddress": null,
        "cumulativeGasUsed": 21000,
        "from": "one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
        "gasUsed": 21000,
        "logs": [],
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "shardID": 0,
        "status": 1,
        "to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
        "transactionHash": "0xaab323cdbcba2c9c1be0c7b910bd6efdfbeba03323fad5c3794f1a527ec55ef0",
        "transactionIndex": 0
    }
}

hmy_getBlockTransactionCountByHash

GetBlockTransactionCount

Get the number of transactions in a block by the block's hash.

API v1

Parameters

String - The block hash.

Returns

Number - The number of transactions in the given block.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getBlockTransactionCountByHash",
    "params":["0x660fe701f580ffebfcfb4af1836c9929c1fd0014d8d79d60749fecf52df7a90d"],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

API v2

Parameters

String - The block hash.

Returns

Number - The number of transactions in the given block.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getBlockTransactionCountByHash",
    "params":["0x660fe701f580ffebfcfb4af1836c9929c1fd0014d8d79d60749fecf52df7a90d"],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": 1
}

hmy_getBlockTransactionCountByNumber

GetBlockTransactionCount

Get the number of transactions in a block by the block's index in the chain.

API v1

Parameters

Number - The block number.

Returns

Number - The number of transactions in the given block.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getBlockTransactionCountByNumber",
    "params":["0x66"],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0"
}

API v2

Parameters

Number - The block number.

Returns

Number - The number of transactions in the given block.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getBlockTransactionCountByNumber",
    "params":[1],
    "id":1
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": 1
}

hmy_getTransactionByHash

GetTransaction

Get a transaction by its hash.

API v1

Parameters

String - The transaction hash.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmy_getTransactionByHash",
    "params":[
      "0x1dff358dad4d0fc95b11acc9826b190d8b7971ac26b3f7ebdee83c10cafaf86f"
    ],
    "id":1
}' -H 'Content-Type:application/json' -X POST 'https://api.s0.b.hmny.io'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x428ead93e632d5255ea3d1fb61b02ab8493cf562a398af2159c33ecd53c62c16",
        "blockNumber": "0x4",
        "from": "0x0b585f8daefbc68a311fbd4cb20d9174ad174016",
        "gas": "0x5208",
        "gasPrice": "0x0",
        "hash": "0xa7bb2c7cbfe4f5d6cf061aacd9d0dce7660d1f82da63dd7c76d9e856c1dc0278",
        "input": "0x",
        "nonce": "0x0",
        "to": "0x3aea49553ce2e478f1c0c5acc304a84f5f4d1f98",
        "transactionIndex": "0x0",
        "value": "0xde0b6b3a7640000",
        "v": "0x1b",
        "r": "0x3cb6eedb11cad81f1ab52d72f46dcea0b3d7f46beaf40e83660b165546db5fc6",
        "s": "0x1bc4b99089ab7d3ec17eae9d8a366feac87f9a76dd3ae031abfb86359b020551"
    }
}

API v2

Parameters

String- The transaction hash.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

curl -d '{
    "jsonrpc":"2.0",
    "method":"hmyv2_getTransactionByHash",
    "params":[
       "0x1dff358dad4d0fc95b11acc9826b190d8b7971ac26b3f7ebdee83c10cafaf86f"
    ],
    "id":1
}' -H 'Content-Type:application/json' -X POST 'https://api.s0.b.hmny.io'

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0x542ed61c1ed9e33592ef1b71324eab0b4535b5e66616cae60dc1ac5619a9c9d3",
        "blockNumber": 37,
        "from": "one1spshr72utf6rwxseaz339j09ed8p6f8ke370zj",
        "timestamp": 1580418556,
        "gas": 21000,
        "gasPrice": 1000000000,
        "hash": "0x4e58aff60b072d22d8fb023a20ee3f3ee543c406e4f44f0254ef9d9b0867b525",
        "input": "0x",
        "nonce": 8,
        "to": "one1r4zyyjqrulf935a479sgqlpa78kz7zlcg2jfen",
        "transactionIndex": 0,
        "value": 100000000000000000,
        "shardID": 0,
        "toShardID": 1,
        "v": "0x27",
        "r": "0xe207da6fa94432773f499a2f38b816b77f5034d4ec6d83684cd581739e8b528a",
        "s": "0xdfbe11c602c7956915ff1f01e240f0c65fd122fb798debaf040b551ed1bf6a6"
    }
}

hmy_getTransactionByBlockNumberAndIndex

GetTransaction

Get transaction at an index from a given block, specified by number.

API v1

Parameters

String - The block's index in the chain.
String - The transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

Sample Curl Response

API v2

Parameters

Number- The block's index in the chain.
Number - The transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

Sample Curl Response

hmy_getTransactionByBlockHashAndIndex

GetTransactionByBlockHashAndIndex

Get transaction at an index from a given block, specified by block hash.

API v1

Parameters

String - The block hash.
Number - The transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

Sample Curl Response

API v2

Parameters

String - The block hash.
Number - The transactions index position.

Returns

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 its pending.
blockNumber - Number: Block number where this transaction was in. null when its pending.
transactionIndex - Number: Integer of the transactions index position in the block. null when its pending.
from - String: Address of the sender.
to - String: Address of the receiver. null when its a contract creation transaction.
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.

Sample Curl Request

Sample Curl Response

hmy_getBlockByNumber

GetBlockByNumber

Get block by its index in the blockchain.

API v1

Parameters

String - The block number.
Boolean - If true, the returned block will contain all transactions in the block.

Returns

number - Number: The block number. null when its pending block.
hash 32 Bytes - String: Hash of the block. null when its pending block.
parentHash 32 Bytes - String: Hash of the parent block.
nonce 8 Bytes - String: Hash of the generated proof-of-work. null when its pending block.
logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
stateRoot 32 Bytes - String: The root of the final state trie of the block.
miner - String: The address of the beneficiary to whom the mining rewards were given.
difficulty - String: Integer of the difficulty for this block.
extraData - String: The “extra data” field of this block.
size - Number: Integer the size of this block in bytes.
gasLimit - Number: The maximum gas allowed in this block.
gasUsed - Number: The total used gas by all transactions in this block.
timestamp - Number: The unix timestamp for when the block was collated.
stakingTransactions - Array: Array of staking transactions object; are present by default
transactions - Array: Array of transaction objects; absent if second parameter is false.
uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response

API v2

Parameters

Number - The block number.
blockArgs - optional args struct in json format (should be used just with { })
1. fullTx - Bool: To show full tx or not
2. withSigners- Bool: Include block signes in blocks or not
3. inclStaking - Bool: To show staking txs or not

Returns

number - Number: The block number. null when its pending block.
hash 32 Bytes - String: Hash of the block. null when its pending block.
parentHash 32 Bytes - String: Hash of the parent block.
nonce 8 Bytes - String: Hash of the generated proof-of-work. null when its pending block.
logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
stateRoot 32 Bytes - String: The root of the final state trie of the block.
miner - String: The address of the beneficiary to whom the mining rewards were given.
difficulty - String: Integer of the difficulty for this block.
extraData - String: The “extra data” field of this block.
size - Number: Integer the size of this block in bytes.
gasLimit - Number: The maximum gas allowed in this block.
gasUsed - Number: The total used gas by all transactions in this block.
timestamp - Number: The unix timestamp for when the block was collated.
stakingTransactions - Array: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions - Array: Array of transaction objects; absent if second parameter is false.
uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response

hmy_getBlockByHash

GetBlockByHash

Get block by its hash.

API v1

Parameters

String - The block hash.
Boolean - If true, the returned block will contain all transactions in the block.

Returns

number - Number: The block number. null when its pending block.
hash 32 Bytes - String: Hash of the block. null when its pending block.
parentHash 32 Bytes - String: Hash of the parent block.
nonce 8 Bytes - String: Hash of the generated proof-of-work. null when its pending block.
logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
stateRoot 32 Bytes - String: The root of the final state trie of the block.
miner - String: The address of the beneficiary to whom the mining rewards were given.
difficulty - String: Integer of the difficulty for this block.
extraData - String: The “extra data” field of this block.
size - Number: Integer the size of this block in bytes.
gasLimit - Number: The maximum gas allowed in this block.
gasUsed - Number: The total used gas by all transactions in this block.
timestamp - Number: The unix timestamp for when the block was collated.
stakingTransactions - Array: Array of staking transactions object; are present by default
transactions - Array: Array of transaction objects; absent if second parameter is false.
uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response

API v2

Parameters

String - The block hash.
blockArgs - optional args struct in json format (should be used just with { })
1. fullTx - Bool: To show full tx or not
2. withSigners- Bool: Include block signes in blocks or not
3. inclStaking - Bool: To show staking txs or not

Returns

number - Number: The block number. null when its pending block.
hash 32 Bytes - String: Hash of the block. null when its pending block.
parentHash 32 Bytes - String: Hash of the parent block.
nonce 8 Bytes - String: Hash of the generated proof-of-work. null when its pending block.
logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
stateRoot 32 Bytes - String: The root of the final state trie of the block.
miner - String: The address of the beneficiary to whom the mining rewards were given.
difficulty - String: Integer of the difficulty for this block.
extraData - String: The “extra data” field of this block.
size - Number: Integer the size of this block in bytes.
gasLimit - Number: The maximum gas allowed in this block.
gasUsed - Number: The total used gas by all transactions in this block.
timestamp - Number: The unix timestamp for when the block was collated.
stakingTransactions - Array: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions - Array: Array of transaction objects; absent if second parameter is false.
uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response

hmy_getBlocks

Description

hmy_getBlocks returns blocks in range [from; to]

API v1

Parameters

String - starting block number in 0x format
String - ending block number in 0x format
blockArgs - optional args struct in json format (should be used just with { })
1. fullTx - Bool: To show full tx or not
2. withSigners- Bool: Include block signes in blocks or not

Returns

Array : returns blocks list in json format
- number - Number: The block number. null when its pending block.
- hash 32 Bytes - String: Hash of the block. null when its pending block.
- parentHash 32 Bytes - String: Hash of the parent block.
- nonce 8 Bytes - String: Hash of the generated proof-of-work.null when its pending block.
- logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
- transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
- stateRoot 32 Bytes - String: The root of the final state trie of the block.
- miner - String: The address of the beneficiary to whom the mining rewards were given.
- difficulty - Number: Integer of the difficulty for this block.
- extraData - String: The “extra data” field of this block.
- size - Number: Integer the size of this block in bytes.
- gasLimit - Number: The maximum gas allowed in this block.
- gasUsed - Number: The total used gas by all transactions in this block.
- timestamp - Number: The unix timestamp for when the block was collated, 0x format.
- stakingTransactions - Array: Array of staking transactions object; absent if inclStaking is false, are present by default.
- transactions - Array: Array of transaction objects; absent if second parameter is false.
- signers - Array: Array of validators one addresses who signed this block
- uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response

API v2

Parameters

Number - starting block number
Number - ending block number
blockArgs - optional args struct in json format (should be used just with { })
1. fullTx - Bool: To show full tx or not
2. withSigners- Bool: Include block signes in blocks or not
3. inclStaking - Bool: To show staking txs or not

Returns

Array : returns blocks list in json format
- number - Number: The block number. null when its pending block.
- hash 32 Bytes - String: Hash of the block. null when its pending block.
- parentHash 32 Bytes - String: Hash of the parent block.
- nonce 8 Bytes - String: Hash of the generated proof-of-work. null when its pending block.
- logsBloom 256 Bytes - String: The bloom filter for the logs of the block. null when its pending block.
- transactionsRoot 32 Bytes - String: The root of the transaction trie of the block
- stateRoot 32 Bytes - String: The root of the final state trie of the block.
- miner - String: The address of the beneficiary to whom the mining rewards were given.
- difficulty - String: Integer of the difficulty for this block.
- extraData - String: The “extra data” field of this block.
- size - Number: Integer the size of this block in bytes.
- gasLimit - Number: The maximum gas allowed in this block.
- gasUsed - Number: The total used gas by all transactions in this block.
- timestamp - Number: The unix timestamp for when the block was collated.
- stakingTransactions - Array: Array of staking transactions object; absent if inclStaking is false, are present by default
- transactions - Array: Array of transaction objects; only hashes if fullTx is false, are hashes by default
- signers - Array: Array of validators one addresses who signed this block
- uncles - Array: Array of uncle hashes.

Sample Curl Request

Sample Curl Response