Skip to main content
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

  1. Visit the Herodotus Cloud Services Dashboard.
    If you are integrating with services that are not deployed to production yet, switch to Staging using the environment toggle in the dashboard header.
  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.
    If you’re having trouble getting the API key, have a look at the authentication page.

​
Step 2: Choose the Right API

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

Storage Proof API

Request cryptographic proofs of arbitrary on-chain data.

Data Processor API

Perform verifiable computations over arbitrary on-chain data.

Data Structure Indexer API

Access the data structures we use to power Storage Proofs and Data Processor APIs.

Atlantic API

Managed ZK Prover Infrastructure. Your gateway to the StarkWare SHARP prover service.

​
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.