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

# TAO Live Signals

> Latest readings of all 9 TAO-specific signals plus the Kraken liquidity floor probe (Gate 0)

<Note>
  Pro tier endpoint -- requires a valid Pro API key. Fetches fresh
  signal readings on every request (expect 1 -- 3 seconds response time).
</Note>

**Tier:** Pro (\$199/mo)
**Cache:** None -- fetches fresh on every request
**Rate limit:** 30/min (per tier)
**Read-only:** No writes.

## Response Fields

### Top-level

| Field               | Type           | Meaning                                                                           |
| ------------------- | -------------- | --------------------------------------------------------------------------------- |
| `signals`           | array          | Latest readings for each TAO signal, one entry per signal key                     |
| `liquidityStatus`   | string         | Gate 0 result: `"SUFFICIENT"` / `"INSUFFICIENT"` / `"UNKNOWN"`                    |
| `liquidityDepthUsd` | number \| null | Kraken order-book depth (USD) within ±0.5% of mid-price. `null` when probe fails. |
| `generatedAt`       | string         | Response timestamp (ISO 8601)                                                     |

### Per-signal (signals array)

| Field       | Type           | Meaning                                                                    |
| ----------- | -------------- | -------------------------------------------------------------------------- |
| `key`       | string         | Signal identifier (see signal catalog below)                               |
| `value`     | number \| null | Latest numeric reading. `null` when the source is temporarily unavailable. |
| `direction` | string         | `"BULLISH"` / `"BEARISH"` / `"NEUTRAL"` / `"UNKNOWN"`                      |
| `source`    | string         | Data source identifier (e.g. `"taostats.io"`, `"github"`, `"defi_llama"`)  |
| `detail`    | string         | Human-readable description of the current reading                          |
| `fetchedAt` | string         | ISO 8601 timestamp of when this reading was captured                       |

## TAO Signal Catalog

All 9 TAO-specific signals are listed below. Signals feed the specialist
agent deliberation every 30 minutes and are written to `tao_signal_history`.

| Signal Key                       | Description                                                                                                                 | Source            | Agent            |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- |
| `SUBNET_COUNT_GROWTH`            | 30-day growth rate of active Bittensor subnets (%)                                                                          | taostats.io       | SUBNET\_ORACLE   |
| `TAO_STAKING_RATIO`              | % of total TAO supply currently staked to validators                                                                        | taostats.io       | SUBNET\_ORACLE   |
| `TAO_EMISSION_RATE`              | Current block emission rate relative to pre-halving baseline. \< 1.0 = post-halving compression.                            | taostats.io       | SUBNET\_ORACLE   |
| `VALIDATOR_NAKAMOTO_COEFFICIENT` | Nakamoto coefficient of the validator set -- minimum validators needed for 51% stake control. Higher = more decentralized.  | taostats.io       | SUBNET\_ORACLE   |
| `TAO_BTC_RATIO_TREND`            | TAO/BTC ratio 7-day trend direction (positive = TAO outperforming BTC)                                                      | Internal (Kraken) | MOMENTUM\_HUNTER |
| `BITTENSOR_GITHUB_ACTIVITY`      | Weekly commit count on `opentensor/bittensor` repo (normalized z-score vs 90-day baseline)                                  | GitHub API        | AI\_NARRATIVE    |
| `AI_SECTOR_SENTIMENT`            | Composite AI sector sentiment from NVDA 5-day momentum, BOTZ ETF flow, and IRBO ETF flow                                    | Yahoo Finance     | AI\_NARRATIVE    |
| `SUBNET_REVENUE`                 | Estimated 7-day subnet revenue (USD) across top Bittensor subnets -- proxy for network economic activity                    | DeFiLlama         | SUBNET\_ORACLE   |
| `INSTITUTIONAL_POSITIONING`      | 13F filing signal -- net change in institutional TAO exposure vs prior quarter. `null` outside filing windows (45-day lag). | SEC/EDGAR         | RISK\_WARDEN     |

## Notes

* Signals sourced from taostats.io are polled every 30 minutes during the
  council refresh cycle. Individual signal age is visible in `fetchedAt`.
* `INSTITUTIONAL_POSITIONING` is only populated during SEC 13F filing windows
  (quarterly, with a 45-day lag). It returns `null` between filing periods.
* `AI_SECTOR_SENTIMENT` is a composite -- a single score derived from three
  underlying components (NVDA, BOTZ, IRBO). Detail is exposed in the `detail`
  string of each entry.
* The `liquidityStatus` and `liquidityDepthUsd` fields in the top-level
  response are always fresh (60s probe cache) -- they are NOT pulled from
  `tao_signal_history`.

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "signals": [
      {
        "key": "SUBNET_COUNT_GROWTH",
        "value": 0.034,
        "direction": "BULLISH",
        "source": "taostats.io",
        "detail": "Active subnets grew 3.4% in the past 30 days (64 -> 66)",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "TAO_STAKING_RATIO",
        "value": 0.621,
        "direction": "BULLISH",
        "source": "taostats.io",
        "detail": "62.1% of supply staked -- above 60% threshold",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "TAO_EMISSION_RATE",
        "value": 0.512,
        "direction": "BULLISH",
        "source": "taostats.io",
        "detail": "Post-halving compression: emission at 51.2% of pre-halving rate. 157 days since 2025-12-01 halving.",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "VALIDATOR_NAKAMOTO_COEFFICIENT",
        "value": 12.0,
        "direction": "NEUTRAL",
        "source": "taostats.io",
        "detail": "12 validators control 51% of stake (unchanged vs last week)",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "TAO_BTC_RATIO_TREND",
        "value": 0.0048,
        "direction": "BULLISH",
        "source": "kraken",
        "detail": "TAO/BTC ratio up 0.48% over 7 days -- TAO outperforming BTC",
        "fetchedAt": "2026-05-06T10:28:00+00:00"
      },
      {
        "key": "BITTENSOR_GITHUB_ACTIVITY",
        "value": 1.4,
        "direction": "BULLISH",
        "source": "github",
        "detail": "Weekly commit count z-score +1.4 vs 90-day baseline (above average dev activity)",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "AI_SECTOR_SENTIMENT",
        "value": 0.62,
        "direction": "BULLISH",
        "source": "yahoo_finance",
        "detail": "NVDA +2.1% (5d), BOTZ +0.8% (5d), IRBO +1.2% (5d) -- composite bullish",
        "fetchedAt": "2026-05-06T10:25:00+00:00"
      },
      {
        "key": "SUBNET_REVENUE",
        "value": 142500.0,
        "direction": "NEUTRAL",
        "source": "defi_llama",
        "detail": "7-day subnet revenue $142,500 -- stable vs prior week",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      },
      {
        "key": "INSTITUTIONAL_POSITIONING",
        "value": null,
        "direction": "UNKNOWN",
        "source": "sec_edgar",
        "detail": "Outside 13F filing window -- next data expected Q3 2026",
        "fetchedAt": "2026-05-06T08:00:00+00:00"
      }
    ],
    "liquidityStatus": "SUFFICIENT",
    "liquidityDepthUsd": 82500.0,
    "generatedAt": "2026-05-06T10:30:00+00:00"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/tao/signals
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/tao/signals:
    get:
      tags:
        - TAO Ghost Trader
      summary: Live TAO Signals Snapshot
      description: |-
        Returns the latest readings of all 9 TAO-specific signals plus the
        liquidity floor probe (Gate 0). Each signal includes value, direction
        (BULLISH / BEARISH / NEUTRAL / UNKNOWN), source, and detail string.

        **Tier:** Pro
        **Cache:** None (fetches fresh on every request -- expect 1-3 s)
        **Rate limit:** 30/min (per tier)
      operationId: get_tao_signals_v1_tao_signals_get
      responses:
        '200':
          description: TAO signals snapshot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TAOSignalsResponse'
        '401':
          description: Missing or invalid API key
        '403':
          description: Tier insufficient
      security:
        - APIKeyHeader: []
components:
  schemas:
    TAOSignalsResponse:
      properties:
        signals:
          items:
            $ref: '#/components/schemas/TAOSignalEntry'
          type: array
          title: Signals
        liquidityStatus:
          type: string
          title: Liquiditystatus
          default: UNKNOWN
        liquidityDepthUsd:
          anyOf:
            - type: number
            - type: 'null'
          title: Liquiditydepthusd
        generatedAt:
          type: string
          format: date-time
          title: Generatedat
      type: object
      required:
        - signals
        - generatedAt
      title: TAOSignalsResponse
    TAOSignalEntry:
      properties:
        key:
          type: string
          title: Key
        value:
          anyOf:
            - type: number
            - type: 'null'
          title: Value
        direction:
          type: string
          title: Direction
        source:
          type: string
          title: Source
        detail:
          type: string
          title: Detail
          default: ''
        fetchedAt:
          type: string
          format: date-time
          title: Fetchedat
      type: object
      required:
        - key
        - direction
        - source
        - fetchedAt
      title: TAOSignalEntry
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: 'Your AIOKA Intelligence API key (format: aik_{tier}_{random})'
      in: header
      name: X-API-Key

````