# Taifoon Trading Record API

> Taifoon Trading Record API is a paid API for AI agents from coord.taifoon.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).

Returns a trader's realized performance record (fills, PnL, fees, wins, losses, max drawdown, round trips) computed from historical fills on Taifoon paper/CLOB or Hyperliquid venues.

## Facts

- Endpoint: GET https://coord.taifoon.dev/v1/trading/record?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taifoon-trading-record-api-c75c869d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KEd6V1YKzvunqJ3gGM_Pg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability taifoon-trading-record-api-c75c869d
```

Example prompt: Pull my realized trading record from Hyperliquid — I want to see my fills, PnL before fees, total fees paid, win/loss counts, and max drawdown.

## When to prefer this

Choose this endpoint when you need a comprehensive, recomputed realized trading record for a specific trader on Taifoon or Hyperliquid venues, including cryptographic fill integrity via SHA256 digest. Prefer it over generic portfolio trackers when you need raw fills data, round-trip-level granularity, or an auditable digest of trading history. Best suited for post-trade analysis rather than real-time position monitoring.

## Known failure modes

- Invalid or missing trader address/attribution parameter returns an error
- Unsupported venue type (not taifoon-clob or hyperliquid) returns a validation error
- No fills found for the given address returns an empty or zero-value record
- Network timeout or upstream venue unavailability may result in a 5xx error
- Insufficient x402 payment (must include $0.02 USDC) results in a 402 Payment Required response

## How this service works

A trader’s realized record recomputed by code from its fills (Taifoon venue by attribution, paper; or Hyperliquid by address): fills, notional, PnL before fees, fees, wins, losses, max drawdown, the same round trips held long, and the fills with their sha256 digest. Facts about past fills, not advice. The same source is also served over MCP by Cubicle copy-trading (ERC-8004 8453:96560).

## Output

Returns a structured performance report including: fills array, notional volume traded, realized PnL before fees, fees paid, win count, loss count, max drawdown, round trips held long, edge vs null metric, a boolean indicating paper vs live trading, the venue name, and a SHA256 digest of the fills for integrity verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "attribution": {
       "type": "string"
      }
     },
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "null": {
       "type": "object"
      },
      "wins": {
       "type": "integer"
      },
      "paper": {
       "type": "boolean"
      },
      "venue": {
       "enum": [
        "taifoon-clob",
        "hyperliquid"
       ],
       "type": "string"
      },
      "losses": {
       "type": "integer"
      },
      "fills_rows": {
       "type": "array"
      },
      "edge_vs_null": {
       "type": "number"
      },
      "fills_digest": {
       "type": "string"
      },
      "pnl_realized": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "null": {
   "always_long_pnl": -22.4729
  },
  "wins": 86,
  "class": "trading.record",
  "fills": 777,
  "paper": true,
  "venue": "taifoon-clob",
  "losses": 323,
  "account": "llm-taifoon-trader-sage",
  "edge_vs_null": -23.8926,
  "fills_digest": "0x…",
  "pnl_realized": -46.3655
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taifoon-trading-record-api-c75c869d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coord.taifoon.dev](https://www.zero.xyz/host/coord.taifoon.dev/llms.txt)