Skip to content

Register new hyperliquid-official publisher for official Hyperliquid /info endpoints #153

@taariq

Description

@taariq

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-hyperliquid is currently backed by QuickNode.
  • working calls go through POST /info, not GET /info.
  • required market-data methods such as l2Book are 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:

  • meta
  • allMids
  • l2Book
  • fundingHistory
  • predictedFundings
  • metaAndAssetCtxs

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-official exists in Seren.
  • The publisher exposes POST /info and accepts Hyperliquid Info request bodies directly.
  • Each required type payload 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:

QuickNode docs showing unsupported methods:

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions