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

> Current entry signal from AIOKA Ghost Trader

<Note>
  To use the playground, enter your API key in the **X-API-Key** field above.
  Requires PRO tier key (\$199/mo). Contact [info@aioka.io](mailto:info@aioka.io) to upgrade.
</Note>

**Tier:** Pro (\$199/mo) 🔒
**Cache TTL:** 30 seconds

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

## Signal Values

| Signal        | Meaning                        |
| ------------- | ------------------------------ |
| `ENTER`       | All 7 entry conditions met     |
| `HOLD`        | Conditions not fully met       |
| `IN_POSITION` | Ghost Trader has an open trade |

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "signal": "HOLD",
    "entry_mode": "B",
    "conditions_met": 5,
    "conditions_required": 7,
    "entry_quality": null,
    "has_open_position": false,
    "rsi": 42.3,
    "ema_distance_pct": 0.85,
    "regime": "BULL_TRENDING",
    "timestamp": "2026-04-03T10:22:00Z",
    "cached": false,
    "cache_ttl_seconds": 30
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/ghost/signal
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/signal:
    get:
      tags:
        - Ghost Trader
      summary: Ghost Trader Entry Signal
      description: >-
        Returns the current Ghost Trader entry signal derived from live 7/7 gate
        conditions.


        ⚠️ **This is a signal, not financial advice.** AIOKA Ghost Trader is a
        paper-trading

        simulation. Never make real financial decisions based solely on this
        signal.


        **Tier:** Pro ($199/mo) 🔒

        **Cache TTL:** 30 seconds

        **Rate limit:** 10,000 calls/day, 100/minute


        ### Signal values

        | Signal | Meaning |

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

        | `ENTER` | All entry conditions met — Ghost Trader would open a
        position |

        | `HOLD` | Conditions not fully met — waiting for better setup |

        | `IN_POSITION` | Ghost Trader already has an open trade |
      operationId: get_ghost_signal_v1_ghost_signal_get
      responses:
        '200':
          description: Ghost Trader signal
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GhostSignalResponse'
        '401':
          description: Invalid or missing API key
        '403':
          description: Pro tier required
        '429':
          description: Rate limit exceeded
      security:
        - APIKeyHeader: []
components:
  schemas:
    GhostSignalResponse:
      properties:
        signal:
          type: string
          title: Signal
        entry_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Entry Mode
        conditions_met:
          type: integer
          title: Conditions Met
        conditions_required:
          type: integer
          title: Conditions Required
        entry_quality:
          anyOf:
            - type: number
            - type: 'null'
          title: Entry Quality
        has_open_position:
          type: boolean
          title: Has Open Position
        rsi:
          anyOf:
            - type: number
            - type: 'null'
          title: Rsi
        ema_distance_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Ema Distance Pct
        regime:
          anyOf:
            - type: string
            - type: 'null'
          title: Regime
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        cached:
          type: boolean
          title: Cached
        cache_ttl_seconds:
          type: integer
          title: Cache Ttl Seconds
      type: object
      required:
        - signal
        - entry_mode
        - conditions_met
        - conditions_required
        - entry_quality
        - has_open_position
        - rsi
        - ema_distance_pct
        - regime
        - timestamp
        - cached
        - cache_ttl_seconds
      title: GhostSignalResponse
      example:
        cache_ttl_seconds: 28
        cached: true
        conditions_met: 5
        conditions_required: 7
        ema_distance_pct: 0.85
        entry_mode: B
        has_open_position: false
        regime: BULL_TRENDING
        rsi: 42.3
        signal: HOLD
        timestamp: '2026-04-03T10:22:00Z'
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: 'Your AIOKA Intelligence API key (format: aik_{tier}_{random})'
      in: header
      name: X-API-Key

````