Quick Start

This quick start guide will help you set up and make your first API call to Herodotus Cloud Services.

​

Step 1: Sign Up for an API Key

Use either:

• The Herodotus Legacy Dashboard for Storage Proofs and Legacy APIs
  1. Visit the Herodotus Cloud Services Dashboard.
     You may need to use the staging dashboard to test your API calls if you are integrating with new services that have not been deployed to production yet. The staging dashboard is available at https://staging.dashboard.herodotus.dev.
     Please note that the API key on Staging and Production are different.

  2. Click on “Sign Up” and create an account.
  3. Once logged in, navigate to the API Keys section.
  4. You will see your API key. Save it securely.
• The Herodotus Cloud Console for Atlantic and Data Processor

​

Step 2: Choose the Right API

Herodotus Cloud Services offers several APIs tailored to different use cases:

​

Step 3: Make Your First API Call

Let’s make a simple API call to the Storage Proof API to prove an account’s balance:

curl -X POST https://api.herodotus.cloud/batch-query \
-H 'Content-Type: application/json' \
-H 'api-key: your-api-key-here' \
-d '{
  "destinationChainId": "11155111",
  "fee": "0",
  "data": {
    "11155111": {
      "block:5150551": {
        "accounts": {
          "0x17C2D875CB397D813eAE817DaFD25807E348Df07": {
            "props": ["BALANCE"],
            "slots": []
          }
        }
      }
    }
  }
}'

If successful, you’ll receive a response with an internal ID:

{
  "internalId": "01J2V235ABJY55JS2MY051ZJFJ"
}

The response will indicate the current status of your query:

{
  "queryStatus": "IN_PROGRESS"
}

​

Step 4: View query on Dashboard

You can use the returned internal ID on the dashboard to view the query in the explorer.

For detailed usage instructions, refer to your chosen service’s specific API documentation.