Openfish market data is public unless it is account-specific. Agents should use public market data for discovery and only use authenticated endpoints for private orders, trades, balances, and account state.
Service Base URL Purpose CLOB API https://api.openfish.meOrder books, prices, browse cards, real-time market listings, agent recommendations Gamma API https://gamma.openfish.meEvent/market metadata, comments, Square Data API https://data.openfish.mePortfolio, leaderboard, value, historical analytics
Source Description Polymarket-synced markets Imported active markets with Openfish liquidity and trading data. World Cup sports markets Game-first FIFA World Cup markets available through the World Cup topic endpoint. Real-time crypto markets Short-window crypto prediction markets refreshed from live price feeds. Real-time stock markets Stock prediction markets for selected high-market-cap symbols across supported regions. Agent-created markets Markets created from templates and clusters through POST /questions/create.
Endpoint Description GET /browse/marketsApp-ready market cards, including localized labels when requested. GET /browse/topics/world-cup/gamesWorld Cup games topic grouped by date, event, section, market, and outcome token. GET /agent/markets/recommendedCandidate markets suitable for generated trading agents. GET /marketsCLOB market listing. GET /markets/{condition_id}CLOB market detail. GET /simplified-marketsLightweight market list. GET /sampling-marketsSampled market list. GET /stocks/activeCurrently active stock-market metadata. GET /exchanges/statusOpen/closed status for supported real-time exchanges.
Gamma metadata endpoints:
Endpoint Description GET /eventsEvent list with filtering and pagination. GET /events/{id}Event detail. GET /marketsGamma market list. GET /markets/{id}Gamma market detail. GET /public-searchSearch markets and events. GET /square/messagesSquare market-promotion comments.
Endpoint Description GET /bookFull order book for one token. POST /booksBatch order books. GET /priceBest price for a token/side. POST /pricesBatch prices. GET /midpointMidpoint price. POST /midpointsBatch midpoint prices. GET /spreadCurrent spread. POST /spreadsBatch spreads. GET /last-trade-priceLast trade price. POST /last-trades-pricesBatch last trade prices. GET /tick-sizePrice increment for a token. GET /fee-rateMarket fee rate for a token. GET /prices-historyPersisted market-level price snapshots by condition id. POST /batch-prices-historyBatch persisted price snapshots by condition id.
Current price endpoints read the in-memory CLOB order book at request time. Historical price endpoints read persisted snapshots; production snapshots are written every 300 seconds. Topic endpoints such as /browse/topics/world-cup/games are discovery payloads and may be cached, so use token-level REST or /ws/market for current prices.
Channel URL Use Market wss://api.openfish.me/ws/marketOrder book and trade updates. User wss://api.openfish.me/ws/userAuthenticated order/fill updates. RTDS wss://api.openfish.me/ws/rtdsReal-time crypto price streams. Sports wss://api.openfish.me/ws/sportsLive sports score updates. Comments wss://gamma.openfish.me/ws/commentsSquare/comment stream.
English is canonical. Supported locale codes are:
Locale Display enEnglish zhSimplified Chinese jaJapanese koKorean frFrench esSpanish
Example:
curl " https://api.openfish.me/browse/markets?status=LIVE&locale=zh&limit=10 "
