Market Data
Market data integrations should treat Pariflow data as time-sensitive and state-dependent.
Market data is useful only when paired with state, timestamps, outcome labels, and resolution context. A stale price without state can lead to a poor user experience or rejected order flow.
Common data concepts
- Market ID: Stable identifier used by Pariflow for an event or market.
- Outcome ID: Identifier for a specific tradeable outcome.
- Displayed price: Probability-style quote shown in the product.
- Order book context: Available depth or quote context when available.
- Market state: Open, live, suspended, closed, pending settlement, or settled.
- Updated time: Timestamp indicating the last known update.
Data freshness and state handling
| Data point | Why it matters |
|---|---|
| Market state | Determines whether the market can be traded, reviewed, or only shown historically. |
| Outcome label | Prevents confusing YES/NO, team names, handicaps, totals, or game-level markets. |
| Updated time | Helps detect stale snapshots and live feed delay. |
| Quote context | Helps separate compact display prices from executable previews. |
| Resolution state | Indicates whether final P&L and balance accounting should be complete. |
Integration guidance
Consumers should:
- Check market state before treating prices as tradeable.
- Handle missing or stale prices.
- Avoid assuming compact display prices are executable for all sizes.
- Re-request quote context before submitting a trade.
- Preserve timestamps for auditability.
- Treat newly added response fields as backward-compatible additions.
- Avoid retrying failed trade-related requests without checking current market state first.
Safe handling examples
| Situation | Recommended behavior |
|---|---|
| Price exists but market state is closed | Display historical or portfolio context, but do not allow new orders. |
| Outcome label changed or disappeared | Refresh market metadata before showing trade controls. |
| Timestamp is older than expected for a live event | Show stale-data UI or request a fresh snapshot. |
| Quote context is unavailable | Disable order submission or require a fresh preview. |
| Settlement state is pending | Show estimated final P&L separately from credited balance. |