Introduction

The Conviction Public API provides programmatic access to prediction market data on ZetaChain. Use it to retrieve market information, probabilities, orderbook data, and price history.

Base URL

All API requests should be made to:

https://api.conviction.bet/v1

Response Format

All endpoints return JSON responses. Successful responses include the data directly:

{
  "markets": [...],
  "total": 42,
  "limit": 20,
  "offset": 0
}

Error responses return a standard error format:

{
  "statusCode": 404,
  "message": "Market not found",
  "error": "Not Found"
}

Available Endpoints

Endpoint	Description
`GET /v1/markets`	List markets with filtering and pagination
`GET /v1/markets/:id`	Get detailed market information by UUID
`GET /v1/markets/slug/:slug`	Get detailed market information by slug
`GET /v1/markets/:id/orderbook`	Get current orderbook for a specific outcome
`GET /v1/markets/:id/prices-history`	Get historical price data for a specific outcome

Data Conventions

Prices are represented as decimal strings (e.g., "0.670" = 67% probability)
Volumes are in USDC with 2 decimal places (e.g., "1250.00")
Timestamps are in ISO 8601 format (e.g., "2026-01-15T00:00:00Z")
Pagination uses limit and offset parameters