Getting Started

1. Create an Account

To access the Alphanume API, create a free account at:

👉 Alphanume Sign-Up

After registering and setting your password, your API key will be emailed to you automatically.

All accounts (including free/trial) receive an API key.

Base URL

All Alphanume API requests are made against:

2. Example Request

The API follows a simple, query-parameter–based request structure.

Below is a sample request to the Historical Market Cap endpoint:

import requests

url = "https://api.alphanume.com/v1/historical-market-cap"
params = {
    "ticker": "AAPL",
    "date": "2026-02-06",
    "api_key": "alp_abc123"
}

response = requests.get(url, params=params)
data = response.json()

print(data)

curl "https://api.alphanume.com/v1/historical-market-cap?ticker=AAPL&date=2026-02-06&api_key=alp_abc123"

Header-Based Auth

curl "https://api.alphanume.com/v1/historical-market-cap?ticker=AAPL&date=2026-02-06" \
  -H "X-API-Key: alp_abc123"

3. Response Format

Responses are returned in JSON format and are designed to be immediately usable in research pipelines.

{
   "count":1,
   "data":[
      {
         "date":"2026-02-06",
         "ticker":"AAPL",
         "market_cap":4109599296360.0,
         "shares_outstanding":14776353000.0
      }
   ]
}

4. General Pattern

All Alphanume endpoints follow the same structure:

GET /v1/{endpoint}?param1=value&param2=value&api_key=alphanume_api_key

This makes it easy to programmatically construct requests across datasets without learning new schemas.

5. Rate Limits

• Free tier: 60 requests per minute

• Pro tier: 600 requests per minute

• Exceeding limit returns HTTP 429

6. Next Steps

• Explore available datasets

• Review authentication (API key setup)

• Integrate directly into your backtests or production systems