-
Notifications
You must be signed in to change notification settings - Fork 1
Description
Summary
We need a new Seren publisher, hyperliquid-official, backed by the official Hyperliquid public API rather than QuickNode.
This is for a public, market-level Hyperliquid signal service that runs hourly scans and persists funding/liquidity signals. It is not a wallet-specific or user-decisioning service.
Why this is needed
The current seren-hyperliquid publisher is not sufficient for this use case.
Observed behavior from live checks:
seren-hyperliquidis currently backed by QuickNode.- working calls go through
POST /info, notGET /info. - required market-data methods such as
l2Bookare not available through the current publisher path.
QuickNode's own per-method docs also say several required Hyperliquid Info methods are not supported there.
Required publisher
Please register a new publisher with:
- slug:
hyperliquid-official - upstream: official Hyperliquid public API
- surface:
POST /info
Required methods for v1
At minimum, the new publisher needs to support these type payloads through POST /info:
metaallMidsl2BookfundingHistorypredictedFundingsmetaAndAssetCtxs
These are the methods needed for the planned public service:
- market metadata / universe context
- mid prices
- order book / liquidity checks
- historical funding
- predicted funding
- asset context for signal generation
Explicitly not required for this request
This ticket is not blocked on user-scoped methods like:
userFunding- account state / wallet state methods
Those can be handled separately if we decide to build user-specific services later.
Acceptance criteria
- A new publisher
hyperliquid-officialexists in Seren. - The publisher exposes
POST /infoand accepts Hyperliquid Info request bodies directly. - Each required
typepayload above is verified end-to-end through the publisher. - Publisher docs/examples show the request format for these methods.
- The publisher is suitable for hourly public market-data scans and persistence jobs.
References
Official Hyperliquid docs:
- Info endpoint: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
- Perpetuals methods: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals
QuickNode docs showing unsupported methods:
- allMids: https://www.quicknode.com/docs/hyperliquid/info-endpoints/allMids
- l2Book: https://www.quicknode.com/docs/hyperliquid/info-endpoints/l2Book
- fundingHistory: https://www.quicknode.com/docs/hyperliquid/info-endpoints/fundingHistory
- predictedFundings: https://www.quicknode.com/docs/hyperliquid/info-endpoints/predictedFundings
- metaAndAssetCtxs: https://www.quicknode.com/docs/hyperliquid/info-endpoints/metaAndAssetCtxs