> ## 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.

# Ghost Trader Status

> Live 7-condition Ghost Trader entry gate breakdown

<Note>
  To use the playground, enter your API key in the **X-API-Key** field above.
  Don't have a key? [Get one free →](/api-reference/keys/generate)
</Note>

**Tier:** Pro ✅
**Cache TTL:** 60 seconds

> ⚠️ This is a status snapshot, not financial advice.
> AIOKA Ghost Trader is a paper-trading simulation. Never make real financial
> decisions based solely on this signal.

## Gate Results

| Value                       | Meaning                                           |
| --------------------------- | ------------------------------------------------- |
| `conditions_met == 7`       | All hard gates pass — Ghost Trader would enter    |
| `conditions_met < 7`        | One or more gates failing — waiting for alignment |
| `has_open_position == true` | Ghost Trader already holds an open trade          |

<RequestExample>
  ```bash curl theme={null}
  curl https://api.aioka.io/v1/ghost/status \
    -H "X-API-Key: aik_pro_yourkeyhere"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "judiciary_ok": true,
    "council_ok": true,
    "ema_ok": true,
    "regime_favorable": true,
    "session_favorable": true,
    "momentum_ok": true,
    "quality_ok": true,
    "conditions_met": 7,
    "conditions_required": 7,
    "ema_distance_pct": 0.85,
    "current_rsi": 38.2,
    "regime": "WHALE_ACCUMULATION",
    "council_ruling": "BUY",
    "council_confidence": 0.78,
    "entry_mode": "B",
    "council_mode": "council",
    "has_open_position": false,
    "btc_price": 72340.5,
    "generated_at": "2026-04-13T08:22:00Z",
    "cached": false,
    "cache_ttl_seconds": 60
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/ghost/status
openapi: 3.1.0
info:
  title: AIOKA Intelligence API
  description: |

    ## AI-powered crypto market intelligence

    AIOKA Intelligence API provides real-time access to our AI Council verdicts,
    market signals, regime detection, and Ghost Trader entry signals.

    ### Tiers
    - **Free**: 100 calls/day — Verdict + Regime
    - **Basic** ($49/mo): 1,000 calls/day — + Signals
    - **Pro** ($199/mo): 10,000 calls/day — + Council + Ghost

    ### Authentication
    Pass your API key in the `X-API-Key` header:

    ```
    X-API-Key: aik_free_xxxxxxxxxxxx
    ```

    ### Get your API key
    `POST /v1/keys/generate` (free tier, no credit card)
  contact:
    name: AIOKA Support
    url: https://docs.aioka.io/
    email: api@aioka.io
  license:
    name: Commercial
    url: https://aioka.io/terms
  version: 1.0.0
servers:
  - url: https://api.aioka.io
    description: Production — AIOKA Intelligence API
security: []
paths:
  /v1/ghost/status:
    get:
      tags:
        - Ghost Trader
      summary: Ghost Trader 7-Condition Gate Status
      description: >-
        Returns the full Ghost Trader 7/7 entry gate breakdown — pass/fail for
        every

        hard gate plus the live market context that feeds them.


        Powers the AIOKA Live Trading Dashboard at aioka.io/live.


        **Tier:** Pro ✅

        **Cache TTL:** 60 seconds

        **Rate limit:** Pro tier limits (10,000 calls/day, 100/minute)

        **Read-only:** never writes to any trading table.


        ### The 7 hard gates


        | Gate | Field | Meaning |

        |------|-------|---------|

        | 1 | `judiciary_ok` | Latest Judiciary verdict is BUY / STRONG_BUY /
        ACCUMULATE |

        | 2 | `council_ok` | AI Council ruling bullish, confidence ≥0.75, ≥4
        bullish agents |

        | 3 | `ema_ok` | BTC price is +0.2% to +2.0% above EMA 200 (1H) |

        | 4 | `regime_favorable` | Market regime in WHALE_ACCUMULATION /
        ACCUMULATION / BULL_TRENDING / RISK_ON / LOW_VOLATILITY |

        | 5 | `session_favorable` | Not Friday 22:00 → Sunday 06:00 CEST
        (weekend low-liquidity block) |

        | 6 | `momentum_ok` | BTC change vs 60 min ago is not FALLING (> -0.3%)
        |

        | 7 | `quality_ok` | Composite entry quality score ≥ 65 (0–115 scale) |


        `conditions_met` is the count of gates currently passing. Ghost Trader
        only

        opens a new position when all 7 are true (`conditions_met ==
        conditions_required`).
      operationId: get_ghost_status_v1_ghost_status_get
      responses:
        '200':
          description: Live Ghost Trader gate breakdown
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GhostStatusResponse'
        '401':
          description: Invalid or missing API key
        '403':
          description: Pro tier required
        '429':
          description: Rate limit exceeded
      security:
        - APIKeyHeader: []
components:
  schemas:
    GhostStatusResponse:
      properties:
        judiciary_ok:
          type: boolean
          title: Judiciary Ok
        council_ok:
          type: boolean
          title: Council Ok
        ema_ok:
          type: boolean
          title: Ema Ok
        regime_favorable:
          type: boolean
          title: Regime Favorable
        session_favorable:
          type: boolean
          title: Session Favorable
        momentum_ok:
          type: boolean
          title: Momentum Ok
        quality_ok:
          type: boolean
          title: Quality Ok
        conditions_met:
          type: integer
          title: Conditions Met
        conditions_required:
          type: integer
          title: Conditions Required
        ema_distance_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Ema Distance Pct
        current_rsi:
          anyOf:
            - type: number
            - type: 'null'
          title: Current Rsi
        regime:
          anyOf:
            - type: string
            - type: 'null'
          title: Regime
        council_ruling:
          anyOf:
            - type: string
            - type: 'null'
          title: Council Ruling
        council_confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Council Confidence
        entry_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Entry Mode
        council_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Council Mode
        has_open_position:
          type: boolean
          title: Has Open Position
        btc_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Btc Price
        entry_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Entry Price
        current_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Current Price
        pnl_usd:
          anyOf:
            - type: number
            - type: 'null'
          title: Pnl Usd
        pnl_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Pnl Pct
        stop_loss:
          anyOf:
            - type: number
            - type: 'null'
          title: Stop Loss
        tp1_executed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Tp1 Executed
        tp1_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Tp1 Price
        tp1_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Tp1 Pnl
        tp2_target:
          anyOf:
            - type: number
            - type: 'null'
          title: Tp2 Target
        generated_at:
          type: string
          format: date-time
          title: Generated At
        cached:
          type: boolean
          title: Cached
        cache_ttl_seconds:
          type: integer
          title: Cache Ttl Seconds
      type: object
      required:
        - judiciary_ok
        - council_ok
        - ema_ok
        - regime_favorable
        - session_favorable
        - momentum_ok
        - quality_ok
        - conditions_met
        - conditions_required
        - ema_distance_pct
        - current_rsi
        - regime
        - council_ruling
        - council_confidence
        - entry_mode
        - council_mode
        - has_open_position
        - btc_price
        - generated_at
        - cached
        - cache_ttl_seconds
      title: GhostStatusResponse
      example:
        btc_price: 72340.5
        cache_ttl_seconds: 60
        cached: false
        conditions_met: 7
        conditions_required: 7
        council_confidence: 0.78
        council_mode: council
        council_ok: true
        council_ruling: BUY
        current_rsi: 38.2
        ema_distance_pct: 0.85
        ema_ok: true
        entry_mode: B
        generated_at: '2026-04-13T08:22:00Z'
        has_open_position: false
        judiciary_ok: true
        momentum_ok: true
        quality_ok: true
        regime: WHALE_ACCUMULATION
        regime_favorable: true
        session_favorable: true
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: 'Your AIOKA Intelligence API key (format: aik_{tier}_{random})'
      in: header
      name: X-API-Key

````