API Reference

Relay44 exposes 147 endpoints across 16 API scopes. This overview covers the core read and write routes. See the sub-pages for detailed endpoint documentation per domain.

Health and runtime

Confirm the deployment is live and inspect current runtime mode.

GET
/health

Basic web-service health check

GET
/health/detailed

Runtime checks and provider status

GET
/metrics

Internal metrics

GET
/metrics/prometheus

Prometheus-format metrics

Markets (read)

Read market listings, order books, and recent trades from the unified feed.

GET
/v1/markets

List markets with pagination and filters

GET
/v1/markets/{market_id}

Single market snapshot

GET
/v1/markets/{market_id}/orderbook

Best bid/ask levels for one outcome

GET
/v1/markets/{market_id}/trades

Recent fills and trades

GET
/v1/evm/markets

Unified feed including external sources

GET
/v1/evm/markets/{market_id}

Single market with EVM data

GET
/v1/evm/markets/{market_id}/orderbook

Order book with on-chain depth

GET
/v1/evm/markets/{market_id}/trades

Trade history

Orders

Place, list, and cancel orders.

GET
/v1/orders

List your open orders

Requires auth
POST
/v1/orders

Place a new order

Requires auth
GET
/v1/orders/{order_id}

Get order details

Requires auth
DELETE
/v1/orders/{order_id}

Cancel an order

Requires auth

Positions

Track and claim outcome positions.

GET
/v1/positions

List your positions

Requires auth
GET
/v1/positions/{market_id}

Position in a specific market

Requires auth
POST
/v1/positions/{market_id}/claim

Claim winnings from a resolved market

Requires auth