Blockchain Feeds

A secure way to get balances (network or non-network tokens) and list of transactions by blockchain.

API Call

Base Url: https://blockchain-feeds.gora.io

Get Account Balance: GET /api/v1/account-balance

Parameters:

Name	Type	Description
blockchain	string	(required) The blockchain to get address balance for.	ethereum-mainnet
address	string	(required) Blockchain address to get account balance for.	0x06012c8cf97bead5deae237070f9587f8e7a266d
key	string	(required) Key provided by GoraNetwork. When using node runner set the key as ##signKey	##signKey

Example Call

https://blockchain-feeds.gora.io/api/v1/account-balance?blockchain=ethereum-mainnet&address=0x06012c8cf97bead5deae237070f9587f8e7a266d&key=##signKey

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched account balance data",
    "query": {
        "blockchain": "ethereum-mainnet",
        "address": "0x06012c8cf97bead5deae237070f9587f8e7a266d"
    },
    "provider": {
        "name": "amberdata"
    },
    "data": {
        "address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
        "blockNumber": "17564277",
        "timestamp": "2023-06-26T14:45:23.000Z",
        "balance": "2424019892694032603"
    },
    "time": "Mon, 26 Jun 2023 15:30:07 GMT",
    "timestamp": 1687793407553
}

Results Schema

Name	Type	Description
address	string	The blockchain to get address balance for.
blockNumber	string	The blockchain block number
timestamp	string	The blockchain address balance result timestamp
balance	string	The blockchain address balance amount

Base Url: https://blockchain-feeds.gora.io

Get Token Transfers: GET /api/v1/token-transfers

Parameters:

Name	Type	Description	Example
blockchain	string	(required) The blockchain to get address balance for.	ethereum-mainnet
hash	string	(required) Filter by token transfers for this transaction.	0x31c27c9b37e17056e67bb0948abf9b1676c91d38e40131a286c28a6c6ddaf90a
key	string	(required) Key provided by GoraNetwork. When using node runner set the key as ##signKey	##signKey

Example Call

https://blockchain-feeds.gora.io/api/v1/token-transfers?blockchain=ethereum-mainnet&hash=0x31c27c9b37e17056e67bb0948abf9b1676c91d38e40131a286c28a6c6ddaf90a&key=##signKey

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched token transfers",
    "query": {
        "blockchain": "ethereum-mainnet",
        "hash": "0x31c27c9b37e17056e67bb0948abf9b1676c91d38e40131a286c28a6c6ddaf90a"
    },
    "provider": {
        "name": "amberdata"
    },
    "data": {
        "amount": "2162000000000000000000",
        "from": "0x8424a963a31b51c33627e52e7e19bbc86c7dcb79",
        "logIndex": 39,
        "to": "0xc12edafbf7bdce4e8897b1c8877398a946db96b2",
        "tokenAddress": "0x514910771af9ca656af840dff83e8264ecf986ca",
        "decimals": "18",
        "name": "ChainLink Token",
        "symbol": "LINK",
        "isERC20": true,
        "isERC721": false,
        "isERC777": false,
        "isERC884": false,
        "isERC998": false,
        "isERC1155": false
    },
    "time": "Mon, 26 Jun 2023 15:42:01 GMT",
    "timestamp": 1687794121417
}

Response Schema

Name	Type	Description
amount	string	The amount transferred in the smallest unit of the blockchain. For instance, wei with Ethereum. Important note: If the token type is ERC721, the amount value represents the token id
from	string	The address hash of the sender.
logIndex	string	The index of the log in the transaction.
to	string	The address hash of the recipient.
tokenAddress	string	The address of the token contract.
decimals	string	The number of significant digits, per smart contract definition.
name	string	The token name.
symbol	string	The token symbol.
isERCX	string	true if the token is ERCX false otherwise. Ex. "isERCX": true
isERC20	string	true if the token is ERC20 false otherwise. Ex. "isERC20": true
isERC721	string	true if the token is ERC721 false otherwise. Ex. "isERC721": true
isERC777	string	true if the token is ERC777 false otherwise. Ex. "isERC777": true
isERC884	string	true if the token is ERC884 false otherwise. isERC884": true
isERC998	string	true if the token is ERC998 false otherwise. isERC998": true
isERC1155	string	true if the token is ERC1155 false otherwise. isERC1155": true

Base Url: https://blockchain-feeds.gora.io

Get Blockchain Transaction: GET /api/v1/transaction

Parameters:

Name	Type	Description	Example
blockchain	string	(required) The blockchain to get address balance for.	ethereum-mainnet
hash	string	(required) Filter by token transfers for this transaction.	0x133f293b44b2eb632a26e8f7c972ad0f6152ca5c78377102e6804c46ebde6c83
key	string	(required) Key provided by GoraNetwork. When using node runner set the key as ##signKey	##signKey

Example Call

https://blockchain-feeds.gora.io/api/v1/transaction?blockchain=ethereum-mainnet&hash=0x133f293b44b2eb632a26e8f7c972ad0f6152ca5c78377102e6804c46ebde6c83&key=##signKey

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched transaction",
    "query": {
        "blockchain": "ethereum-mainnet",
        "hash": "0x133f293b44b2eb632a26e8f7c972ad0f6152ca5c78377102e6804c46ebde6c83"
    },
    "provider": {
        "name": "amberdata"
    },
    "data": {
        "blockNumber": "9061064",
        "blockHash": "0x90f957bdff1b3c90283fc58e0fbadf2a356ed5ca0c8afb07c08498cd23dfc26a",
        "confirmations": "8504497",
        "contractAddress": "null",
        "cumulativeGasUsed": "2141011",
        "fee": "452840000000000",
        "from": [
            {
                "address": "0x4437271b1bba8b5bee0c72a31e80fadd78122f4c"
            }
        ],
        "gasLimit": "75284",
        "gasPrice": "20000000000",
        "gasUsed": "22642",
        "hash": "0x133f293b44b2eb632a26e8f7c972ad0f6152ca5c78377102e6804c46ebde6c83",
        "index": 55,
        "input": "0xa9059cbb0000000000000000000000003f5ce5fbfe3e9af3971dd833d26ba9b5c936f0be0000000000000000000000000000000000000000000000024966f5b0e9ecf800",
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000005000000410000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000002000000000000000000000000000000000200000000020000000000000100000000000",
        "maxFeePerGas": null,
        "maxPriorityFeePerGas": null,
        "nonce": "7",
        "publicKey": "",
        "r": "0x8c696e3e1df97a0f713b6075e973b399ea509b3344ecd1abf8676fe46aa225ef",
        "raw": "",
        "root": "",
        "s": "0x76e4be3061794162df9b91662d32597448995b8293a7ca0a2b8390274bfa0c0e",
        "status": "0x1",
        "timestamp": "2019-12-06T15:00:47.000Z",
        "to": [
            {
                "address": "0xb8c77482e45f1f44de1745f52c74426c631bdd52",
                "nameNormalized": "Binance Coin"
            }
        ],
        "type": null,
        "v": "38",
        "value": "0",
        "statusResult": {
            "code": "0x1",
            "confirmed": true,
            "success": true,
            "name": "successful"
        }
    },
    "time": "Mon, 26 Jun 2023 19:06:47 GMT",
    "timestamp": 1687806407049
}

Response Schema

Name	Type	Description
blockNumber	string	The number of the block containing this token transfer.
blockHash	string	The header hash of the block containing this token transfer.
confirmations	string	The total number of confirmations.
contractAddress	string	The token contract address
cumulativeGasUsed	string	The total gas used up to and including the transaction.
fee	string	The transaction fee.
from	Object	Contains the details about the sending address. i.e. the address of the account.
gasLimit	string	The gas limit of the transaction.
gasPrice	string	The gas price at the time of the transaction.
gasUsed	string	Total gas used by the transaction.
hash	string	The transaction hash.
index	number	The index of the transaction within the block.
input	string	The input data to the function.
logsBloom	string	The Bloom filter composed from indexable information (logger address and log topics) contained in each log entry from the receipt of each transaction in the transactions list.
maxFeePerGas	number	Maximum amount that can be paid to validate and include this transaction in the blockchain.
maxPriorityFeePerGas	number	Fees which go to the miner, also known as tips or inclusion fees.
nonce	string	The nonce of the transaction.
publicKey	string	The public key hash.
r	string	ECDSA digital signature r (32 bytes) generated by private key and used to validate the sender of the transaction.
raw	string	The signed transaction in Recursive Length Prefix (RLP) encoded form.
root	string	The transaction root hash.
s	string	ECDSA digital signature s (32 bytes) generated by private key and used to validate the sender of the transaction.
status	string	The status of the transaction. 0x1 - success 0x0 - failed
timestamp	string	The time of when the transaction was confirmed.
to	Object	Contains object that hold data about the recipient address(es).
type	string	The transaction type: 0 - legacy 2 - EIP 1559
v	string	Used by ECDSA to recover correct public key when validating signature of transactions. Combination of recovery id and chain id.
value	string	The scalar value equal to the number of units (in Ethereum Wei) to be transferred to the message call’s recipient or, in the case of contract creation, as an endowment to the newly created contract. See full value conversion reference here.
statusResult	Object	Contains details about the transaction status.