Getting Started with the SykikAI API: Developer Guide | SykikAI - AI Predictions for Sports, Forex & Crypto

Whether you're building a betting dashboard, a trading bot, or a content platform, SykikAI's API gives you programmatic access to our AI predictions, chat models, and real-time data. This guide walks you through everything you need to get started.

Step 1: Get Your API Key

API access requires a Developer plan subscription. Once subscribed, navigate to the API Keys page in your dashboard. Click "Create New Key" to generate your API key, which will be in the format sk- followed by 48 characters.

Important: Your key is displayed only once at creation. Copy it immediately and store it securely. If lost, you'll need to generate a new one.

Step 2: Authentication

Every API request must include your key in one of two ways:

Authorization header: Authorization: Bearer sk-your-key-here
Custom header: X-API-Key: sk-your-key-here

Step 3: Fetch Predictions

The predictions endpoint returns today's AI-generated predictions:

curl https://yourdomain.com/api/predictions \
  -H "Authorization: Bearer sk-your-key-here"

You can filter by sport using the ?sport=football parameter. Available sports include football, basketball, tennis, baseball, hockey, mma, boxing, and esports.

Step 4: Use AI Chat

The AI chat endpoint lets you query our models with custom prompts, optionally including real-time market data:

curl -X POST https://yourdomain.com/api/ai/chat \
  -H "Authorization: Bearer sk-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "prompt": "Analyze Bitcoin's price action this week", "include_market_data": true, "market_category": "crypto"}'

AI chat uses credits from your subscription. Each request deducts credits based on token usage and the selected model's cost per token.

Step 5: Set Up Webhooks

Instead of polling for new predictions, configure a webhook endpoint to receive them automatically. When new predictions are published, SykikAI sends a POST request to your URL with the full prediction data, signed with HMAC-SHA256 for verification.

Configure webhooks from your dashboard's Webhook Settings page. Each delivery includes a signature header for payload verification.

Rate Limits and Best Practices

The API is rate-limited to 100 requests per minute per API key. For real-time data needs, use webhooks rather than frequent polling. Cache responses where possible, and always handle 429 (rate limit) responses with exponential backoff.

For full endpoint documentation, parameter references, and response schemas, visit our API Documentation page.