← All APIs

Hyperliquid

byAPI3FreeAirnode v0.1.0

Hyperliquid is a perpetuals and spot exchange running on its own L1. This Airnode wraps its read API: perp and spot market metadata, mid prices, order books, candles, funding, recent trades, validator and vault state, borrow and lend reserves, and per-address account state. It wraps none of the write side, so no operation here can place, cancel or transfer anything.

Hyperliquid serves all of this on one path and routes on a type field in the request body. This document declares one operation per type and sends that field itself, so a caller names the operation and never the type. An operation this document does not declare is refused before Hyperliquid is called.

Prices, books and account state are what Hyperliquid published at the moment they were read, so an attestation over one is provenance. A closed range of candles, funding or fills answers the same every time, so an attestation over one is reproducible as well. Documentation: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api

Every response carries an EIP-191 signature from the Airnode that served it, so the data can be attributed back to its source rather than trusted on reputation.

Interface

Served at https://airnode-hyperliquid.fly.dev/. The two requests below are everything the endpoint speaks, and each can be sent from this page. What comes back is verified right here in the browser.

GET /

Returns the machine-readable documentation this page is rendered from. Free, and everything an agent needs.

POST /

Names an operation and its parameters, performs it against the upstream API, and answers with the response and the attestation over it.

Verify the response

Every response is signed by the API that served it. Paste one to check it really came from this listing and was not altered along the way.