Perps widget & API

1. Embed a perpetual market

Live chart, order book and order ticket for one market. Traders connect and sign with their own wallet inside the widget; every order carries KAIRO's 0.03% builder fee, like on kairo.market.

<iframe src="https://kairo.market/embed/perps/BTC?theme=dark" title="KAIRO Perps" width="100%" height="900" style="border:0;border-radius:16px" allow="clipboard-write"></iframe>

Options: theme=dark|light, interval=1m|5m|15m|1h|4h|1d, layout=full|trade.

2. Public Perps API

Read-only JSON, no key needed, open to any website (CORS). Limit: 20 requests per second per client. Base URL: https://kairo.market/api/public/perps/v1

curl "https://kairo.market/api/public/perps/v1/markets/BTC"

• GET /marketsAll perp markets: mark/oracle price, funding, open interest, 24h volume
• GET /markets/:symbolOne market
• GET /candles/:symbol?interval=1h&limit=200OHLCV candles (1m, 5m, 15m, 1h, 4h, 1d; max 500)
• GET /account/:addressAccount summary and open positions
• GET /positions/:addressOpen positions
• GET /orders/:addressResting orders
• GET /fills/:addressLast 100 fills, including builder fee
• GET /builderKAIRO fee setup and whether it is active
• GET /approval/:addressWhether a wallet has approved the KAIRO fee

Responses are { ok: true, network, … } or { ok: false, error }. Trades never go through KAIRO's servers: use the @kairo/perps-sdk package to have the trader's own wallet sign orders sent straight to the venue.