> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> AI-powered crypto market intelligence for developers

# AIOKA Intelligence API

AIOKA Intelligence API gives you programmatic access to our AI Council verdicts,
live market signals, regime detection, and Ghost Trader entry signals.

<Note>
  **Start in 60 seconds — free forever.**
  No credit card required. 100 API calls/day.
  [Generate your free API key →](https://api.aioka.io/v1/keys/generate)
</Note>

## What is AIOKA?

AIOKA runs councils of **specialized AI agents** that analyze live market signals 24/7
and reach consensus verdicts on crypto, commodities, and FX market conditions.
Every ruling is backed by on-chain data, macro environment analysis, options market
signals, and liquidity intelligence.

AIOKA Ghost Trader currently runs paper-mode strategies on seven assets:

* BTC (Bitcoin) -- live, frozen reference path
* ETH (Ethereum) -- 6-agent crypto council
* SOL (Solana) -- 6-agent crypto council
* TAO (Bittensor) -- 6-agent crypto council, AI-narrative
* Gold (XAU/USD) -- 6-agent commodities council, real-rate Gate 8
* EUR/USD -- 6-agent Forex council, weekend gap protection, news blackout for FOMC/NFP/CPI/ECB (Sprint 186)
* ADA (Cardano) -- 6-agent crypto council, 7-gate framework (no network gate), 4-decimal pricing (Sprint 184)

Each asset runs an isolated trader and council loop. None touch the BTC reference
path (rule F-1). All ship with paper-mode validation gates: 10 closed paper trades
plus a documented sprint approval before real capital is unlocked.

TAO ("AI trading AI") is AIOKA's most advanced council asset -- 6 Bittensor-specific
specialist agents (SUBNET\_ORACLE, MACRO\_SAGE, AI\_NARRATIVE, MOMENTUM\_HUNTER,
LIQUIDITY\_GUARDIAN, RISK\_WARDEN) deliberate on subnet growth, staking dynamics, AI
sector sentiment, and a Kraken order-book liquidity floor (Gate 0) unique to TAO.

<CardGroup cols={2}>
  <Card title="AI Council Verdicts" icon="brain">
    Real-time rulings from 6 specialized agents with confidence scores and consensus
  </Card>

  <Card title="Agent Accuracy Stats" icon="bullseye">
    Historical hit rate of each AI Council agent, graded against the outcome of every closed BTC trade
  </Card>

  <Card title="27 Live Signals" icon="chart-line">
    On-chain, macro, options, liquidation, and liquidity data — all in one feed
  </Card>

  <Card title="Regime Detection" icon="radar">
    HMM-powered market regime classification with 5 granular v2 regime labels
  </Card>

  <Card title="Ghost Trader Signals (BTC + ETH + SOL + TAO + ADA)" icon="ghost">
    Live entry gate conditions -- BTC live trading plus ETH, SOL, TAO, and ADA paper mode (building track records). SOL adds Gate 0 (Solana network health); TAO adds Gate 0 (Kraken liquidity floor) plus 6 Bittensor specialist agents. ADA runs the standard 7-gate framework with 4-decimal pricing.
  </Card>

  <Card title="Dark Pool Monitoring" icon="eye">
    OTC and institutional flow intelligence — dark pool score, exchange reserve changes, stablecoin minting
  </Card>

  <Card title="News NLP & Fed Sentiment" icon="newspaper">
    Keyword-based hawkish/dovish Fed tone analysis and macro news risk scoring
  </Card>

  <Card title="Flash Crash Protection" icon="bolt">
    Circuit breaker detection across 5/15/30-minute windows — emergency exit signals before TSL triggers
  </Card>

  <Card title="Monte Carlo Stress Testing" icon="chart-bar">
    Probabilistic BTC price path simulations for risk management and portfolio stress testing
  </Card>
</CardGroup>

<Card title="Get your free API key" icon="key" href="https://docs.aioka.io/quickstart">
  Free forever. 100 calls/day. No credit card. Live in 60 seconds.
</Card>

## Get Started in 60 Seconds

<Steps>
  <Step title="Get your free API key">
    Generate a free key instantly — no credit card required.

    ```bash theme={null}
    curl -X POST https://api.aioka.io/v1/keys/generate \
      -H "Content-Type: application/json" \
      -d '{
        "name": "My Trading Bot",
        "email": "you@example.com"
      }'
    ```

    You'll receive your key instantly:

    ```json theme={null}
    {
      "api_key": "aik_free_xxxxxxxxxxxx",
      "tier": "free",
      "calls_per_day": 100,
      "message": "Welcome to AIOKA!"
    }
    ```
  </Step>

  <Step title="Make your first call">
    ```bash theme={null}
    curl https://api.aioka.io/v1/verdict/latest \
      -H "X-API-Key: aik_free_your_key_here"
    ```
  </Step>

  <Step title="Upgrade for more data">
    Basic (\$49/mo) unlocks signals and history.
    Pro (\$199/mo) unlocks AI Council and Ghost Trader signals.

    [View pricing →](/tiers)
  </Step>
</Steps>

## Architecture

AIOKA Intelligence API is a **read-only** window into the AIOKA trading system.
It never modifies trading positions, verdicts, or any operational state.

<CardGroup cols={2}>
  <Card title="AIOKA Core" icon="server">
    **Railway Service #1** — writes to Neon DB

    **Ghost Trader BTC** — Live trading

    **Ghost Trader ETH** — Paper mode (building track record)

    **Ghost Trader SOL** — Paper mode (building track record)

    **Ghost Trader TAO** -- Paper mode (building track record)

    **Ghost Trader ADA** -- Paper mode (building track record)
  </Card>

  <Card title="AIOKA Intelligence API" icon="cloud">
    **Railway Service #2** — reads from Neon DB

    Read-only window into the trading system.

    You are here.
  </Card>
</CardGroup>

Data flows **one way**: the AIOKA core writes to a shared Neon database, and the
Intelligence API reads from it. Your calls never affect the trading logic.