Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Get a challenge

POST /v1/session/challenge
Private reads (your account, your orders, your withdrawals, your WebSocket account channel) need a session. You get one by signing a challenge with your account's key, or with a signing key you registered on chain.
Sessions are for reading. Orders, cancels and withdrawals carry their own signatures and need none.
body addressstringrequired
The account's address, 0x-prefixed.
Response
{ "challenge": "q3V0...", "message": "testnet.hv.exchange wants you to sign in with your Ethereum account:\n0xAb58…aeC9B\n\nSign in to Hypervolic. This signature only opens a session to view your account: it moves no funds and places no orders.\n\nURI: https://testnet.hv.exchange\nVersion: 1\nChain ID: 84532\nNonce: …\nIssued At: …\nExpiration Time: …", "expires": 1793500000 }
message is a Sign-In with Ethereum (EIP-4361) message, so a wallet shows it as a sign-in rather than an opaque string. It names the exchange's own site and chain, whatever host the request came through. The challenge is good for 5 minutes (expires is unix seconds).
A challenge and a sign-in are charged to your IP's request rate, and a failed sign-in to its refusal budget (see Rate limits).