API Key Management
Generate and manage API keys for programmatic access
API keys allow you to access Optionomics data programmatically through our REST API. This feature is available with the Vega plan subscription.
Generating API Keys
Prerequisites
- Active Vega plan subscription
- Verified email address
- Account in good standing
Steps to Generate a Key
- Navigate to API Keys
- Log into your account
- Go to Account → API Keys
- Click “Create new key”
- Configure Your Key
- Name: Provide a descriptive name (e.g., “Trading Bot”, “Research Script”)
- Expiry: Set expiration period (30, 60, 90 days, or custom)
- Permissions: All keys have full read access to API endpoints
- Save Your Token
- Copy the generated token immediately
- Important: The token is shown only once for security
- Store it securely in your application
Rate Limits
Vega Plan Limits
- 100 requests per minute
- Rate limit headers when limit reached
Rate Limit Headers
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200
Using Your API Key
Authentication Headers
Include in all API requests:
X-USER-EMAIL: [email protected]
X-USER-TOKEN: your-api-token
Example Request
curl -X GET "https://optionomics.ai/api/v1/stocks/SPY/options" \
-H "X-USER-EMAIL: [email protected]" \
-H "X-USER-TOKEN: abc123xyz789"
Troubleshooting
Common Issues
- 401 Unauthorized: Invalid token or email
- 403 Forbidden: No API access (upgrade to Vega plan)
- 429 Too Many Requests: Rate limit exceeded
Getting Help
- Review API Documentation
- Contact [email protected]
Security Note: Treat API keys as passwords. If compromised, delete immediately and generate new ones.
