API overview - Totalis

The Hyperliquid API is REST over HTTPS with JSON bodies, in snake_case, plus a WebSocket for account and maker updates and a market data socket for public prices. It is separate from the Solana API and has its own keys.

Base URL

https://hip4-api.totalis.trade

Surface	URL
REST	`https://hip4-api.totalis.trade/v1/...`
WebSocket	`wss://hip4-api.totalis.trade/v1/stream`
Market data	`wss://hip4-api.totalis.trade/v1/market-stream`

Every route runs on HyperEVM, chain ID 999.

Try it without a key

Market reads are public:

curl "https://hip4-api.totalis.trade/v1/markets?limit=3"

Authentication

Send your API key as a bearer token on every authenticated request:

Authorization: Bearer ttk_v1_prd_...

Each key acts for one account, yours or a maker’s, and holds scopes. Calls that move funds also carry a wallet signature in the body. Keys, scopes and signing are on Authentication & signing.

Requests

A command POST sends an Idempotency-Key header, a new lowercase UUIDv7 per command. A few routes take none.
Amounts are strings in USDC atomic units (6 decimals): "25000000" is 25 USDC. Never a JSON number.
Large identifiers (outcome_id, chain, block) are decimal strings.

The full encoding table and the idempotency exceptions are on Errors, pagination & limits.

Responses

A successful response is the resource itself, with no envelope. A 204 has no body. A list returns its rows in items and pages by cursor:

{ "items": [], "next_cursor": "eyJnIjo2NDM3LCJhIjoxMjYwLCJrIjoibWFya2V0In0", "has_more": true }

Send next_cursor back as ?cursor= until has_more is false. Cursors are opaque, so do not parse or build them. Page size rules are on Pagination.

Errors

Every HTTP error has the same shape:

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The stake must be a positive integer.",
    "retry": "NEVER",
    "request_id": "0198f0a2-5c1e-7b3a-9f10-2d4c6e8a0b12",
    "field_violations": [{ "field": "/stake", "code": "INVALID" }]
  }
}

Branch on error.code, never on error.message, and follow retry. A WebSocket closes with a close code and the error code as its reason instead. Every code is on Errors.

Rate limits

Over quota returns 429 RATE_LIMITED with Retry-After in seconds. The per-route limits are on Rate limits.

Endpoints by task

Taking

Step	Endpoint or event
Find markets	`GET /v1/markets`, `GET /v1/markets/{outcome_id}`
Check your balance	`GET /v1/me/balances`
Follow your account	`GET /v1/stream`, `account` subscription
Ask for quotes	`POST /v1/rfqs`, then `QUOTE_CREATED`
Accept one	`POST /v1/quotes/{quote_id}/accept`
Recover a lost accept	`GET /v1/quotes/{quote_id}/acceptance`
Stop asking	`POST /v1/rfqs/{rfq_id}/cancel`
Follow the fill	`OPERATION_UPDATED`, or `GET /v1/me/operations/{operation_id}`
Read positions	`GET /v1/me/positions`, `GET /v1/me/positions/{position_id}`
Cash out	`POST /v1/me/positions/{position_id}/cashout`, then accept a quote
Withdraw	`POST /v1/me/withdrawals`

Making

Step	Endpoint or event
Check capital	`GET /v1/makers/{maker_id}/capital`
Receive RFQs	`GET /v1/stream`, `maker` subscription, `RFQ_CREATED`
Quote, or replace a quote	`POST /v1/rfqs/{rfq_id}/quotes`
Pull a quote	`DELETE /v1/quotes/{quote_id}`
Receive acceptances	`QUOTE_ACCEPTED`. Nothing is filled until you confirm.
Confirm or decline	`POST /v1/quotes/{quote_id}/confirm`
Reconcile after a restart	`GET /v1/makers/{maker_id}/acceptances`
Read backed positions	`GET /v1/me/positions` with a maker key
Lower your collateral	`POST /v1/makers/{maker_id}/collateral-reductions`

The full maker loop is on Market making.

Endpoint groups

Markets

HIP-4 markets, their sides and price history. Public.

RFQs & Quotes

Request quotes and accept one as a taker, or quote and confirm as a maker.

Positions

Positions you hold or your maker backs, and cash-outs.

Account

Identity, balances, activity, operations and withdrawals.

Makers

Maker capital and collateral.

Deployment

The chain, vault and fees every signature binds to.

WebSocket

Account and maker updates, resumable from a cursor.

Errors

Every code, limit and rate limit, and which errors to retry.

​Base URL

​Try it without a key

​Authentication

​Requests

​Responses

​Errors

​Rate limits

​Endpoints by task

​Taking

​Making

​Endpoint groups

Markets

RFQs & Quotes

Positions

Account

Makers

Deployment

WebSocket

Errors

Base URL

Try it without a key

Authentication

Requests

Responses

Errors

Rate limits

Endpoints by task

Taking

Making

Endpoint groups