Basic SQL Usage Examples¶
Welcome!¶
Within this tutorial you will learn how to retrieve and analyze data from the Ethereum Blockchain with the help of the eth.events SQL interface.
We will show you how to retrieve data from eth.events using common SQL language.
What you must know already¶
This tutorial is written for programmers, who have some experience with SQL. You should also have visited the authorization page and setup our connection to the database. Remember that the subentities are stored using the Postgresql-Type JSONB. For more information on that, please take a look at the ER model.
Basic eth.events SQL queries¶
Choose one of the databases available. All of them are encoded as the triple of:
<technology>_<chain>_<network>
The main chain is named ethereum_ethereum_mainnet.
After choosing a blockchain, you might continue with the example queries.
Find the latest block¶
SELECT * FROM block ORDER BY number DESC LIMIT 1
This will show the whole block. But you can use a shorter form:
SELECT max(number) FROM block
Find events for a given block¶
SELECT * FROM event
WHERE event.block_number = 7075271
Find calls for a transaction hash¶
SELECT * FROM call
WHERE call.hash = '0xadd837afa5b68987eb9f0167ad65cbb8131f57da84db56a19acf4a5a98bd35da'
Find transactions for a given contract¶
For our example we use the address of the TenXPay token contract:
SELECT * FROM tx
WHERE tx.to = '0xB97048628DB6B661D4C2aA833e95Dbe1A905B280'
LIMIT 100
Find specific events for a given contract¶
For our example we use the address of the TenXPay token contract again, however we would like to know the values of transfers greater than 1ETH:
SELECT arg->'scaled', arg ->'num'
FROM "event",jsonb_array_elements(args) arg
WHERE event = 'Transfer' AND address = '0xB97048628DB6B661D4C2aA833e95Dbe1A905B280'
AND (arg->'num')::numeric > 1000000000000000000
LIMIT 100
Where to go from here¶
You may continue with taking a look at the Elasticsearch tutorial. Please let us know if you have any further questions or need some help with your application.