API introduction

Conviction's public interface is REST. Every public route begins with /v1/.

#Base URL

https://api.conviction.bet

Every example in this document is based on this URL.

#Path prefix

All public routes start with /v1/....

GET https://api.conviction.bet/v1/markets?status=ACTIVE

Endpoints that don't start with /v1/ (user authentication, deposits, admin, webhooks, etc.) are not exposed externally.

#What this covers

This reference covers two things for developers, bots, and market makers.

• Public market data (no auth) — market list/detail, order book, and price history. Anyone can call these. See REST → Markets.
• Programmatic order signing — the EIP-712 order structure for bots and market makers that want to post orders directly without the UI. See EIP-712 order signing.

Regular users don't need this reference — the UI handles the whole process.

#Request format

• All bodies are JSON (Content-Type: application/json).
• Timestamps are ISO-8601 or unix seconds (each endpoint specifies which).

#Response format

Successful responses are JSON per each endpoint's spec. Failure responses use the standard error envelope.

#Next

• Authentication — public endpoints need no authentication
• Errors — the response envelope and validation message arrays
• Pagination — common to all list endpoints
• REST → Markets — the public market-data endpoints
• EIP-712 order signing — for bots and market makers building orders programmatically