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

# Generate API Key

> Generate a free tier API key instantly

**Tier:** Public — No API key required
**Rate limit:** None (open endpoint)

> ⚠️ Store your key safely — it **cannot be recovered** after this response!


## OpenAPI

````yaml POST /v1/keys/generate
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/keys/generate:
    post:
      tags:
        - API Keys
      summary: Generate Free API Key
      description: >-
        Generate a free tier API key instantly. No credit card required.


        **Free tier includes:**

        - 100 API calls per day

        - 2 calls per minute

        - Access to: `GET /v1/verdict/latest`, `GET /v1/regime/current`, `GET
        /v1/health`


        **Upgrade to Basic or Pro:**

        Contact us at api@aioka.io


        ⚠️ Store your key safely — it **cannot be recovered** after this
        response!
      operationId: generate_free_key_v1_keys_generate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KeyGenerateRequest'
        required: true
      responses:
        '200':
          description: Key generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyGenerateResponse'
        '400':
          description: Validation error
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    KeyGenerateRequest:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 2
          title: Name
          description: Your name or project name
        email:
          type: string
          title: Email
          description: Your email address
      type: object
      required:
        - name
        - email
      title: KeyGenerateRequest
      example:
        email: dev@example.com
        name: My Trading Bot
    KeyGenerateResponse:
      properties:
        api_key:
          type: string
          title: Api Key
        tier:
          type: string
          title: Tier
        calls_per_day:
          type: integer
          title: Calls Per Day
        calls_per_minute:
          type: integer
          title: Calls Per Minute
        created_at:
          type: string
          format: date-time
          title: Created At
        message:
          type: string
          title: Message
      type: object
      required:
        - api_key
        - tier
        - calls_per_day
        - calls_per_minute
        - created_at
        - message
      title: KeyGenerateResponse
      example:
        api_key: aik_free_a1b2c3d4e5f6g7h8i9j0
        calls_per_day: 100
        calls_per_minute: 2
        created_at: '2026-04-03T10:22:00Z'
        message: Store this key safely — it cannot be recovered!
        tier: free
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````