ghost.closed Event

Overview

The ghost.closed event fires when a Ghost Trader position is fully closed on any supported asset. It includes the final P&L (net of any TP1 partial sell), the exit price, and a canonical close_reason label. Assets covered: BTC, ETH, SOL, TAO, GOLD Latency: Up to 30 seconds (poll-based dispatcher). Register via POST /v1/webhooks with "ghost.closed" in the events array.

{
  "url": "https://your-server.com/aioka-hook",
  "events": ["ghost.closed"]
}

Payload

{
  "event": "ghost.closed",
  "timestamp": "2026-05-08T16:45:00.123456Z",
  "data": {
    "trade_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "asset": "BTC",
    "entry_price": "96450.00",
    "exit_price": "97820.50",
    "pnl": "412.30",
    "close_reason": "TSL",
    "closed_at": "2026-05-08 16:44:55+00:00"
  }
}

Data Fields

string

UUID of the closed trade.

string

Asset symbol. One of: BTC, ETH, SOL, TAO, GOLD.

decimal

Entry price in USD.

decimal

Final exit price in USD.

decimal

Net P&L in USD, including TP1 partial sell profit if TP1 fired before close.

string

Canonical close reason. One of:

Value	Description
`STOP_LOSS`	Hard stop loss hit
`TP1`	Closed at TP1 level (rare — usually TSL fires after TP1)
`TP2`	Take Profit 2 hit
`TSL`	Trailing stop loss triggered
`BE_SHIELD`	Break-Even Shield triggered
`MANUAL`	Manually closed via Telegram command
`EXIT_SIGNAL`	Score-based exit signal
`REGIME_EXIT`	Market regime change forced exit
`CONVICTION_EXIT`	AI Council low-conviction exit
`FLASH_CRASH`	Emergency flash-crash exit

string

ISO 8601 timestamp when the trade closed.

Delivery

Delivered as a signed POST to your registered URL with:

X-AIOKA-Event: ghost.closed
X-AIOKA-Signature: sha256=<hex>
X-AIOKA-Timestamp: <unix>

See Register Webhook for signature verification.

Public

Free Tier

Basic Tier ($49/mo)

Webhooks (Basic+)

Pro Tier ($199/mo)

API Keys

Overview

Payload

Data Fields

Delivery

​Overview

​Subscribe

​Payload

​Data Fields

​Delivery

Overview

Subscribe

Payload

Data Fields

Delivery