> ## 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 Ghost Trader Status
> Live TAO Ghost Trader status -- current trade, latest verdict, regime, RSI, EMA, Kraken liquidity floor (Gate 0), risk flags, 6 specialist agent votes
This endpoint is public -- no API key required. Powers the TAO panel
on aioka.io/live. (Sprint TAO -- third multi-asset expansion after ETH and SOL.)
**Tier:** Public
**Cache:** None -- always live
**Read-only:** Never writes to any trading table.
> TAO council uses 6 specialist agents unique to Bittensor: SUBNET\_ORACLE,
> MACRO\_SAGE, AI\_NARRATIVE, MOMENTUM\_HUNTER, LIQUIDITY\_GUARDIAN, RISK\_WARDEN.
> These replace the generic BTC/ETH council personas and reflect TAO-specific
> on-chain and AI-sector intelligence.
> ⚠️ This is a paper-trading status snapshot, not financial advice.
> AIOKA TAO Ghost Trader is a simulation. Never make real financial
> decisions based solely on this signal.
## Response Fields
TAO status mirrors the SOL schema but replaces `networkHealth`/`networkTps`
with `liquidityStatus`/`liquidityDepthUsd` (the Kraken order-book probe used
by Gate 0). TAO evaluates **8 entry gates** -- Gate 0 is a Kraken liquidity
floor rather than a network health check.
### Top-level
| Field | Type | Meaning |
| ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ |
| `status` | string | `"WAITING"` (no open TAO trade) or `"IN_TRADE"` |
| `currentTrade` | object \| null | Open TAO trade details when `status == "IN_TRADE"` |
| `latestVerdict` | object \| null | Latest TAO council verdict with agent votes and risk flags |
| `regime` | string \| null | Market regime (e.g. `ACCUMULATION`) |
| `rsi1h` | number \| null | TAO 1H RSI |
| `ema200` | number \| null | TAO 1H EMA(200) |
| `taoPrice` | number \| null | Latest TAO/USD |
| `networkHealth` | string | Always `"HEALTHY"` -- TAO has no network outage gate. Included for multi-asset dashboard compatibility. |
| `liquidityStatus` | string | **TAO-specific (Gate 0).** `"SUFFICIENT"` / `"INSUFFICIENT"` / `"UNKNOWN"`. `INSUFFICIENT` blocks ALL TAO entries. |
| `liquidityDepthUsd` | number \| null | **TAO-specific.** Kraken order-book depth (USD) within ±0.5% of mid-price. `null` when probe fails. |
| `paperTradesValidated` | int | Count of closed validated TAO paper trades (0 -- 10 milestone before live capital). |
| `paperMode` | bool | `true` while TAO is in paper mode. Becomes `false` after 10 validated paper closes and explicit K-1 sign-off. |
| `generatedAt` | string | Response timestamp (ISO 8601) |
| `gates` | object | Per-gate boolean evaluator (8 gates for TAO) |
### currentTrade fields (when `status == "IN_TRADE"`)
| Field | Type | Meaning |
| -------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `entryPrice` | number | TAO entry price (USD) |
| `sizeTao` | number | Position size in TAO |
| `pnlUsd` | number | Live P\&L in USD |
| `pnlPct` | number | Live P\&L as % of position cost |
| `tp1Hit` | bool | Whether TP1 partial close has fired |
| `stopLoss` | number | Stop loss price (USD). Reads from `tao_ghost_trades.stop_loss`; falls back to `entryPrice × 0.97` (-3.0% floor) when NULL |
| `tp1Target` | number | TP1 target price = `entryPrice × 1.02` (+2.0%) |
| `tp2Target` | number | TP2 target price = `entryPrice × 1.045` (+4.5%) |
| `hwm` | number \| null | High-water mark for TSL ratchet. Persisted to DB on every ratchet. |
| `liquidityAtEntry` | number \| null | **TAO-specific.** Kraken depth (USD) at entry time -- audit field. |
| `taoBtcRatioAtEntry` | number \| null | **TAO-specific.** TAO/BTC ratio at entry -- momentum audit. |
| `daysSinceHalving` | int \| null | **TAO-specific.** Days elapsed since the 2025-12-01 TAO emission halving. |
### latestVerdict fields
| Field | Type | Meaning |
| -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ruling` | string | `STRONG_BUY` / `BUY` / `ACCUMULATE` / `HOLD` / `REDUCE` / `SELL` / `STRONG_SELL` / `AVOID` |
| `confidence` | number | 0.0 -- 1.0. Entry requires confidence ≥ 0.72 (TAO council threshold). |
| `riskFlags` | array | Active risk flags. Possible values: `LIQUIDITY_RISK`, `MANIPULATION_RISK`, `INSUFFICIENT_DATA`, `ETF_EVENT_WINDOW`, `CENTRALIZED_AI_OVERHANG`, `INSTITUTIONAL_REBAL` |
| `agentVotes` | object | Per-agent verdict from all 6 TAO specialist agents (see Specialist Agents section below) |
| `agentVotes.` | object | Each agent entry has `ruling` (string) and `confidence` (number 0.0 -- 1.0) |
| `createdAt` | string | ISO 8601 timestamp of verdict |
### gates fields
| Field | Type | Meaning |
| ----------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gates.liquidity` | bool | **TAO-specific Gate 0.** `true` when Kraken depth ≥ \$50,000 AND 1H volume ≥ 1.5× 24H average |
| `gates.liquidityStatus` | string | Liquidity label mirrored into the gates block (`"SUFFICIENT"` / `"INSUFFICIENT"`) |
| `gates.judiciary` | bool | Judiciary ruling is bullish |
| `gates.council` | bool | TAO council bullish AND confidence ≥ 72% |
| `gates.emaProximity` | bool | Price within EMA 200 sweet-spot band (+0.3% to +3.5%) |
| `gates.regime` | bool | Regime favorable for TAO entries |
| `gates.quality` | bool | Real composite entry quality score ≥ 65.0 (mirrors trader-side `calculate_entry_quality()` byte-for-byte) |
| `gates.momentum` | bool | RSI(1H) ≥ 45 |
| `gates.session` | bool | Not in weekend low-liquidity block (Fri 22:00 -- Sun 06:00 Europe/Prague). Asian-early block (00:00 -- 04:00) is overridden when liquidity is SUFFICIENT. |
| `gates.gatesMet` | int | Count of gates currently passing (0 -- 8) |
| `gates.trigger` | string \| null | Human-readable reason the next gate is failing, or `null` when all 8 pass |
```bash curl theme={null}
curl https://api.aioka.io/v1/tao/status
```
```json 200 theme={null}
{
"status": "WAITING",
"currentTrade": null,
"latestVerdict": {
"ruling": "ACCUMULATE",
"confidence": 0.74,
"riskFlags": [],
"agentVotes": {
"SUBNET_ORACLE": {"ruling": "BUY", "confidence": 0.78},
"MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.71},
"AI_NARRATIVE": {"ruling": "BUY", "confidence": 0.82},
"MOMENTUM_HUNTER": {"ruling": "ACCUMULATE", "confidence": 0.69},
"LIQUIDITY_GUARDIAN": {"ruling": "ACCUMULATE", "confidence": 0.73},
"RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.61}
},
"createdAt": "2026-05-06T08:30:00+00:00"
},
"regime": "ACCUMULATION",
"rsi1h": 54.2,
"ema200": 281.30,
"taoPrice": 289.40,
"networkHealth": "HEALTHY",
"liquidityStatus": "SUFFICIENT",
"liquidityDepthUsd": 82500.0,
"paperTradesValidated": 0,
"paperMode": true,
"generatedAt": "2026-05-06T10:30:00+00:00",
"gates": {
"liquidity": true,
"liquidityStatus": "SUFFICIENT",
"judiciary": true,
"council": true,
"emaProximity": true,
"regime": true,
"quality": true,
"momentum": true,
"session": true,
"gatesMet": 8,
"trigger": null
}
}
```
## TAO-Specific: Gate 0 (Liquidity Floor)
TAO is the first AIOKA asset with a dedicated Kraken order-book liquidity
gate. The status endpoint probes the Kraken `Depth` and `OHLC` endpoints
every 60 seconds and exposes the result via `liquidityStatus` and
`liquidityDepthUsd`.
The gate fires on two conditions, both of which must be true:
1. **Depth floor** -- Kraken bid + ask depth within ±0.5% of mid-price ≥ \$50,000 USD.
2. **Volume surge** -- Last 1H volume ≥ 1.5× the 24H hourly average (confirms institutional participation, filters manipulation signals).
When `liquidityStatus == "INSUFFICIENT"`, ALL TAO entries are blocked
regardless of judiciary, council, or any other gate. This is by design and
mirrors the trader-side K-1-equivalent rule -- Gate 0 must never be disabled.
This design reflects TAO's lower Kraken liquidity relative to BTC/ETH. An
entry during a thin order book risks high slippage, which is worse than
missing the trade entirely.
## Specialist Agents
TAO runs 6 custom specialist agents tuned to Bittensor-specific signals.
Each agent produces an independent ruling and confidence score. The Chief
Judge aggregates all 6 votes into the final verdict.
| Agent | Domain | Key Signals |
| -------------------- | --------------------------------- | -------------------------------------------------------------------------------------------- |
| `SUBNET_ORACLE` | On-chain Bittensor network | Subnet count growth, staking ratio, emission rate, validator Nakamoto coefficient |
| `MACRO_SAGE` | Global macro environment | DXY, US10Y yield, risk-on/off sentiment, Fed tone |
| `AI_NARRATIVE` | AI sector market sentiment | NVDA price action, BOTZ/IRBO ETF flows, GitHub activity on `opentensor/bittensor` |
| `MOMENTUM_HUNTER` | Price momentum + technicals | TAO/BTC ratio trend, RSI, EMA proximity, 4H/1D bias alignment |
| `LIQUIDITY_GUARDIAN` | Order-book and on-chain liquidity | Kraken depth, volume surge factor, stablecoin flows |
| `RISK_WARDEN` | Risk and tail-event detection | Concentration risk, manipulation flags, ETF event windows, institutional rebalancing signals |
The `agentVotes` object in every verdict response maps each agent name
to its individual `ruling` and `confidence`. Disagreement between agents
is reflected in the final confidence score -- unanimous verdicts carry
the highest confidence.
## OpenAPI
````yaml GET /v1/tao/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/tao/status:
get:
tags:
- TAO Ghost Trader
summary: TAO Ghost Trader Status
description: |-
Returns the current state of the TAO Ghost Trader: open position (if
any), latest TAO council verdict + risk flags, market regime, TAO price,
RSI(1H), EMA 200, and TAO order-book liquidity status (Gate 0).
**Tier:** Free (no auth)
**Cache:** None -- always live
**Use:** aioka.io/live TAO panel
Read-only -- never writes to any trading table.
operationId: get_tao_status_v1_tao_status_get
responses:
'200':
description: Live TAO Ghost Trader status
content:
application/json:
schema:
$ref: '#/components/schemas/TAOStatusResponse'
security: []
components:
schemas:
TAOStatusResponse:
properties:
status:
type: string
title: Status
currentTrade:
anyOf:
- $ref: '#/components/schemas/TAOStatusCurrentTrade'
- type: 'null'
latestVerdict:
anyOf:
- $ref: '#/components/schemas/TAOStatusVerdict'
- type: 'null'
regime:
anyOf:
- type: string
- type: 'null'
title: Regime
rsi1h:
anyOf:
- type: number
- type: 'null'
title: Rsi1H
ema200:
anyOf:
- type: number
- type: 'null'
title: Ema200
taoPrice:
anyOf:
- type: number
- type: 'null'
title: Taoprice
networkHealth:
type: string
title: Networkhealth
description: >-
TAO has no network outage gate; always 'HEALTHY' for compatibility
with the multi-asset dashboard.
default: HEALTHY
liquidityStatus:
type: string
title: Liquiditystatus
default: UNKNOWN
liquidityDepthUsd:
anyOf:
- type: number
- type: 'null'
title: Liquiditydepthusd
paperTradesValidated:
type: integer
title: Papertradesvalidated
description: Closed validated TAO paper trades (0-10 milestone).
default: 0
paperMode:
type: boolean
title: Papermode
description: TAO_PAPER_MODE flag; live unlocked after 10 validated paper closes.
default: true
generatedAt:
type: string
format: date-time
title: Generatedat
gates:
$ref: '#/components/schemas/TaoGates'
type: object
required:
- status
- generatedAt
title: TAOStatusResponse
example:
ema200: 261.3
gates:
council: true
emaProximity: true
gatesMet: 8
judiciary: true
liquidity: true
liquidityStatus: SUFFICIENT
momentum: true
quality: true
regime: true
session: true
generatedAt: '2026-05-05T10:30:00+00:00'
latestVerdict:
agentVotes: {}
confidence: 0.74
createdAt: '2026-05-05T10:15:00+00:00'
riskFlags: []
ruling: ACCUMULATE
liquidityDepthUsd: 75200
liquidityStatus: SUFFICIENT
networkHealth: HEALTHY
paperMode: true
paperTradesValidated: 0
regime: ACCUMULATION
rsi1h: 55.4
status: WAITING
taoPrice: 268.4
TAOStatusCurrentTrade:
properties:
entryPrice:
type: number
title: Entryprice
sizeTao:
type: number
title: Sizetao
pnlUsd:
type: number
title: Pnlusd
pnlPct:
type: number
title: Pnlpct
tp1Hit:
type: boolean
title: Tp1Hit
stopLoss:
type: number
title: Stoploss
tp1Target:
type: number
title: Tp1Target
tp2Target:
type: number
title: Tp2Target
hwm:
anyOf:
- type: number
- type: 'null'
title: Hwm
liquidityAtEntry:
anyOf:
- type: number
- type: 'null'
title: Liquidityatentry
taoBtcRatioAtEntry:
anyOf:
- type: number
- type: 'null'
title: Taobtcratioatentry
daysSinceHalving:
anyOf:
- type: integer
- type: 'null'
title: Dayssincehalving
type: object
required:
- entryPrice
- sizeTao
- pnlUsd
- pnlPct
- tp1Hit
- stopLoss
- tp1Target
- tp2Target
title: TAOStatusCurrentTrade
TAOStatusVerdict:
properties:
ruling:
type: string
title: Ruling
confidence:
type: number
title: Confidence
riskFlags:
items:
type: string
type: array
title: Riskflags
agentVotes:
type: object
title: Agentvotes
createdAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Createdat
type: object
required:
- ruling
- confidence
title: TAOStatusVerdict
TaoGates:
properties:
liquidity:
type: boolean
title: Liquidity
default: false
liquidityStatus:
type: string
title: Liquiditystatus
default: UNKNOWN
judiciary:
type: boolean
title: Judiciary
default: false
council:
type: boolean
title: Council
default: false
emaProximity:
type: boolean
title: Emaproximity
default: false
regime:
type: boolean
title: Regime
default: false
quality:
type: boolean
title: Quality
default: false
momentum:
type: boolean
title: Momentum
default: false
session:
type: boolean
title: Session
default: false
gatesMet:
type: integer
title: Gatesmet
default: 0
trigger:
anyOf:
- type: string
- type: 'null'
title: Trigger
type: object
title: TaoGates
````