REST API

API service for querying user state information from Hyperliquid. All endpoints require Bearer token authentication.

Authentication

All API requests must include an authorization header with a Bearer token.

Authorization: Bearer YOUR_API_KEY

Mainnet URL

https://api.hydromancer.xyz

Testnet URL

Everything is the same except when its described in the docs of the specific endpoint

https://api-testnet.hydromancer.xyz

Base Endpoint

POST /info

All requests use the same endpoint with different type values to specify the operation.

Error responses

Error responses

400 Bad Request

{
  "error": "Invalid Ethereum address: 0xinvalid"
}

401 Unauthorized

{
  "error": "Invalid API key"
}

502 Bad Gateway

{
  "error": "Timeout error"
}

500 Internal Server Error

{
  "error": "An internal error occurred"
}