Skip to main content
Every layer of a response carries its own Oddpool ID. The four families name the four layers:

​
How they nest

An event lookup returns the whole tree in one payload:
  • Event (OPI): one real-world resolution, like a game, election, or Fed decision
    • Outcome (OPO): one named answer on the event
      • Venue listing (OPL): one venue’s tradeable side of that outcome, the ticker you trade
      • Entity (OPE): the team, person, or party the outcome refers to

​
Stability

Oddpool IDs are deterministic and stable for the lifetime of the underlying row. Once you resolve a venue ticker to an ID, the mapping doesn’t move. All four families are safe to cache indefinitely. Treat IDs as opaque strings. The formats above are documented so they’re recognizable in logs; resolve and store them rather than constructing or parsing them yourself.

​
URL encoding

OPE and OPO ids contain colons. Colons are URL-safe per RFC 3986, so they work directly in a path (/reference/v2/entities/OPE:TEAM:LOS-ANGELES-LAKERS). Clients that URL-encode them may use OPE%3ATEAM%3ALOS-ANGELES-LAKERS equivalently.