Skip to main content
Totalis lets you trade Hyperliquid’s HIP-4 outcome markets as singles or combos. A single is one outcome and trades on the HyperCore order book. A combo is several outcomes in one position that pays in full only if every leg wins. Combos are request-for-quote: market makers compete to quote yours, and you take the best price with one signature. Totalis holds the position in its vault on HyperEVM and pays you when the markets settle. You can also put Totalis in your own frontend, where your users trade with their own wallets: Build on Totalis.

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, RFQ reads and Get deployment are public. Every other account, trading and maker route needs an API key or a wallet session. 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 has 2 seconds to confirm or decline. 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 the funds’ owner. You do not need to deposit before you trade: an accept with signed funding pulls any shortfall from your wallet, and the SDK adds it for you. Winnings are claimed for you.

​
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

The terms the API uses.

​
Need help?

Email the founders

Partner access, SDK access, staging and liquidity.

Errors

Every code, and which to retry.

Service status

Live status of the app, API, streams, market data and settlement, with incidents and planned maintenance.