Predict API (Beta)
  1. Orders
  • FAQs
  • Deployed Contracts
  • Guides
    • Understanding the Orderbook
    • [TS] How to authenticate your API requests
    • [PY] How to authenticate your API requests
    • How to create or cancel orders
  • WebSocket
    • General Information
    • Request Format
    • Response Format
    • Subscription Topics
    • Heartbeats
    • Client Example
  • Authorization
    • Get auth message
      GET
    • Get JWT with valid signature
      POST
  • Categories
    • Get categories
      GET
    • Get category by slug
      GET
    • Get all tags
      GET
  • Markets
    • Get markets
      GET
    • Get market by ID
      GET
    • Get market statistics
      GET
    • Get market last sale information
      GET
    • Get the orderbook for a market
      GET
    • Get market timeseries
      GET
    • Get latest market timeseries value
      GET
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Get order match events
      GET
    • Remove orders from the orderbook
      POST
    • Create an order
      POST
  • Accounts
    • Get connected account
      GET
    • Get account activity
      GET
    • Set a referral
      POST
  • Positions
    • Get positions
      GET
    • Get positions by address
      GET
  • Search
    • Search categories and markets
      GET
  • OAuth
    • Finalize a OAuth connection
      POST
    • Get the orders for a OAuth connection
      POST
    • Create an order for a OAuth connection
      POST
    • Cancel the orders for a OAuth connection
      POST
    • Get the positions for a OAuth connection
      POST
  • Schemas
    • AccountData
    • AccountResponse
    • ActivityEvent
    • ActivityEventName
    • ActivityOrderData
    • ActivityResponse
    • AuthMessageData
    • AuthMessageResponse
    • AuthTokenData
    • AuthTokenResponse
    • CategoriesResponse
    • CategoryResponse
    • CategorySort
    • CategoryStatsData
    • CategoryStatsResponse
    • CategoryStatus
    • CategoryStatusFilter
    • ContractOrder
    • CreateOrderData
    • CreateOrderRequest
    • CreateOrderResponse
    • CreateOrderResponseData
    • CryptoUpDownVariantData
    • ErrorCode
    • ErrorResponse
    • Fee
    • FeeType
    • LastOrderSettled
    • LastSaleData
    • LastSaleResponse
    • Market
    • MarketResponse
    • MarketSort
    • MarketStatsData
    • MarketStatsResponse
    • MarketStatus
    • MarketStatusFilter
    • MarketTradingStatus
    • MarketVariant
    • MarketsResponse
    • MatchData
    • MatchesResponse
    • Metric
    • OAuthCancelOrdersData
    • OAuthCancelOrdersRequest
    • OAuthCancelOrdersResponse
    • OAuthCreateOrderData
    • OAuthCreateOrderRequest
    • OAuthCreateOrderResponse
    • OAuthFinalizeData
    • OAuthFinalizeRequest
    • OAuthFinalizeResponse
    • OAuthOrdersData
    • OAuthOrdersRequest
    • OAuthOrdersResponse
    • OAuthPositionsData
    • OAuthPositionsRequest
    • OAuthPositionsResponse
    • OrderData
    • OrderFillData
    • OrderResponse
    • OrderStatus
    • OrderStatusFilter
    • OrderStrategy
    • OrderbookData
    • OrderbookResponse
    • OrdersResponse
    • Outcome
    • OutcomeSide
    • OutcomeStatus
    • PointsInfo
    • PositionData
    • PositionSort
    • PositionsResponse
    • PostAuthRequest
    • PriceFeedProvider
    • QuoteType
    • ReferralInfo
    • ReferralStatus
    • RemoveOrdersData
    • RemoveOrdersRequest
    • RemoveOrdersResponse
    • ReservedBalancePolicy
    • Resolution
    • ResolutionProvider
    • SearchData
    • SearchResponse
    • SelfTradePreventionStrategy
    • SetReferralData
    • SetReferralRequest
    • SetReferralResponse
    • Tag
    • TagsResponse
    • TimeseriesData
    • TimeseriesLatestData
    • TimeseriesLatestResponse
    • TimeseriesPoint
    • TimeseriesResponse
    • TweetCountVariantData
    • VariantData
    • VariantData_CryptoUpDownVariantData
    • VariantData_TweetCountVariantData
  1. Orders

Create an order

Prod Env
https://api.predict.fun
Prod Env
https://api.predict.fun
POST
https://api.predict.fun
/orders
Create a LIMIT or MARKET order for the authenticated user.
Requires JWT authentication.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/json; charset=utf-8Required

Examples

Responses

🟢201
application/json; charset=utf-8
Created
Body

🟠400
🟠401
🟠403
🟠404
🟠410
🟠429
🔴500
🔴502
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.predict.fun/orders' \
--header 'x-api-key: <api-key>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "data": {
        "pricePerShare": "string",
        "strategy": "MARKET",
        "slippageBps": "string",
        "isFillOrKill": true,
        "isPostOnly": true,
        "reservedBalancePolicy": "REJECT_MARKET_ORDER",
        "isMinAmountOut": true,
        "selfTradePrevention": "CANCEL_MAKER",
        "order": {
            "hash": "string",
            "salt": "string",
            "maker": "string",
            "signer": "string",
            "taker": "string",
            "tokenId": "string",
            "makerAmount": "string",
            "takerAmount": "string",
            "expiration": 0,
            "nonce": "string",
            "feeRateBps": "string",
            "side": 0,
            "signatureType": 0,
            "signature": "string"
        }
    }
}'
Response Response Example
201 - Example 1
{
    "success": true,
    "data": {
        "code": "string",
        "orderId": "string",
        "orderHash": "string"
    }
}
Modified at 2026-04-06 01:49:58
Previous
Remove orders from the orderbook
Next
Get connected account
Built with