Skip to content
Openfish Docs

API Introduction

Openfish exposes four independent backend services, each responsible for a distinct area of functionality. All services communicate over HTTPS and return JSON.

Services

Section titled “Services”

CLOB API

Section titled “CLOB API”

https://api.openfish.fun (port 3002)

The central trading service. Provides order book snapshots, live pricing (midpoints, spreads, last-trade), and historical price data. All order lifecycle operations — placement, amendment, and cancellation — go through this service. Write operations are gated by authenticated headers.

Data API

Section titled “Data API”

https://data.openfish.fun (port 3003)

Aggregated analytics and portfolio data. Covers user positions, trade histories, activity feeds, token-holder breakdowns, open interest figures, leaderboard rankings, and builder-level metrics.

Gamma API

Section titled “Gamma API”

https://gamma.openfish.fun (port 3001)

The discovery layer. Surfaces markets, events, tags, series, comments, search results, and public user profiles. Intended for browsing and exploring available prediction markets.

Bridge API

Section titled “Bridge API”

https://bridge.openfish.fun (port 3004)

Manages on- and off-ramp flows for deposits and withdrawals. Requests are relayed through a third-party bridge provider.

Access Control

Section titled “Access Control”

Read-only endpoints across the Gamma API, Data API, and CLOB (order book, prices, spreads) are open to all callers without credentials.

Trading operations on the CLOB API — submitting orders, cancelling orders, and sending heartbeats — demand L2 authentication headers on every request. Refer to Authentication for the full setup.

Where to Go Next

Section titled “Where to Go Next”