Predict API (Beta)
  1. Orders
Predict API (Beta)
  • 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
  • Orders
    • Get order by hash
      GET
    • Get orders
      GET
    • Get order match events
      GET
    • Create an order
      POST
    • Remove orders from the orderbook
      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
  1. Orders

Create an order

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

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Response 201
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.predict.fun/v1/orders' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "pricePerShare": "string",
        "strategy": "LIMIT",
        "slippageBps": "string",
        "isFillOrKill": true,
        "order": {
            "hash": "string",
            "salt": "string",
            "maker": "string",
            "signer": "string",
            "taker": "0x0000000000000000000000000000000000000000",
            "tokenId": "string",
            "makerAmount": "string",
            "takerAmount": "string",
            "expiration": "string",
            "nonce": "string",
            "feeRateBps": "string",
            "side": 0,
            "signatureType": 0,
            "signature": "string"
        }
    }
}'
Response Response Example
{
    "success": true,
    "data": {
        "code": "OK",
        "orderId": "string",
        "orderHash": "string"
    }
}
Modified at 2026-01-31 16:05:09
Previous
Get order match events
Next
Remove orders from the orderbook
Built with