Changelog
Changelog
Changes to the REST API, the WebSocket API and these docs, newest first.
Each entry names the API it changes. A change that can make a request that used to succeed fail, or that changes what an existing field means, starts with "Behavior change".
November 9, 2026
- WebSocket API. A connection that does not finish sending its upgrade request within 30 seconds is closed.
November 6, 2026
- WebSocket API. Behavior change. Ids in topic names must be written in their plain decimal form. A subscribe to
predictOrderbook/01orpredictOrderbook/+1is rejected. Subscribe topredictOrderbook/1instead.
November 5, 2026
- Docs. The developer docs moved to dev.predict.fun, with guides, a REST reference generated from the OpenAPI spec, a WebSocket reference generated from the AsyncAPI spec, and a Markdown copy of every page, indexed at
/llms.txt.
October 26, 2026
- REST API. New endpoint
GET /account/{address}returns the public profile of any wallet. - REST API. Behavior change.
GET /searchrejects aquerylonger than 256 characters with a 400. The limit was already documented.
October 20, 2026
- REST API. New endpoint
GET /account/{address}/pnlreturns a wallet's profit and loss history for aperiodof1d,7d,30dorall. - REST API. New endpoint
GET /markets/status-logsreturns the on-chain status changes of up to 100 markets per call. - REST API. Markets have a
makerFeeBpsfield. It is0on every market, because no market charges makers.feeRateBpsis the taker fee. - REST API.
GET /positionsandGET /positions/{address}acceptmarketIds, a list of up to 100 market ids. It cannot be combined withmarketId. - REST API.
GET /categoriesacceptsmarketVariants, a list that cannot be combined withmarketVariant, and returns atotalCountwhen you passincludeTotalCount=true. - REST API.
GET /searchaccepts alimitof up to 50, up from 25.
October 15, 2026
- REST API. Behavior change.
POST /ordersrejects anonceabove 2147483647, a slippage or fee rate above 10000 bps, and a signature longer than 1 KiB of hex. Orders signed with the SDKs are not affected.
October 12, 2026
- REST API. New endpoint
GET /account/{address}/activityreturns the activity of any wallet.
October 5, 2026
- REST API. New endpoints
GET /series,GET /series/{slug}andGET /series/{slug}/roundslist recurring market series, such as hourly up or down markets, and their rounds. Every category and market that is a round of a series carries itsseriesSlug.
September 14, 2026
- REST API. Behavior change.
GET /positionsandGET /positions/{address}leave out positions in outcomes that settled as losing, as the web app does. PassincludeLost=trueto list them.
September 9, 2026
- WebSocket API. New topic
predictTopOfBook/{marketId}carries a market's best bid, best ask, their sizes and the last trade. Subscribe to it instead of the full order book when you only need the touch.
September 8, 2026
- WebSocket API. Wallet events render the outcome name in the language set with
setLanguage.
August 31, 2026
- REST API. Vietnamese, Indonesian and Korean translations. See
GET /languages.
August 26, 2026
- REST API. Behavior change. Open positions are valued at the price they could be sold for, the best bid for Yes and the complement of the best ask for No, rather than the midpoint of the book.
August 25, 2026
- REST API. Paginated lists no longer skip rows that share a sort value across a page boundary.
August 18, 2026
- REST API.
POST /ordersanswers a signature without a0xprefix with a 400 instead of a 500.
August 17, 2026
- WebSocket API. Before the server restarts, it sends a reconnect notice so clients can reconnect before the connection closes.
August 13, 2026
- REST API.
GET /maker-rebatesacceptsoccurred_afterandoccurred_before.
August 7, 2026
- REST API. Responses carry an
ETag. Send it back inIf-None-Matchto get a 304 with no body when nothing changed.
August 3, 2026
- WebSocket API. Connections can negotiate
permessage-deflatecompression.
July 31, 2026
- REST API.
GET /orders/matchesacceptsorderHashesto return only the matches of the given orders.
July 28, 2026
- REST API. Categories carry
negRiskOnChainId, the on-chain id of a negative risk market.
July 15, 2026
- REST API.
POST /ordersanswers an invalid price with a 400 instead of a 500.
June 26, 2026
- REST API.
POST /ordersreturnsremovalLockedUntil. On up/down markets with a speed bump, an order that isn't post-only can't be removed before that time. Elsewhere it'snull.
June 24, 2026
- REST API.
GET /account/activityacceptsoccurredAfterandoccurredBefore.
June 17, 2026
- REST API. New endpoints
GET /maker-rebatesandGET /referral-feeslist the maker rebates and referral fees paid to your account.
June 10, 2026
- REST API.
GET /orders/matchesacceptsexecutedAfterandexecutedBefore.
May 20, 2026
- REST API. New endpoint
POST /orders/remove-by-hashremoves orders by their hashes.
May 6, 2026
- REST API. Categories carry a
shortTitle.
April 20, 2026
- REST API. New endpoints
GET /markets/orderbooksandGET /markets/timeseriesserve many markets in one call.
April 4, 2026
- REST API.
POST /ordersacceptsisPostOnlyonLIMITorders. A post-only order only adds liquidity. If it would match right away, it isn't placed in the book, and you get anorderNotAcceptedevent with the reasonrejectedPostOnly. See place orders.
March 18, 2026
- REST API. Categories carry
resolutionProvider, the source that resolves their markets.
March 17, 2026
- REST API. Market timeseries accept a
resolutionof1m.