TaifoonTAIFOON
Taifoon · Docs
Quickstart · Trader

Trade the venue in five steps

The venue is open today, no signup. You attribute orders with a string and place them straight into the matcher. This walk-through is paper end-to-end; promotion to live settlement is Phase B.

1. Open the venue

Browse to https://trade.taifoon.dev/clob/BTC-PERP. The single-viewport layout puts the order book ladder centre, the recent fills to the right, and the order entry panel to the left. The top-right wallet pill shows your local trader id (e.g. anon-human-93c642af15a2).

Note
Switch the actor pill at the top (TRADER / MAKER / BOT / LLM) to scope the UI. As a trader, you only see your own orders in OPEN ORDERS.

2. Inspect the order book

Sanity-check that the matcher is alive. The depth endpoint returns the same data the UI ladder renders.

curl -s https://api.taifoon.dev/book/v1/depth/BTC-PERP | jq '{bids:.bids[:3], asks:.asks[:3]}'

Mid-price comes from the book itself (Phase A); the mark price column in the UI is currently the book midpoint too. Oracle-backed mark lands in Phase B.

3. Place a paper limit via the UI

  • Set side: BUY.
  • Type: LIMIT.
  • Qty: 0.01 BTC.
  • Price: 1% below the current best bid.
  • Hit PLACE.

The order travels to POST /book/v1/orders with your local trader id stamped asattribution. You should see the row appear in OPEN ORDERS within ~200ms (the UI polls every 500ms).

4. Watch fills

If the matcher crosses your order (it won't at 1% below the bid), it shows up in RECENT FILLS. Any market order you place at-the-money willcross. To see other people's prints:

curl -s 'https://api.taifoon.dev/book/v1/fills?market=BTC-PERP&limit=5' | jq '.fills[]'

5. (Optional) Place the same order via curl

curl -s -X POST https://api.taifoon.dev/book/v1/orders \
  -H 'Content-Type: application/json' \
  -d '{
    "market": "BTC-PERP",
    "side": "buy",
    "qty": "0.01",
    "price": "75000",
    "tif": "gtc",
    "attribution": "trader-demo"
  }' | jq

The response includes order_id, t_placed, and (during a warp session) aspeed_x field. Cancel by id with DELETE /book/v1/orders/<order_id> or bulk cancel by attribution with DELETE /book/v1/orders?attribution=trader-demo.

Heads up
There is no auth today. Anyone can place an order with any attribution string. Wallet signing (EIP-712) and API-key issuance land in Phase B — see /clob/docs/api/authentication.