Blockchain Feeds
A secure way to get balances (network or non-network tokens) and list of transactions by blockchain.
Get Account Balance: GET
/api/v1/account-balanceParameters:
Name | Type | Description | Text |
|---|---|---|---|
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 goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://blockchain-feeds.goracle.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 |
Get Token Transfers: GET
/api/v1/token-transfersParameters:
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 goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://blockchain-feeds.goracle.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 |
Get Blockchain Transaction: GET
/api/v1/transactionParameters:
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 goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://blockchain-feeds.goracle.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. |
Last modified 2mo ago