Bitpont Developers
For business ↗Request partner access →Request higher API limits

Integrate / API 1.27

Hyperliquid API | Spot, HIP-3, Native Perps and Order Drafts

Use exact Hyperliquid market IDs to read depth, choose an order type, prepare an unsigned handoff and reconcile the outcome.

Start with the exact market

Search hyperliquid.directory by symbol, pair or protocol identity. Select the row with the intended base token, quote token, kind and venue. Use the returned market key and canonical workspace. The WOW / USDC spot example has protocol coin @109 and market key spot:10109. A base token index and a market key identify different objects.

Server-side JavaScript
import {BitpontClient} from './bitpont-client.mjs';
const client = new BitpontClient({publicAccess:true});
const found = await client.read('hyperliquid.directory',{q:'WOW',kind:'spot'});
for (const m of found.data.items) console.log(m.market,m.coin,m.path);

Read the book and compare prices

Use viewHyperliquidSpot or viewHyperliquidVenue for the mark, depth and candles in a single metered request. Supply the deployer name for HIP-3. Depth estimates use one observed book, the selected side and the price tolerance. A reference mark, a last candle and the best available ask can differ. Preserve the venue time and show missing or delayed data explicitly.

Prepare and open a trade ticket

Call hyperliquidOrderDraft with kind, market, side, type and decimal size. Add price and timeInForce for a limit, trigger for a protective order, or minutes for a TWAP. Gtc rests until cancellation, Ioc cancels the remaining size immediately, and Alo is post only. Open the returned reviewUrl. Size and order options are filled in for the selected market. The wallet owner checks available balance, account state, fees, eligibility and the current price bound before signing.

Read account activity and recover

Account tools expose order status, funding and fills, wallet trading permissions, TWAP slices and withdrawal proof. For time-based history hold endTime fixed, pass nextStartTime and deduplicate overlap. Stop when the response reports a saturated timestamp. Handle source confirmation and destination delivery separately for withdrawals.

Check venue and wallet support

Spot supports market and limit orders. USDC-quoted spot also supports eligible TWAPs. On supported perpetual markets protective orders are reduce only. Inspect the collateral, precision, account mode and live market status. Open the venue for owner authorization. Browse the complete market directory.