1. Acquire the Tsunami API key :key:
  2. Start sending requests! :construction-worker:


To get an 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

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 \
     --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"