Download OpenAPI specification:Download
Blockchains store data in ways most apps find difficult to access. Alethio's API gives you a robust and reliable way to query synthesized, indexed Ethereum data in real-time via a JSON:API compliant REST interface.
We designed the endpoints around the frequent needs and pain points of building an Ethereum-powered project. We give you access to the data you need, exactly how you need it - through a comprehensive, general-purpose data model based on EthOn with meaningful aggregation and filtering capabilities exposed via query parameters.
Here are only a few examples that illustrate the power of the API - these use cases are typically not supported by the standard Ethereum json-rpc
interface:
Retrieve the transaction history of any Ethereum account
Retrieve a complete list of incoming and outgoing Ether transfers for any account - including transfers sent by smart contracts
Retrieve the token transfer history for any account
Retrieve a full map of contract messages (internal transactions) for any account and smart contract
Efficiently filter through the entire history of event logs emmitted by any smart contract
The API is currently live on the following networks:
Network | Base URL |
---|---|
Ethereum Mainnet | https://api.aleth.io/v1 |
The API can be tested without authentication on low volumes. Unauthenticated access is throttled at ~60 req/min
per IP address with a HTTP 429
response code.
For higher throughput and volumes, please register an account with Alethio's Developer Portal and use the provided API Key in one of the following supported authentication mechanisms:
Authorization: Bearer API_KEY
header$ curl https://api.aleth.io/v1/blocks/latest \
-H "Authorization: Bearer sk_main_0123456789abcdef"
$ curl https://api.aleth.io/v1/blocks/latest \
-u sk_main_0123456789abcdef:
# The colon prevents curl from asking for a password
All API responses are serialized as JSON objects and follow the conventions of the JSON:API specificaton:
If the response object has a data
property, the request was successful and the value of the data
property can be either a single object (representing a Resource) or an array of objects (representing a Collection).
Otherwise, the response object will have a single errors
property, whose value is an array of Error objects.
meta
objectAll succesful responses include a meta
property along with the data
property in the response object. The meta
object includes helper information that can vary depending on the type of request and will be described along with the relevant functionality (e.g. the sections on Pagination and Reorg Handling).
For all API responses, however, the meta
object includes a few details about the latest block of the canonical chain, as it is seen by the API at the time of the request. This can serve as an anchor for queries that ask for the most recent items of a collection (e.g. latest transactions for an account), as it defines what 'most recent' means to the API at the time of the request:
{
"meta": {
"latestBlock": {
"number": 4242424,
"blockCreationTime": 1504648858,
"blockHash": "0x30b65c7412e887eb888abadb230171e7dc09da7bbe0f2a475c0feeed6950dc3b"
}
}
}
The API is organized around the concepts of Resources and Collections.
A Resource typically represents a single blockchain-related concept (e.g. Block
, Transaction
, Account
, etc.) whereas a Collection is a group (array) of resources sharing the same type.
Each resource is uniquely dentified by its type
and id
. We will refer to this as the resource identifier data.
Let's take Ethereum's genesis block as an example:
curl "https://api.aleth.io/v1/blocks/genesis"
You will find the identifier data as part of the resource payload:
{
"type": "Block",
"id": "0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3"
// ...
}
Along with the identifier data, all resources have two other types of properties:
attributes are static values specific to the resource
relationships are pointers to other (related) resources or collections
For example, the genesis block has:
{
"attributes": {
"number": 0,
"blockCreationTime": 1438226773
// ... other attibutes
},
"relationships": {
"hasBeneficiary": {
// pointer to the miner's Account
},
"transactions": {
// pointer to the collection of Transactions
}
}
}
All the blockchain resources are part a large graph of interconnected concepts. The API is translating these connections into resource relationships. There are two types of relationships:
A to-one relationship is a link to a single other resource (e.g. there's a single from
Account for any Transaction).
A to-many relationship is a link to a collection of resources sharing the same type (e.g. there is a collection of Transactions for any given Block).
Both the to-one and to-many relationships are represented by a fully-formed URL called the related link. According to the JSON:API specificaton this will be serialized as:
{
"transactions": {
"links": {
"related": "https://api.aleth.io/v1/blocks/genesis/transactions"
}
}
}
Additionally, only the to-one relationships will include in the response, along with the link, the identifier data of the related resource:
{
"hasBeneficiary": {
"data": {
"type": "Account",
"id": "0x0000000000000000000000000000000000000000"
},
"links": {
"related": "https://api.aleth.io/v1/blocks/genesis/hasBeneficiary"
}
}
}
Note: In practice, the related links will be normalized to include the canonical identifier of the origin. Instead of
/blocks/genesis/...
(we used this in the examples above for brevity) the related links will read/blocks/0xd4e56740.../...
.
Sometimes it's helpful to fetch a bundle of related resources with a single API request. The API enables you to do this via the include
URL parameter.
You can choose to include any subset of to-one relationships by providing a comma-separated list of the relationship names in the request.
Let's explore the first Ethereum transaction, along with the details of its from
and to
Accounts:
curl "https://api.aleth.io/v1/transactions/0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060?include=from,to"
Note the trailing include=from,to
argument in the URL. This asks the API to append the related resources to the response, grouped under the included
key:
{
"data": {
"type": "Transaction",
"id": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"relationships": {
"from": {
"data": {"type": "Account", "id": "0xa1e4380a3b1f749673e270229993ee55f35663b4"}
// "links" not relevant for this example
},
"to": {
"data": {"type": "Account", "id": "0x5df9b87991262f6ba471f09758cde1c0fc1de734"}
// "links" not relevant for this example
}
}
// ... other Transaction details
},
"included": [
{
"type": "Account",
"id": "0xa1e4380a3b1f749673e270229993ee55f35663b4",
// ... other Account details
},
{
"type": "Account",
"id": "0x5df9b87991262f6ba471f09758cde1c0fc1de734",
// ... other Account details
}
]
}
An included resource will be appended to the included
array one time, even if it's referenced by more than one relationship (e.g. if the from
and the to
Accounts would have been identical in the example above, that Account wouldn't be included twice in the array).
Note: Only the to-one relationships can be multiplexed in a single request. All to-many relationships need to be queried explicitly in separate requests. We chose this approach so we could simplify the API query logic for collection pagination and filtering.
The default sorting order for all resources that directly relate to activity on a timeline (e.g. Blocks, Transactions, ContractMessages, LogEntries) is reverse chronological (most recent entries are first on the list). We chose this approach as most often than not, users are interested primarily in events or transactions that happened recently, rather than the ones that happened a long time ago.
The globalRank
attribute, where present, serves as an aid to this ordering criteria, as it aggregates a hierarchy of indexes into a single composite value:
The block number
The index of a message (transaction or contract message) in the context of a block
The index of an event in the context of a transaction
This value allows you to sort heterogeneous collections of items chronologically, according to the relative order in which they were executed.
Filters can assist you in refining your queries and distilling the data sets down to resources that have certain properties (attributes or relationships).
As a general rule, the filters are applied through the filter[NAME]
URL argument. Multiple filters can be chained within a single request, as long as they're targeting different properties.
Example: Let's query the list of transactions between two specific accounts:
curl "https://api.aleth.io/v1/transactions?filter[from]=0x5A0b54D5dc17e0AadC383d2db43B0a0D3E029c4c&filter[to]=0x962f7a7146ca5527fb9bf92491da675f3d2de0d8"
Note: All collections of the same resource type have support for the same filtering parameters.
You will find a full list of supported filters for each collection type in the endpoint reference below. Please note that all filters are only listed once for each collection type, although they can be applied on related collections as well.
Examples:
filter[token]
is documented for the root collection /token-transfers
, but can be applied to an Account's token transfers as well, for retrieving the list of TokenTransfers related to that Account, in a given Token:
curl "https://api.aleth.io/v1/accounts/0xd6f480e6e7d75346e254db5d99efa2561d3f3288/tokenTransfers?filter[token]=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
Here's how you can apply the LogEntry topic filter filter[hasLogTopics.0]
to retrieve all ERC20 Approve
events triggered a given block:
curl "https://api.aleth.io/v1/blocks/8048150/logEntries?filter[hasLogTopics.0]=0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
All resource collections that are exported by the API share a uniform pagination strategy.
The maximum number of items on a page is controlled by the page[limit]
URL argument. The default value is 10
and the maximum allowed value is 100
.
The beginning or end of the requested page is controlled by a cursor
value assigned to either the page[next]
or page[prev]
URL arguments. Each resource has an immutable cursor
attribute that can be used for this purpose.
Note: All the resources that are subject to pagination have a reverse chronological default ordering. This can make the pagination language counter-intuitive, unless you think of the items as being part of an 'activity feed' (with the most recent activity shown on the top of the list). Thus, the first (default) page will always start with the most recent items and progress towards older items. The
next
page will display older items than the current page, whereas theprev
page will display more recent items.
The page[next]=cursor
argument requests the next page starting immediately after cursor
The page[prev]=cursor
argument requests the previous page ending immediately before cursor
The API automatically creates links for the next
and prev
pages relative to the set of items included in the active (current) page, and appends these links to the response under the links
property.
Let's look into the transactions of Block number 4242424
:
curl "https://api.aleth.io/v1/blocks/4242424/transactions?page[limit]=2"
{
"data": [
// List of 2 Transaction resources:
// - first with cursor 0x0040bbf800a60000100030b65c7412e8
// - second with cursor 0x0040bbf800a50000100030b65c7412e8
],
"links": {
"prev": "(...) transactions?page[limit]=2&page[prev]=0x0040bbf800a60000100030b65c7412e8",
"next": "(...) transactions?page[limit]=2&page[next]=0x0040bbf800a50000100030b65c7412e8"
}
}
Notice how links.prev
and links.next
were generated to include the cursors of the first and the last items in the current page.
Note: The values set for
page[limit]
(along with any otherfilter[]
applied to the current page) will be preserved in the pagination links for thenext
andprev
pages.
For all paginated collections, the meta
object assigned to the response will include a page
object that provides information about the items of the next
and prev
pages:
meta.page.hasNext
is a boolean value that indicates whether the next page (starting immediately after the cursor of the last item in the current page) has at least one item.
meta.page.hasPrev
is a boolean value that indicates whether the previous page (ending immediately before the cursor of the first item in the current page) has at least one item.
Our data pipeline keeps track of the blockchain growth in real-time, so you get access to the most recent activity as soon as it takes place. We don't require you to wait for an arbitrary number of confirmations until you get access to the data, so you can build applications that react as quickly as possible to the on-chain events, with minimal delays for your users.
This is a powerful feature that introduces a subtle layer of complexity due to how distributed consensus works: the miners are competing for producing new blocks and sometimes the latest section of the chain becomes a stale branch because a better branch was produced by other nodes. This is also known as a "chain reorg".
In the image above, the block segment P1-P2
(that was part of the canonical chain) becomes a stale branch because a better chain was created via M1-M2-M3
. After the reorg took place, any transaction that was included in P1
or P2
is no longer part of the main chain (hence no longer confirmed), unless it is mined again in one of the blocks that are now part of the main chain.
We designed the API to handle these situations with minimal overhead for you. The pagination cursors are reorg-safe, so you can surf through resource collections or poll for updates without worrying about data inconsistencies related to reorgs. If we detect that a subset of the items that we've given you have become stale (because the chain reorganized in between requests), we'll simply append a list of rollback
items to the next response, to notify you that the status of those items is no longer valid.
In other words, if the pagination cursor that you've just sent is pointing to an item that's no longer part of the main chain, the API will do the heavy lifting by shifting the cursor back into the main chain and returning a list of rollback
items whose status you might want to update.
Here is a step-by-step explanation of how our data pipeline handles a pagination cursor that's pointing to a reorged block (Pc
). This is purely informative and you don't need to understand it to successfully use the API, as most of this logic takes place in our backend.
The API will determine A
, the most recent common ancestor of Pc
and the current tip of the main chain
Create a meta.rollback
collection that includes all the relevant items on the stale branch (according to the active filters)
For page[next]
: create a data
collection that returns all the relevant items on the main chain (according to the active filters), whose block number is less than or equal to A
For page[prev]
: same as above, but the block number needs to be strictly greater than A
Let's take a more granular example:
Assume the active query asks for all transactions of a given account X
.
The transactions matching the active query are highlighted in the image as lines inside blocks. Note that some blocks might not have any transactions related to the account X
, so they are shown empty (no lines) in the image.
The cursor C
points to a transaction that’s outside the main chain (block Pc
).
The API will send a meta.rollback
collection that includes all the transactions of X
in the orange blocks.
Important: The
rollback
dataset won't include all transactions from all the orange blocks, but only the ones that match the active filters (in this example, only the transactions associated with the accountX
).
Note: The
rollback
dataset is not paginated, it will include all the relevant items in a single list of resource identifier objects (only thetype
andid
is provided for eachrollback
item).
For page[next]=C
, the API will send a data
collection that includes the next page[limit]
transactions matching the active filters, starting with (and including) block A
(note that some blocks might not have any transactions for account X
, in this example A
and M3
don’t have matching transactions).
The same applies for page[prev]
, but with blocks higher than (and not including) A
.
Here is an abstracted example for the query /accounts/X/transactions?page[limit]=3&page[next]=C
in the context of the diagram above:
{
"data": [
{
"type": "Transaction",
"id": "M5-tx1",
// ... more Transaction details
},
{
"type": "Transaction",
"id": "M4-tx1",
// ... more Transaction details
},
{
"type": "Transaction",
"id": "M2-tx1",
// ... more Transaction details
}
],
"meta": {
"rollback": [
// only the resource identifiers, no other details
{ "type": "Transaction", "id": "P6-tx1" },
{ "type": "Transaction", "id": "P6-tx2" },
{ "type": "Transaction", "id": "P4-tx1" },
{ "type": "Transaction", "id": "R1-tx1" },
{ "type": "Transaction", "id": "Pc-tx1" },
{ "type": "Transaction", "id": "Pc-tx2" },
{ "type": "Transaction", "id": "Pc-tx3" },
{ "type": "Transaction", "id": "P1-tx1" },
{ "type": "Transaction", "id": "P1-tx2" }
// always includes the full list, no pagination
]
}
}
Webhooks allow users to monitor any given query for updates and receive real-time notifications when new resources that satisfy the query criteria become part of the blockchain.
Let's take the example of monitoring inbound and outbound DAI transfers for the 0x0
account.
We can use the account
and token
filters on the token transfers endpoint
to retrieve a list of transfers, then periodically poll the links.prev
link to retrieve fresh updates (the prev
link
asks for the previous page, which consists of more recent items than the first item in the current list).
$ curl "https://api.aleth.io/v1/token-transfers?filter[account]=0x0000000000000000000000000000000000000000&filter[token]=0x6b175474e89094c44da98b954eedeac495271d0f"
{
"data": [
{
"type": "EtherTransfer",
"id": "0x008b40460130000041007687f464fcf6",
"attributes": {
"transferType": "TransactionTransfer",
"value": "0",
"fee": "261479290958400",
"total": "261479290958400",
"blockCreationTime": 1576678602,
...
}
},
...
],
"links": {
"next": "https://api.aleth.io/v1/ether-transfers/0x0000000000000000000000000000000000000000/etherTransfers?filter%5Baccount%5D=0x0000000000000000000000000000000000000000\u0026page%5Blimit%5D=1\u0026page%5Bnext%5D=0x008b40460130000041007687f464fcf6",
"prev": "https://api.aleth.io/v1/accounts/0x0000000000000000000000000000000000000000/etherTransfers?filter%5Baccount%5D=0x0000000000000000000000000000000000000000\u0026page%5Blimit%5D=1\u0026page%5Bprev%5D=0x008b40460130000041007687f464fcf6"
}
}
This approach is inconvenient, as it adds a certain delay (the polling interval) and creates many requests that will result in empty responses.
With the new Webhooks system, users can register a Webhook instance that monitors a given query and sends a HTTP POST request to a configurable target URL as soon as new resources that match the query have been included in the chain.
Each Webhook instance is associated with an underlying data query - expressed via the webhook's endpoint
,
filters
and confirmations
attributes. For the example above, the underlying query is
https://api.aleth.io/v1/token-transfers?filter[account]=0x0000000000000000000000000000000000000000&filter[token]=0x6b175474e89094c44da98b954eedeac495271d0f
and the corresponding webhook configuration is
{
"endpoint": "/token-transfers",
"filters": {
"account": "0x0000000000000000000000000000000000000000",
"token": "0x6b175474e89094c44da98b954eedeac495271d0f"
}
}
The webhook will monitor the result set of this query and synchronize the results with the target
(remote server) by keeping track of an internal cursor
and pushing paginated results in two
distinct stages:
The backfill stage: starting with the earliest (oldest) entry in the dataset, pages of
maximum 100
items will be POST
ed to the target URL.
The live stage: as soon as the entire history is synchronized, the webhook will hibernate
until one (or potentially more) new items are included in the dataset as a result of a new block
being appended to the chain. The webhook will then issue a POST
request to the remote URL and
send the new items in the body of the request.
The payload of each HTTP POST issued to the target URL will include a list of resources
(under the data
property) and meta
information about the Webhook:
{
"data": [
{
"type": "EtherTransfer",
"id": "0x008b40460130000041007687f464fcf6",
"attributes": {...},
"relationships": {...}
},
...
],
"meta": {
"webhook": {
"type": "Webhook",
"id": "006cfb85008d000010008ca21f438ee5",
"links": {
"self": "https://api.aleth.io/v1/webhooks/006cfb85008d000010008ca21f438ee5"
}
}
}
}
API users can manage their own decicated Webhooks programatically using a separate set of endpoints detailed in the Webhooks section below.
The follwing section provides a comprehensive list of all the API endpoints and their associated responses.
The Resource data model borrows a lot from EthOn - the community-sourced Ethereum Ontology. You can use it as a secondary reference for the response schema.
Note: You can access a detailed view of each response (including descriptions of all the fields) by expanding the green pills underneath each endpoint (e.g. the expandable green area reading '200 Block').
A Block is the basic element of a 'blockchain'. It functions as an entry in a distributed ledger, recording a series of transactions together with a reference to the previous block. A block is chained to its preceeding block by a cryptographic hash of its contents as a means of reference. Blocks contain an identifier for the final state after all transactions contained in it are validated. There is a consensus mechanism that provides incentives for nodes adding new blocks to the chain ("miners" in the Proof of Work protocol used by the main Ethereum network) that comply with the rules of Ethereum by issuing newly generated tokens ('Ether') to an account specified by the block's author.
Returns the list of all Block resources that are currently part of the main (canonical) chain, in reverse chronological order (most recently mined first).
Block List
{- "data": [
- {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/blocks?page[limit]=10&page[prev]=0x30b65c7412e887eb888abadb230171e7dc09da7bbe0f2a475c0feeed6950dc3b",
- "next": "/blocks?page[limit]=10&page[next]=0x30b65c7412e887eb888abadb230171e7dc09da7bbe0f2a475c0feeed6950dc3b"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the Block resource identified by a given block hash. The block can either be part of the current main (canonical) chain or part of a stale (reorged) branch, if the branch was visible to Alethio's network nodes at the time of the reorg.
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Block resource for a given block number.
number required | integer Example: 4041179 The block number. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Block resource for a given label (genesis
or latest
).
label required | string Enum: "genesis" "latest" Example: latest The block label. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Block resource representing the parent of a given block.
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the list of Transaction resources included in a block, sorted in reverse chronological order (descending by their globalRank
attribute).
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of ContractMessage resources included in a block, sorted in reverse chronological order (descending by their globalRank
attribute).
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
ContractMessage List
{- "data": [
- {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}
], - "links": {
- "prev": "/contract-messages?page[limit]=10&page[prev]=0x006acfc000070000200117aa411843cb",
- "next": "/contract-messages?page[limit]=10&page[next]=0x006acfc000070000200117aa411843cb"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of LogEntry resources included in a block, sorted in reverse chronological order (descending by their globalRank
attribute).
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
LogEntry List
{- "data": [
- {
- "type": "LogEntry",
- "id": "log:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:0",
- "attributes": {
- "hasLogTopics": [
- "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "0x000000000000000000000000f30cb9e6f48cde5f3df13231d466fd85e2687e7c",
- "0x0000000000000000000000007ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
], - "logData": "0x00000000000000000000000000000000000000000000004fa27864e788d40000",
- "globalRank": [
- 7274862,
- 1,
- 0
], - "eventDecodedError": null,
- "eventDecoded": {
- "event": "Transfer(address indexed from, address indexed to, uint256 value)",
- "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "inputs": [
- {
- "name": "from",
- "type": "address",
- "indexed": true,
- "value": "0xf30cb9e6f48cde5f3df13231d466fd85e2687e7c"
}, - {
- "name": "to",
- "type": "address",
- "indexed": true,
- "value": "0x7ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
}, - {
- "name": "value",
- "type": "uint256",
- "value": "1469000000000000000000"
}
]
}, - "cursor": "0x006f016e0080000030012901007eea7c"
}, - "relationships": {
- "loggedBy": {
- "data": {
- "type": "Contract",
- "id": "0xc9c4d9ec2b44b241361707679d3db0876ac10ca6"
},
}, - "block": {
- "data": {
- "type": "Block",
- "id": "0x2901007eea7c9b0c16d3c2c0c1449825687f339b79c655830f8c8891f8cbe1f5"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef"
},
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:1"
},
}
},
}
], - "links": {
- "prev": "/log-entries?page[limit]=10&page[prev]=0x006f016e0080000030012901007eea7c",
- "next": "/log-entries?page[limit]=10&page[next]=0x006f016e0080000030012901007eea7c"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of EtherTransfer resources included in a block, sorted in reverse chronological order (descending by their globalRank
attribute).
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
EtherTransfer List
{- "data": [
- {
- "type": "EtherTransfer",
- "id": "0x0079c69c004e00004200f7f0b0a20179",
- "attributes": {
- "transferType": "ContractMessageTransfer",
- "value": "4287663873500000512",
- "fee": "0",
- "total": "4287663873500000512",
- "blockCreationTime": 1560839506,
- "globalRank": [
- 7980700,
- 78,
- 0
], - "cursor": "0x0079c69c004e00004200f7f0b0a20179"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x6668ee95f387b0da9bd3e69ec0dbf5f1503b8135"
}, - "links": {
}
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0xbf0c5d82748ed81b5794e59055725579911e3e4e"
}, - "links": {
}
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0x61936196d934a793fb6a2fce76eb294164ede1fad708c9fe37a4b66c88762da3"
}, - "links": {
}
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0x61936196d934a793fb6a2fce76eb294164ede1fad708c9fe37a4b66c88762da3:1"
}, - "links": {
}
}, - "feeRecipient": {
- "data": {
- "type": "Account",
- "id": "0x04668ec2f57cc15c381b461b9fedab5d451c8f7f"
}, - "links": {
}
}, - "block": {
- "data": {
- "type": "Block",
- "id": "0xf7f0b0a2017979125d2b4418cdf0b1f796d053d28d7ce4d354de5741c07a857e"
}, - "links": {
}
}
},
}
], - "links": {
- "prev": "/ether-transfers?page[limit]=10&page[prev]=0x0079c69c004e00004200f7f0b0a20179",
- "next": "/ether-transfers?page[limit]=10&page[next]=0x0079c69c004e00004200f7f0b0a20179"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of TokenTransfer resources included in a block, sorted in reverse chronological order (descending by their globalRank
attribute).
blockHash required | string <hex256> Example: 0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184 The block hash in hex format. |
TokenTransfer List
{- "data": [
- {
- "type": "TokenTransfer",
- "id": "0x0078afae00f600028101320161a91f42",
- "attributes": {
- "value": "494131516286999999790",
- "symbol": "DAI",
- "blockCreationTime": 1559873076,
- "globalRank": [
- 7909294,
- 246,
- 2
], - "decimals": 18,
- "cursor": "0x0078afae00f600028101320161a91f42",
- "transactionGasLimit": 500000,
- "transactionGasPrice": "9000000000",
- "transactionGasUsed": 287312
}, - "relationships": {
- "token": {
- "data": {
- "type": "Token",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "links": {
}
}, - "from": {
- "data": {
- "type": "Account",
- "id": "0x9ae49c0d7f8f9ef4b864e004fe86ac8294e20950"
}, - "links": {
}
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529"
}, - "links": {
}
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:40"
}, - "links": {
}
}, - "logEntry": {
- "data": {
- "type": "LogEntry",
- "id": "log:0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:2"
}, - "links": {
}
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}
},
}
], - "links": {
- "prev": "/token-transfers?page[limit]=10&page[prev]=0x0078afae00f600028101320161a91f42",
- "next": "/token-transfers?page[limit]=10&page[next]=0x0078afae00f600028101320161a91f42"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of Block resources filtered by their status of being included in the current canonical (main) chain produced by the consensus network. If this filter is not set explicitly set, its implicit value is true
.
value | boolean The boolean flag representing the canonical status to filter by. |
Block List
{- "data": [
- {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/blocks?page[limit]=10&page[prev]=0x30b65c7412e887eb888abadb230171e7dc09da7bbe0f2a475c0feeed6950dc3b",
- "next": "/blocks?page[limit]=10&page[next]=0x30b65c7412e887eb888abadb230171e7dc09da7bbe0f2a475c0feeed6950dc3b"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
An Account is the superclass of all account types in Ethereum. All accounts are identified by an address (which, however, is derived differently for external and contract accounts) and an account state that contains the contract's balance and total message count, which is called its nonce. Contract accounts also have an associated storage state and EVM code. The address of an external account is derived from the public key of a public and private keypair, while a contract account address is a concatenation of the creator account's address and its nonce.
Returns the details of a given Account address.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
Contract
{- "data": {
- "type": "Contract",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "attributes": {
- "address": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "createdAtTimestamp": 1513630656,
- "constructorArgs": [
- "0x000000000000000000000000bfdb50dc66c8df9fd9688d8fe5a0c34126427645"
], - "bytecode": "0x60606040526004361061013e576000357c010000000000000000000000000000...",
- "balance": "370537404099999999585",
- "contractName": "StandardBounties"
}, - "relationships": {
- "account": {
- "data": {
- "type": "Account",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400"
}, - "links": {
}
}, - "createdAtBlock": {
- "data": {
- "type": "Block",
- "id": "0x2b5ea6f20cc07860890563fb91e1f7f876f8e604a4ba0451a77dd7158caade83"
}, - "links": {
}
}, - "createdAtTransaction": {
- "data": {
- "type": "Transaction",
- "id": "0x2929b98c2e0da944901b2ce9c3447f2b943c6f6e747baba3599fd0c2bd461ee0"
},
}, - "token": {
- "data": {
- "type": "Token",
- "id": null
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "logEntries": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the list of Transaction resources associated with a given Account, sorted in reverse chronological order (most recent first). Both the transactions originating from and sent to the account are included.
This collection supports the same filters as the Transactions collection.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of ContractMessage resources associated with a given Account, sorted in reverse chronological order (most recent first). Both the contract messages originating from and sent to the account are included.
This collection supports the same filters as the ContractMessages collection.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
ContractMessage List
{- "data": [
- {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}
], - "links": {
- "prev": "/contract-messages?page[limit]=10&page[prev]=0x006acfc000070000200117aa411843cb",
- "next": "/contract-messages?page[limit]=10&page[next]=0x006acfc000070000200117aa411843cb"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of EtherTransfer resources associated with a given Account, sorted in reverse chronological order (most recent first). Both the transfers that were sent to or received by the account are included.
This collection supports the same filters as the EtherTransfers collection.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
EtherTransfer List
{- "data": [
- {
- "type": "EtherTransfer",
- "id": "0x0079c69c004e00004200f7f0b0a20179",
- "attributes": {
- "transferType": "ContractMessageTransfer",
- "value": "4287663873500000512",
- "fee": "0",
- "total": "4287663873500000512",
- "blockCreationTime": 1560839506,
- "globalRank": [
- 7980700,
- 78,
- 0
], - "cursor": "0x0079c69c004e00004200f7f0b0a20179"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x6668ee95f387b0da9bd3e69ec0dbf5f1503b8135"
}, - "links": {
}
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0xbf0c5d82748ed81b5794e59055725579911e3e4e"
}, - "links": {
}
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0x61936196d934a793fb6a2fce76eb294164ede1fad708c9fe37a4b66c88762da3"
}, - "links": {
}
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0x61936196d934a793fb6a2fce76eb294164ede1fad708c9fe37a4b66c88762da3:1"
}, - "links": {
}
}, - "feeRecipient": {
- "data": {
- "type": "Account",
- "id": "0x04668ec2f57cc15c381b461b9fedab5d451c8f7f"
}, - "links": {
}
}, - "block": {
- "data": {
- "type": "Block",
- "id": "0xf7f0b0a2017979125d2b4418cdf0b1f796d053d28d7ce4d354de5741c07a857e"
}, - "links": {
}
}
},
}
], - "links": {
- "prev": "/ether-transfers?page[limit]=10&page[prev]=0x0079c69c004e00004200f7f0b0a20179",
- "next": "/ether-transfers?page[limit]=10&page[next]=0x0079c69c004e00004200f7f0b0a20179"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of TokenTransfer resources associated with a given Account, sorted in reverse chronological order (most recent first). Both the transfers that were sent to or received by the account are included.
This collection supports the same filters as the TokenTransfers collection.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
TokenTransfer List
{- "data": [
- {
- "type": "TokenTransfer",
- "id": "0x0078afae00f600028101320161a91f42",
- "attributes": {
- "value": "494131516286999999790",
- "symbol": "DAI",
- "blockCreationTime": 1559873076,
- "globalRank": [
- 7909294,
- 246,
- 2
], - "decimals": 18,
- "cursor": "0x0078afae00f600028101320161a91f42",
- "transactionGasLimit": 500000,
- "transactionGasPrice": "9000000000",
- "transactionGasUsed": 287312
}, - "relationships": {
- "token": {
- "data": {
- "type": "Token",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "links": {
}
}, - "from": {
- "data": {
- "type": "Account",
- "id": "0x9ae49c0d7f8f9ef4b864e004fe86ac8294e20950"
}, - "links": {
}
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529"
}, - "links": {
}
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:40"
}, - "links": {
}
}, - "logEntry": {
- "data": {
- "type": "LogEntry",
- "id": "log:0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:2"
}, - "links": {
}
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}
},
}
], - "links": {
- "prev": "/token-transfers?page[limit]=10&page[prev]=0x0078afae00f600028101320161a91f42",
- "next": "/token-transfers?page[limit]=10&page[next]=0x0078afae00f600028101320161a91f42"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of TokenBalance
resources associated with a
given Account, sorted in alphabetical order by Token address.
This collection supports the same filters as the TokenBalances collection.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
TokenBalance List
{- "data": [
- {
- "type": "TokenBalance",
- "id": "0x000000000000000000000000000000000000000057ab1e02fee23774580c119740129eac7081e9d3",
- "attributes": {
- "balance": "420000000000000"
}, - "relationships": {
- "token": {
- "data": {
- "type": "Token",
- "id": "0x57ab1e02fee23774580c119740129eac7081e9d3"
},
}, - "account": {
- "data": {
- "type": "Account",
- "id": "0x0000000000000000000000000000000000000000"
},
}
},
}
], - "links": {
- "prev": "/token-balances?page[limit]=10&page[prev]=0x0000000000000000000000000000000000000000df0960778c6e6597f197ed9a25f12f5d971da86c",
- "next": "/token-balances?page[limit]=10&page[next]=0x0000000000000000000000000000000000000000df0960778c6e6597f197ed9a25f12f5d971da86c"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Consolidates the activity of a given Account in a unified list of entries.
Returns an aggregated list of Transaction, ContractMessage, EtherTransfer and TokenTransfer resources, sorted in reverse chronological order.
address required | string <hex160> Example: 0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc Account hex address. |
Account Activity List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
A Contract account is an account whose behaviour is controlled by a smart contract. Contract accounts are identified by their address which is derived from the creator account's address and nonce. A contract account has a non-empty associated EVM code. It's state data consists of the bytecode, the contract's balance and the storage state of the contract's code (for example the value of variables). A contract account can only act when it is triggered by a message. It may not create and sign transactions, but it can receive transactions from external accounts as well as send and receive contract messages, which may involve a transfer of Ether. Contract accounts can also contain events which create log entries when triggered.
Returns the Contract resource linked to a given address.
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
Contract
{- "data": {
- "type": "Contract",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "attributes": {
- "address": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "createdAtTimestamp": 1513630656,
- "constructorArgs": [
- "0x000000000000000000000000bfdb50dc66c8df9fd9688d8fe5a0c34126427645"
], - "bytecode": "0x60606040526004361061013e576000357c010000000000000000000000000000...",
- "balance": "370537404099999999585",
- "contractName": "StandardBounties"
}, - "relationships": {
- "account": {
- "data": {
- "type": "Account",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400"
}, - "links": {
}
}, - "createdAtBlock": {
- "data": {
- "type": "Block",
- "id": "0x2b5ea6f20cc07860890563fb91e1f7f876f8e604a4ba0451a77dd7158caade83"
}, - "links": {
}
}, - "createdAtTransaction": {
- "data": {
- "type": "Transaction",
- "id": "0x2929b98c2e0da944901b2ce9c3447f2b943c6f6e747baba3599fd0c2bd461ee0"
},
}, - "token": {
- "data": {
- "type": "Token",
- "id": null
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "logEntries": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
address required | string <hex160> Example: 0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359 Contract hex address. |
Token
{- "data": {
- "type": "Token",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
- "attributes": {
- "tokenTypes": [
- "ERC179Token",
- "ERC20Token"
], - "symbol": "DAI",
- "name": "Dai Stablecoin v1.0",
- "decimals": 18,
- "totalSupply": "80908775777626805520803105"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Transaction resource associated with the Contract creation.
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
Transaction
{- "data": {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the ContractMessage resource that triggered the Contract creation.
address required | string <hex160> Example: 0x2f6392a729b76a6a3056b44e262c70442d26d3c7 Contract hex address. |
ContractMessage
{- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the list of Transaction resources that were sent to a given Contract, sorted in reverse chronological order (most recent first).
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of ContractMessage resources associated with a given Contract, sorted in reverse chronological order (descending by their globalRank
attribute). Both the contract messages originating from and sent to the contract are included.
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
ContractMessage List
{- "data": [
- {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}
], - "links": {
- "prev": "/contract-messages?page[limit]=10&page[prev]=0x006acfc000070000200117aa411843cb",
- "next": "/contract-messages?page[limit]=10&page[next]=0x006acfc000070000200117aa411843cb"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
address required | string <hex160> Example: 0x2af47a65da8CD66729b4209C22017d6A5C2d2400 Contract hex address. |
LogEntry List
{- "data": [
- {
- "type": "LogEntry",
- "id": "log:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:0",
- "attributes": {
- "hasLogTopics": [
- "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "0x000000000000000000000000f30cb9e6f48cde5f3df13231d466fd85e2687e7c",
- "0x0000000000000000000000007ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
], - "logData": "0x00000000000000000000000000000000000000000000004fa27864e788d40000",
- "globalRank": [
- 7274862,
- 1,
- 0
], - "eventDecodedError": null,
- "eventDecoded": {
- "event": "Transfer(address indexed from, address indexed to, uint256 value)",
- "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "inputs": [
- {
- "name": "from",
- "type": "address",
- "indexed": true,
- "value": "0xf30cb9e6f48cde5f3df13231d466fd85e2687e7c"
}, - {
- "name": "to",
- "type": "address",
- "indexed": true,
- "value": "0x7ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
}, - {
- "name": "value",
- "type": "uint256",
- "value": "1469000000000000000000"
}
]
}, - "cursor": "0x006f016e0080000030012901007eea7c"
}, - "relationships": {
- "loggedBy": {
- "data": {
- "type": "Contract",
- "id": "0xc9c4d9ec2b44b241361707679d3db0876ac10ca6"
},
}, - "block": {
- "data": {
- "type": "Block",
- "id": "0x2901007eea7c9b0c16d3c2c0c1449825687f339b79c655830f8c8891f8cbe1f5"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef"
},
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:1"
},
}
},
}
], - "links": {
- "prev": "/log-entries?page[limit]=10&page[prev]=0x006f016e0080000030012901007eea7c",
- "next": "/log-entries?page[limit]=10&page[next]=0x006f016e0080000030012901007eea7c"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
A Transaction is a message between two accounts that may transfer Ether and may contain a payload. Transactions always originate from an external account that is controlled by an external actor by means of a private key. The execution of a transaction creates a 'transaction receipt'.
Returns the Transaction resource identified by the given hash.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
Transaction
{- "data": {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Account resource representing the sender (from
field) of a given Transaction.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Account resource representing the destinaton (to
field) of given Transaction.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Block resource representing the canonical block where the Transaction was included.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
Block
{- "data": {
- "type": "Block",
- "id": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "attributes": {
- "number": 4041179,
- "blockCreationTime": 1500417203,
- "blockHash": "0x40dd9a773b81b00aacdc81598d19a5beef3ab66d391cc1cea6fb083294e7a184",
- "blockDifficulty": "1202852357499802",
- "blockBeneficiaryReward": "5093523764411027795",
- "hasBeneficiaryAlias": "Nanopool",
- "blockGasLimit": 6758494,
- "blockGasUsed": 6749593,
- "canonical": null
}, - "relationships": {
- "parentBlock": {
- "data": {
- "type": "Block",
- "id": "0x1c9fc940ae7ef69c02a2003575d0246cd91c478bcff16bbc623240d744b77c09"
},
}, - "hasBeneficiary": {
- "data": {
- "type": "Account",
- "id": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
},
}, - "transactions": {
- "meta": {
- "count": 165
}
}, - "contractMessages": {
}, - "logEntries": {
}, - "etherTransfers": {
}, - "tokenTransfers": {
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the list of Contract resources that were created as a result of executing the Transaction (and all its descendant ContractMessage resources).
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
Contract List
{- "data": [
- {
- "type": "Contract",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "attributes": {
- "address": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400",
- "createdAtTimestamp": 1513630656,
- "constructorArgs": [
- "0x000000000000000000000000bfdb50dc66c8df9fd9688d8fe5a0c34126427645"
], - "bytecode": "0x60606040526004361061013e576000357c010000000000000000000000000000...",
- "balance": "370537404099999999585",
- "contractName": "StandardBounties"
}, - "relationships": {
- "account": {
- "data": {
- "type": "Account",
- "id": "0x2af47a65da8CD66729b4209C22017d6A5C2d2400"
}, - "links": {
}
}, - "createdAtBlock": {
- "data": {
- "type": "Block",
- "id": "0x2b5ea6f20cc07860890563fb91e1f7f876f8e604a4ba0451a77dd7158caade83"
}, - "links": {
}
}, - "createdAtTransaction": {
- "data": {
- "type": "Transaction",
- "id": "0x2929b98c2e0da944901b2ce9c3447f2b943c6f6e747baba3599fd0c2bd461ee0"
},
}, - "token": {
- "data": {
- "type": "Token",
- "id": null
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "logEntries": {
- "links": {
}
}
},
}
], - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the list of all ContractMessage resources that were triggered as a result of executing the given Transaction.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
ContractMessage List
{- "data": [
- {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}
], - "links": {
- "prev": "/contract-messages?page[limit]=10&page[prev]=0x006acfc000070000200117aa411843cb",
- "next": "/contract-messages?page[limit]=10&page[next]=0x006acfc000070000200117aa411843cb"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of all LogEntry resources that were created as a result of executing the given transaction.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
LogEntry List
{- "data": [
- {
- "type": "LogEntry",
- "id": "log:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:0",
- "attributes": {
- "hasLogTopics": [
- "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "0x000000000000000000000000f30cb9e6f48cde5f3df13231d466fd85e2687e7c",
- "0x0000000000000000000000007ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
], - "logData": "0x00000000000000000000000000000000000000000000004fa27864e788d40000",
- "globalRank": [
- 7274862,
- 1,
- 0
], - "eventDecodedError": null,
- "eventDecoded": {
- "event": "Transfer(address indexed from, address indexed to, uint256 value)",
- "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
- "inputs": [
- {
- "name": "from",
- "type": "address",
- "indexed": true,
- "value": "0xf30cb9e6f48cde5f3df13231d466fd85e2687e7c"
}, - {
- "name": "to",
- "type": "address",
- "indexed": true,
- "value": "0x7ff6fd154863bedcbb0fa8e63abc9f1f38eec1fc"
}, - {
- "name": "value",
- "type": "uint256",
- "value": "1469000000000000000000"
}
]
}, - "cursor": "0x006f016e0080000030012901007eea7c"
}, - "relationships": {
- "loggedBy": {
- "data": {
- "type": "Contract",
- "id": "0xc9c4d9ec2b44b241361707679d3db0876ac10ca6"
},
}, - "block": {
- "data": {
- "type": "Block",
- "id": "0x2901007eea7c9b0c16d3c2c0c1449825687f339b79c655830f8c8891f8cbe1f5"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef"
},
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xd70ae3e306514044032fce92bd36a36b90aede20bb119b32672287d28debf5ef:1"
},
}
},
}
], - "links": {
- "prev": "/log-entries?page[limit]=10&page[prev]=0x006f016e0080000030012901007eea7c",
- "next": "/log-entries?page[limit]=10&page[next]=0x006f016e0080000030012901007eea7c"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of all TokenTransfer resources that were created as a result of executing the given Transaction.
txHash required | string <hex256> Example: 0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85 Transaction hash. |
TokenTransfer List
{- "data": [
- {
- "type": "TokenTransfer",
- "id": "0x0078afae00f600028101320161a91f42",
- "attributes": {
- "value": "494131516286999999790",
- "symbol": "DAI",
- "blockCreationTime": 1559873076,
- "globalRank": [
- 7909294,
- 246,
- 2
], - "decimals": 18,
- "cursor": "0x0078afae00f600028101320161a91f42",
- "transactionGasLimit": 500000,
- "transactionGasPrice": "9000000000",
- "transactionGasUsed": 287312
}, - "relationships": {
- "token": {
- "data": {
- "type": "Token",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "links": {
}
}, - "from": {
- "data": {
- "type": "Account",
- "id": "0x9ae49c0d7f8f9ef4b864e004fe86ac8294e20950"
}, - "links": {
}
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529"
}, - "links": {
}
}, - "contractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:40"
}, - "links": {
}
}, - "logEntry": {
- "data": {
- "type": "LogEntry",
- "id": "log:0x7544f294bed67ebf53f369e6a976ce4880174a53dc469fa3cfbc1fba5bcaf529:2"
}, - "links": {
}
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x98d29f6b55b59cef1d6c4c9f9b065302989d23d1"
}, - "links": {
}
}
},
}
], - "links": {
- "prev": "/token-transfers?page[limit]=10&page[prev]=0x0078afae00f600028101320161a91f42",
- "next": "/token-transfers?page[limit]=10&page[next]=0x0078afae00f600028101320161a91f42"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of Transaction resources that were sent by a given Account address, sorted in reverse chronological order (most recent first).
address required | string <hex160> Example: address=0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc The hex address of the originator Account. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of Transaction resources received by a given Account address, sorted in reverse chronological order (most recent first).
address required | string <hex160> Example: address=0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc The hex address of the destination Account. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of Transaction resources that were either sent to or received by a given Account address, sorted in reverse chronological order (most recent first).
address required | string <hex160> Example: address=0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc The hex address of the Account. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
Returns the list of Transaction resources filtered by their message type, sorted in reverse chronological order (most recent first).
type required | string Enum: "ValueTx" "CallTx" "CreateTx" Example: type=ValueTx The type of the Transaction. |
Transaction List
{- "data": [
- {
- "type": "Transaction",
- "id": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "attributes": {
- "txType": "CallTx",
- "msgType": "CallTx",
- "value": "0",
- "txNonce": 207,
- "msgGasLimit": 68881,
- "txGasPrice": "2000000000",
- "txHash": "0x9ed4aff20ae7c029affc78c3467cc4950922bd3d0e925ea6e097cb2f7e8ccf85",
- "txIndex": 43,
- "globalRank": [
- 7142277,
- 141,
- 0
], - "blockCreationTime": 1548735852,
- "firstSeen": 1548735819,
- "txGasUsed": 45921,
- "fee": "91842000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "approve(address spender, uint256 value) public nonpayable returns (bool param0)",
- "funcName": "approve",
- "funcSignature": "approve(address,uint256)",
- "funcSelector": "0x095ea7b3",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x095ea7b30000000000000000000000002af47a65da8cd66729b4209c22017d6a5c2d24000000000000000000000000000000000000000000000000015af1d78b58c40000"
}, - "cursor": "0x006cfb85008d000010008ca21f438ee5"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x734e4c7dbc53aad51a993828c8b9009aee87196b"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x8ca21f438ee5eccdb3a806c25d512837eb944d75025954c52a56ff2b346a0151"
},
}, - "createsContracts": {
}, - "contractMessages": {
}, - "logEntries": {
}, - "tokenTransfers": {
}
},
}
], - "links": {
- "prev": "/transactions?page[limit]=10&page[prev]=0x006cfb85008d000010008ca21f438ee5",
- "next": "/transactions?page[limit]=10&page[next]=0x006cfb85008d000010008ca21f438ee5"
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}, - "count": 10,
- "page": {
- "hasNext": true,
- "hasPrev": true
}
}
}
A Contract Message is passed between a contract account and any other account (external or contract). It is the result of an execution chain originally triggered by an external eccount.
Returns the ContractMessage resource identified by the given id.
id required | string Example: msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4 The ContractMessage ID. |
ContractMessage
{- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4",
- "attributes": {
- "msgType": "CallContractMsg",
- "value": "0",
- "msgGasLimit": 193347,
- "txGasPrice": "8000000000",
- "globalRank": [
- 7000000,
- 7,
- 0
], - "cmsgIndex": 4,
- "msgCallDepth": 2,
- "blockCreationTime": 1546466952,
- "msgGasUsed": 4800,
- "fee": "38400000000000",
- "msgError": false,
- "msgErrorString": "",
- "msgPayload": {
- "funcDefinition": "",
- "funcName": "",
- "funcSignature": "",
- "funcSelector": "0x5e9a523c",
- "inputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "outputs": [
- {
- "name": "string",
- "type": "string",
- "value": "string"
}
], - "raw": "0x5e9a523c00000000000000000000000089d24a6b4ccb1b6faa2625fe562bdd9a23260359"
}, - "cursor": "0x006acfc000070000200117aa411843cb"
}, - "relationships": {
- "from": {
- "data": {
- "type": "Account",
- "id": "0x9e77ad51e5c0825d6e440f49e49ef1a1bca37b5d"
},
}, - "to": {
- "data": {
- "type": "Account",
- "id": "0x02557a5e05defeffd4cae6d83ea3d173b272c904"
},
}, - "originator": {
- "data": {
- "type": "Account",
- "id": "0x65d25e3f2696b73b850daa07dd1e267dcfa67f2d"
},
}, - "includedInBlock": {
- "data": {
- "type": "Block",
- "id": "0x17aa411843cb100e57126e911f51f295f5ddb7e9a3bd25e708990534a828c4b7"
},
}, - "transaction": {
- "data": {
- "type": "Transaction",
- "id": "0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c"
},
}, - "parentContractMessage": {
- "data": {
- "type": "ContractMessage",
- "id": "msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:3"
},
}, - "createsContracts": {
}, - "logEntries": {
- "meta": {
- "count": 0
}
}, - "tokenTransfers": {
- "meta": {
- "count": 0
}
}
},
}, - "meta": {
- "latestBlock": {
- "number": 7909779,
- "blockCreationTime": 1559879572,
- "blockHash": "0x8f25ead8680577256d43d5401beeb9cefa4cc121478c79c75a2e23a4695aa450"
}
}
}
Returns the Account resource representing the sender of a given ContractMessage.
id required | string Example: msg:0xb53fdc2d618b5c35da706b399f9201721a74082fdb46ee90e487c82e422a4c8c:4 The ContractMessage ID. |
Account
{- "data": {
- "type": "Account",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "attributes": {
- "address": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc",
- "nonce": 3,
- "balance": "1600000000000000000"
}, - "relationships": {
- "contract": {
- "data": {
- "type": "Contract",
- "id": "0x50126e8fcb9be29f83c6bbd913cc85b40eaf86fc"
}, - "links": {
}
}, - "transactions": {
- "links": {
}
}, - "contractMessages": {
- "links": {
}
}, - "etherTransfers": {
- "links": {
}
}, - "tokenTransfers": {
- "links": {
}
}, - "etherBalances": {
- "links": {
}
}, - "tokenBalances": {
- "links": {
}
}
},
}, - "meta":