API Overview

The Orica API provides programmatic access to market data, trade history, and dispute information. It combines REST endpoints for querying data with WebSocket streams for real-time updates.

Base URL

All API requests are made to:

https://api.orica.markets

Features

REST API

Query markets, trades, disputes, and analytics with standard HTTP requests.

WebSocket

Subscribe to real-time price updates and trade activity feeds.

No Authentication

Public endpoints are open and require no API keys.

Rate Limited

Fair usage limits prevent abuse while allowing reasonable access.

Response Format

All responses are JSON. Successful responses return data directly:

{
  "address": "ABC123...",
  "question": "Will ETH flip BTC?",
  "status": "open",
  ...
}

Error responses include a message:

{
  "detail": "Market not found"
}

HTTP Status Codes

Code	Meaning
`200`	Success
`400`	Bad request (invalid parameters)
`404`	Resource not found
`429`	Rate limit exceeded
`500`	Server error

Pagination

List endpoints support pagination with limit and offset parameters:

curl "https://api.orica.markets/markets?limit=50&offset=100"

Parameter	Type	Default	Max
`limit`	integer	100	1000
`offset`	integer	0	-

Content Types

Request: application/json for POST/PUT bodies
Response: application/json for all responses
Compression: GZip compression for responses >1KB

CORS

The API supports Cross-Origin Resource Sharing (CORS) from all origins, allowing browser-based applications to make requests directly.

Quick Reference

Resource	Endpoint	Description
Markets	`GET /markets`	List all markets
Trades	`GET /trades/market/{address}`	Get trades for a market
Disputes	`GET /disputes`	List all disputes
Health	`GET /health`	Check API status
WebSocket	`WS /ws/markets/{address}`	Real-time market data
WebSocket	`WS /ws/activity`	Real-time trade activity

Next Steps

Authentication

Learn about API access and keys.

Rate Limits

Understand usage limits.

Markets

Query market data.

WebSocket

Subscribe to real-time updates.

Overview

REST Endpoints

WebSocket

Data Models

API Overview

Base URL

Features

REST API

WebSocket

No Authentication

Rate Limited

Response Format

HTTP Status Codes

Content Types

CORS

Quick Reference

Next Steps

Authentication

Rate Limits

Markets

WebSocket

​Base URL

​Features

REST API

WebSocket

No Authentication

Rate Limited

​Response Format

​HTTP Status Codes

​Pagination

​Content Types

​CORS

​Quick Reference

​Next Steps

Authentication

Rate Limits

Markets

WebSocket

Base URL

Features

Response Format

HTTP Status Codes

Pagination

Content Types

CORS

Quick Reference

Next Steps