Core concepts
Identifiers
Choose the correct identifiers for discovery, trading, charts, and durable cross-venue references.
| Job | Id | Not this |
|---|---|---|
| Join venues for this page | Anchor id from unfiltered GET /venue-events | aggKey, title |
| Store a venue event or market in a watchlist | (venue, externalIdentifier), then re-resolve | The anchor id. Clusters merge |
| Fetch one contract when the key converges | aggKey | Elections, dated markets, null keys |
| Trade, chart, orderbook socket | venueMarketOutcomeId | venueMarketId |
| Midpoints and arb | venueMarketId | Outcome id |
| Durable partner user | HMAC externalId | Venue externalIdentifier |
Filtering venue plus externalIdentifier returns that member, not the anchor. List responses return one row per matched cluster, and for a matched event id is the anchor. Re-resolve it. Do not store it as a permanent key.
Hyperliquid HIP-4 books are also split by deployerVenue. See Hyperliquid deployers.
const page = await client.getVenueEvents({ limit: 1 });
const event = page.data[0];
// event.id, event.externalIdentifier, event.aggKey, event.matchedVenueEventsFull shape on List venue events. Markets for an event are List venue markets. One contract is Look up venue market outcomes by external identifier. aggKey as a filter is aggKey.