Steps
- Acquire the Tsunami API key
- Start sending requests!
API Key
To get an API key:
- Sign up on our Harbour website;
- Generate your free API key.
Then use it as Bearer Token type authorization for your requests.
Making a request
You can interact with our API by sending GET
requests to https://api.parsiq.net/tsunami/
The URL must have the Blockchain ID (i.e. eip155-1
for ETH mainnet), the API version and what data you want to get. More about what data and how can you get - Fundamental Data.
This simple example will retrieve the information on a block 1337 on Ethereum Mainnet blockchain, don't forget your API key.
curl --request GET \
--url https://api.parsiq.net/tsunami/eip155-1/v1/blocks/0x0c195cccdaf1c289879187a819ae8caed341fd5568e32d98b584c37dc09c59e7 \
--header 'Authorization: Bearer YOUR_API_KEY'
And the result is:
{
"hash": "0x0c195cccdaf1c289879187a819ae8caed341fd5568e32d98b584c37dc09c59e7",
"parent_hash": "0xcbbfdd32f913ff4f89c7245cf9ca8d0a01369162e55b10cdaa4e81c649d96a3c",
"number": 1337,
"timestamp": 1438272853,
"header": {
"nonce": 13832925282326362000,
"gas_used": 0,
"mix_hash": "0x24d2cbd32966e5f1236ceaf06e642841d59fbde9600b50de99172b176ed5349c",
"gas_limit": 5000,
"difficulty": 32772017830,
"extra_data": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
"logs_bloom": "0x0",
"state_root": "0x29abe8d7ad4236c256576d03171843465500b56f2ad722c78f989dd22fd07de1",
"sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"receipts_root": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"total_difficulty": 32205844140793,
"transactions_root": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}