Skip to main content
POST
/
v1
/
api
/
orders
Create order
curl --request POST \
  --url https://api.dotprediction.io/v1/api/orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "platform": "kalshi",
  "market_id": "<string>",
  "side": "buy",
  "outcome": "<string>",
  "type": "limit",
  "size": 123,
  "credential_id": 123,
  "price": 123,
  "time_in_force": "<string>",
  "expiration": "<string>",
  "client_order_id": "<string>",
  "idempotency_key": "<string>"
}
'
{
  "order": {
    "order_id": "<string>",
    "platform": "<string>",
    "market_id": "<string>",
    "side": "buy",
    "outcome": "<string>",
    "type": "limit",
    "price": 123,
    "size": 123,
    "filled_size": 123,
    "remaining_size": 123,
    "average_fill_price": 123,
    "status": "<string>",
    "time_in_force": "<string>",
    "client_order_id": "<string>",
    "fees": {
      "maker_fee": 123,
      "taker_fee": 123,
      "total_fee": 123
    },
    "created_at": "<string>",
    "updated_at": "<string>",
    "expiration": "<string>"
  },
  "meta": {
    "platform": "<string>",
    "request_time_ms": 123,
    "idempotent_replay": true
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Generate one via the dashboard or the /v1/api/auth/api-keys endpoint.

Body

application/json
​
platform
enum<string>
required

Target platform.

Available options:
kalshi,
polymarket,
limitless
​
market_id
string
required

The market to place the order on.

​
side
enum<string>
required

Order side.

Available options:
buy,
sell
​
outcome
string
required

Outcome to trade (e.g., 'Yes', 'No').

​
type
enum<string>
required

Order type.

Available options:
limit,
market
​
size
number
required

Number of contracts/shares.

​
credential_id
integer

Stored credential ID. Omit to use default.

​
price
number

Limit price (0.01-0.99). Required for limit orders.

​
time_in_force
string

Time in force (default: gtc).

​
expiration
string

Expiration time (ISO 8601).

​
client_order_id
string

Client-provided order ID.

​
idempotency_key
string

Idempotency key to prevent duplicate orders.

Response

Order created.

​
order
object
​
meta
object