Skip to main content

Quickstart

1. Generate a Free Key

curl -X POST https://api.aioka.io/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"name": "My Trading Bot", "email": "you@example.com"}'
Response:
{
  "api_key": "aik_free_a1b2c3d4e5f6g7h8i9j0",
  "tier": "free",
  "calls_per_day": 10,
  "calls_per_minute": 2,
  "message": "Store this key safely — it cannot be recovered!"
}

2. Get the Latest Verdict

curl https://api.aioka.io/v1/verdict/latest \
  -H "X-API-Key: aik_free_a1b2c3d4e5f6g7h8i9j0"
Response:
{
  "ruling": "ACCUMULATE",
  "confidence": 0.782,
  "score": 0.438,
  "btc_price": 67124.0,
  "timestamp": "2026-04-03T10:22:00Z",
  "cached": false,
  "cache_ttl_seconds": 60
}

3. Check the Market Regime

curl https://api.aioka.io/v1/regime/current \
  -H "X-API-Key: aik_free_a1b2c3d4e5f6g7h8i9j0"
Response:
{
  "regime": "BULL_TRENDING",
  "confidence": 0.84,
  "btc_price": 67124.0,
  "detected_at": "2026-04-03T10:00:00Z",
  "cached": true,
  "cache_ttl_seconds": 290
}

4. Build a Simple Alert Bot

import httpx
import time

API_KEY = "aik_free_your_key_here"
BASE_URL = "https://api.aioka.io"

client = httpx.Client(
    base_url=BASE_URL,
    headers={"X-API-Key": API_KEY},
)

def check_verdict():
    resp = client.get("/v1/verdict/latest")
    data = resp.json()
    ruling = data["ruling"]
    confidence = data["confidence"]
    
    if ruling in ("STRONG_BUY", "BUY") and confidence > 0.75:
        print(f"🟢 BULLISH SIGNAL: {ruling} ({confidence:.0%} confidence)")
    elif ruling in ("STRONG_SELL", "SELL"):
        print(f"🔴 BEARISH SIGNAL: {ruling}")
    else:
        print(f"⚪ {ruling} — waiting")

# Poll every 5 minutes (respects free tier limits)
while True:
    check_verdict()
    time.sleep(300)

Next Steps

Upgrade to Basic

Get 27 live signals and verdict history for $49/mo

API Reference

Full endpoint documentation with examples