Introduction

The Conviction Public API provides programmatic access to prediction market data on BNB Smart Chain (BSC). 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/slug/:slug/orderbook`	Get current orderbook by market slug
`GET /v1/markets/:id/prices-history`	Get historical price data for a specific outcome
`GET /v1/markets/slug/:slug/prices-history`	Get historical price data by market slug

#Data Conventions

Prices are represented as decimal strings (e.g., "0.670" = 67% probability)
Volumes are in USDT 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

Was this page helpful?