Create prediction buy order

POST

/api/order/create

Creates a prediction order after the user confirms a purchase. The endpoint performs parameter validation, fee calculation, ledger deduction, order persistence, and advances the order status according to actual Polymarket results. It requires prediction:order:create permission and is protected against duplicate submission.

Request

Authorization

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Example

{
    "betAmount": 100,
    "tokenType": "USDT",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "outcomeTokenId": "12345678901234567890",
    "idempotencyKey": "0c92d0f4-2222-4ab2-9f78-9aab9fdf0001",
    "id": "512345",
    "question": "Will Team A win?",
    "slug": "will-team-a-win",
    "categoryKey": "sports",
    "topicKey": "string",
    "subKey": "soccer",
    "detailRouteType": "MARKET_DETAIL",
    "eventId": "evt_2026_001",
    "eventSlug": "team-a-vs-team-b",
    "description": "Premier League match winner",
    "image": "https://static.example.com/market.png",
    "conditionId": "0xcondition",
    "questionID": "question-1",
    "clobTokenIds": "[\"12345678901234567890\",\"98765432109876543210\"]",
    "negRisk": false,
    "negRiskMarketID": "string",
    "groupItemTitle": "Moneyline",
    "resolutionSource": "https://example.com/source",
    "startDate": "2026-05-18T00:00:00Z",
    "endDate": "2026-06-01T00:00:00Z",
    "gameStartTime": "2026-05-20T19:30:00Z",
    "sportsMarketType": "moneyline",
    "outcomes": "[\"Yes\",\"No\"]",
    "line": 0,
    "bestBid": 0.41,
    "bestAsk": 0.42,
    "lastTradePrice": 0.42,
    "liquidityNum": 50000,
    "volumeNum": 150000,
    "active": true,
    "closed": false,
    "acceptingOrders": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ourcorvus.com/api/order/create' \
--header 'Accept-Language: zh_CN' \
--header 'clientId: 8e06704235ad224b8b2af4eeb95580a9' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "betAmount": 100,
    "tokenType": "USDT",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "outcomeTokenId": "12345678901234567890",
    "idempotencyKey": "0c92d0f4-2222-4ab2-9f78-9aab9fdf0001",
    "id": "512345",
    "question": "Will Team A win?",
    "slug": "will-team-a-win",
    "categoryKey": "sports",
    "topicKey": "string",
    "subKey": "soccer",
    "detailRouteType": "MARKET_DETAIL",
    "eventId": "evt_2026_001",
    "eventSlug": "team-a-vs-team-b",
    "description": "Premier League match winner",
    "image": "https://static.example.com/market.png",
    "conditionId": "0xcondition",
    "questionID": "question-1",
    "clobTokenIds": "[\"12345678901234567890\",\"98765432109876543210\"]",
    "negRisk": false,
    "negRiskMarketID": "string",
    "groupItemTitle": "Moneyline",
    "resolutionSource": "https://example.com/source",
    "startDate": "2026-05-18T00:00:00Z",
    "endDate": "2026-06-01T00:00:00Z",
    "gameStartTime": "2026-05-20T19:30:00Z",
    "sportsMarketType": "moneyline",
    "outcomes": "[\"Yes\",\"No\"]",
    "line": 0,
    "bestBid": 0.41,
    "bestAsk": 0.42,
    "lastTradePrice": 0.42,
    "liquidityNum": 50000,
    "volumeNum": 150000,
    "active": true,
    "closed": false,
    "acceptingOrders": true
}'

Responses

🟠400

application/json

Parameter validation failed

Bodyapplication/json

Example

{
    "code": 400001,
    "msg": "Parameter validation failed: betAmount is required",
    "data": null
}

🟢200PredictionOrderSuccess

🟠401Unauthorized

🟠403Forbidden

🔴500ServerError

Modified at 2026-05-19 06:32:44

My orders with pagination

Create prediction sell order