Trade the venue in five steps
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).
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"
}' | jqThe 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.
/clob/docs/api/authentication.