Live Market Feed

A team-maintained convenience feed for active Events markets on Hyperliquid.

The team maintains the read-only HIP-4 Markets repository. When run for txyz, it polls Hyperliquid’s public /info endpoint and exposes a normalized JSON view of currently listed two-sided outcome markets.

Run locally

After cloning the repository and installing its documented Python dependencies, start the feed with:

uv run hip4-markets --deployer txyz --network mainnet

The local server listens on http://127.0.0.1:8080 by default. For example:

curl http://127.0.0.1:8080/markets
curl http://127.0.0.1:8080/health

Endpoints

Endpoint	Response
GET /markets	All markets in the latest successful poll. Optional ?kind= filters may be supplied.
GET /markets/<coin>	One market, looked up by either side’s coin identifier. Omit the leading # from the URL path.
GET /health	Polling status, last update information, errors, and market counts.

These paths are served by the local or self-hosted process. The Codeberg repository does not itself provide a hosted API.

The feed is a convenience resource, not a canonical market registry or settlement source. Hyperliquid’s onchain state and the terms of the applicable market remain authoritative. Clients should tolerate missing optional fields, stale data reported by /health, and markets disappearing from the feed after onchain settlement.

No uptime, permanence, or service-level commitment is made for this feed.