Skip to main content
Totalis is a request-for-quote venue for Hyperliquid’s HIP-4 outcome markets. You pick one outcome (a single) or several (a parlay, one position that pays only if every leg wins). Market makers compete to quote it, you accept the best price with a wallet signature, and the position lives in the Totalis vault on HyperEVM until Totalis settles it and pays you. The app is hip4.totalis.trade, where parlays are called Combos. Everything the app does, the API does: open and cash out positions as a taker, or quote and back them as a market maker.

Quickstart

A key, your first reads and your first quotes.

API reference

Every endpoint and stream, with request and response shapes.

Market making

Quote RFQs, confirm fills and earn the spread.

​
Try it without an account

Market data is public. This call needs no key and no signup:
Market reads and Get deployment are public. Every account, trading and maker route needs an API key. Start with the Quickstart.

​
How it works

1

Ask for quotes

Create an RFQ with your legs and a stake. Every maker sees it at once.
2

Makers compete

Each maker answers with a payout: what the position pays if every leg wins. Quotes reach you live on the WebSocket.
3

Accept and fill

Sign the quote you want and accept it. The maker confirms within seconds. Totalis puts the trade on-chain and pays the gas.
4

Settle, or cash out first

When the markets resolve, Totalis settles the position and pays a win into your vault balance. Nothing to call or sign. To leave early, cash out: makers bid for the position.

​
Both sides of a trade

Your USDC sits in your Totalis wallet and the vault contract. The vault moves funds only with a signature from their owner. There is no deposit step and no claim step.

​
The essentials

​
Core concepts

Trading

Open a position, cash it out, and how settlement pays.

Maker collateral

What backs a quote, and how correlated positions lower it.

Real time

One socket for every RFQ, quote, fill and balance change.

Authentication & signing

Scoped keys and the signatures that move funds.

Limits

Fees, timings, sizes and rate limits.

Glossary

Every term and field name.

​
Need help?

Email the founders

Integration questions, SDK access and liquidity.

Errors

Every code, and which to retry.