{"uid":"cap_KEd6V1YKzvunqJ3gGM_Pg","slug":"taifoon-trading-record-api-c75c869d","name":"Taifoon Trading Record API","description":"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).","url":"https://coord.taifoon.dev/v1/trading/record?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BSRm4jfBMzy6YAwynbES5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Hyperliquid trader performance audit","prompt":"Get my full realized trading record from Hyperliquid, including my fills, PnL, fees, win/loss breakdown, and max drawdown so I can review how I've been performing."},{"title":"Paper trading session review","prompt":"Fetch my paper trading record on the Taifoon CLOB venue — I want to see how many wins and losses I had, my realized PnL, and a digest of my fills so I can verify the data."},{"title":"Round trip and drawdown analysis","prompt":"Pull my trading record and show me all my round trips, my edge vs null baseline, and what my maximum drawdown was across all my fills."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T00:40:40.191Z","isFirstParty":false,"canonicalSlug":"taifoon-trading-record-api-c75c869d"}