Skip to main content
Every HayInsights endpoint needs a single header, X-API-Key. No request signing, no token exchange.
1

Get an API key

Sign in to the HayInsights dashboard and go to Account → API keys to create a key. It looks like apk_….Store it as an environment variable:
export HAYINSIGHTS_API_KEY="apk_your_key_here"
2

Make your first request

Fetch crypto market dominance:
curl -H "X-API-Key: $HAYINSIGHTS_API_KEY" \
  "https://api.hayinsights.com/openapi/v1/crypto/dominance"
3

Read the response

Every response uses the standard envelope. The payload is in data:
{
  "success": true,
  "statusCode": 200,
  "data": {
    "totalMarketCap": 2157717188047.44,
    "coins": [
      { "symbol": "BTC", "name": "Bitcoin", "dominancePercentage": 58.16, "marketCap": 1254870895730.76 },
      { "symbol": "ETH", "name": "Ethereum", "dominancePercentage": 9.48, "marketCap": 204564386727.13 }
    ]
  },
  "meta": { "timestamp": "2026-06-19T08:31:59.478Z" }
}
success: true means the call worked. On an error, success is false and the details are in error — see Error codes.
4

Check your quota

Every response carries rate-limit headers so you can self-throttle:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1781857979
X-RateLimit-Weight-Used: 3
See Rate limits for the weighting model.

​
Next steps

Authentication

How API keys work and how to rotate them.

Browse the API

All 40 endpoints across the six data domains.

Plans & features

Which plan unlocks which datasets.

Rate limits

Weighted quota and the X-RateLimit-* headers.