Place Order

REST APIs Prediction Markets Order ManagementPlace Order

Place Order

POSThttps://api.gemini.com/v1/prediction-markets/order

Place a new prediction market limit order. Currently only limit orders are supported.

POSTv1/prediction-markets/order

curl --request POST \
  --url https://api.gemini.com/v1/prediction-markets/order \
  --header 'Content-Type: application/json' \
  --header 'X-GEMINI-APIKEY: <string>' \
  --header 'X-GEMINI-PAYLOAD: <string>' \
  --header 'X-GEMINI-SIGNATURE: <string>' \
  --data '
{
  "symbol": "GEMI-FEDJAN26-DN25",
  "orderType": "limit",
  "side": "buy",
  "quantity": "100",
  "price": "0.65",
  "outcome": "yes",
  "timeInForce": "good-til-cancel"
}
'

Roles

The API key you use to access this endpoint must have the Trader role assigned. See Roles for more information.

The OAuth scope must have orders:create assigned to access this endpoint. See OAuth Scopes for more information.

Headers

X-GEMINI-APIKEYstring·required

Your API key

X-GEMINI-SIGNATUREstring·required

HEX-encoded HMAC-SHA384 of payload signed with API secret

X-GEMINI-PAYLOADstring·required

Base64-encoded JSON payload

Content-Typestring

Default: text/plain

Content-Lengthstring

Default: 0

Cache-Controlstring

Default: no-cache

Request Body

symbolstring·required

Contract instrument symbolExample: GEMI-FEDJAN26-DN25

orderTypestring·enum·required

Order type. `stop-limit` orders require a `stopPrice` that triggers a limit order at `price` when the market reaches the trigger.Enum values: limitstop-limit

sidestring·enum·required

Enum values: buysell

quantitystring·required

Number of contractsExample: 100

pricestring·required

Limit price (0-1 range)Example: 0.65

stopPricestring

The price to trigger a stop-limit order (0-1 range). Only available for stop-limit orders. See [Stop-Limit Orders](#operation/placeOrder) above for `stopPrice`/`price` constraints.Example: 0.60

outcomestring·enum·required

The outcome being traded (Yes or No)Enum values: yesno

timeInForcestring·enum

Order execution behavior: - `good-til-cancel` - Order remains active until filled or cancelled (default) - `immediate-or-cancel` - Fill immediately or cancel remaining - `fill-or-kill` - Fill entire order immediately or cancel - `maker-or-cancel` - Only add liquidity to the order book; if any part would fill immediately, the entire order is cancelled. Also known as "post-only".Enum values: good-til-cancelimmediate-or-cancelfill-or-killmaker-or-cancel

Responses

Order created successfully

orderIdinteger (int64)

Example: 12345678

hashOrderIdstring

clientOrderIdstring

globalOrderIdstring

statusstring·enum

Enum values: openfilledcancelled

symbolstring

sidestring·enum

Enum values: buysell

outcomestring·enum

The outcome being traded (Yes or No)Enum values: yesno

orderTypestring·enum

Order type. `stop-limit` orders require a `stopPrice` that triggers a limit order at `price` when the market reaches the trigger.Enum values: limitstop-limit

quantitystring

Original order quantity

filledQuantitystring

Amount filled so far

remainingQuantitystring

Amount remaining to fill

pricestring

Limit price

stopPricestring

Stop trigger price (populated for `stop-limit` orders)

avgExecutionPricestring

Average price of fills

createdAtstring (date-time)

updatedAtstring (date-time)

cancelledAtstring (date-time)

contractMetadataobject

contractMetadata.contractIdstring

contractMetadata.contractNamestring

contractMetadata.contractTickerstring

contractMetadata.eventTickerstring

contractMetadata.eventNamestring

contractMetadata.categorystring

contractMetadata.contractStatusstring

contractMetadata.imageUrlstring

contractMetadata.eventImageUrlstring

Image URL for the parent event

contractMetadata.eventTypestring

Event type ("binary" or "categorical")

contractMetadata.expiryDatestring (date-time)

contractMetadata.resolvedAtstring (date-time)

contractMetadata.resolutionSidestring

Winning outcome if resolved ("yes" or "no")

contractMetadata.descriptionstring

contractMetadata.sortOrderinteger

Display sort ordering

contractMetadata.parentEventTickerstring

Parent event ticker for sub-events

contractMetadata.templatestring

Contract template type (e.g. "binary", "sports_game", "crypto_up_down")

contractMetadata.colorstring

Display color

contractMetadata.startTimestring (date-time)

Start datetime (ISO 8601)

PreviousOrder Management NextCancel Order

Last modified on May 5, 2026

curl --request POST \ --url https://api.gemini.com/v1/prediction-markets/order \ --header 'Content-Type: application/json' \ --header 'X-GEMINI-APIKEY: <string>' \ --header 'X-GEMINI-PAYLOAD: <string>' \ --header 'X-GEMINI-SIGNATURE: <string>' \ --data ' { "symbol": "GEMI-FEDJAN26-DN25", "orderType": "limit", "side": "buy", "quantity": "100", "price": "0.65", "outcome": "yes", "timeInForce": "good-til-cancel" } '

Request Body

symbolstring·required

Contract instrument symbolExample: GEMI-FEDJAN26-DN25

orderTypestring·enum·required

Order type. `stop-limit` orders require a `stopPrice` that triggers a limit order at `price` when the market reaches the trigger.Enum values: limitstop-limit

sidestring·enum·required

Enum values: buysell

quantitystring·required

Number of contractsExample: 100

pricestring·required

Limit price (0-1 range)Example: 0.65

stopPricestring

The price to trigger a stop-limit order (0-1 range). Only available for stop-limit orders. See [Stop-Limit Orders](#operation/placeOrder) above for `stopPrice`/`price` constraints.Example: 0.60

outcomestring·enum·required

The outcome being traded (Yes or No)Enum values: yesno

timeInForcestring·enum

Responses

Order created successfully

orderIdinteger (int64)

Example: 12345678

hashOrderIdstring

clientOrderIdstring

globalOrderIdstring

statusstring·enum

Enum values: openfilledcancelled

symbolstring

sidestring·enum

Enum values: buysell

outcomestring·enum

The outcome being traded (Yes or No)Enum values: yesno

orderTypestring·enum

Order type. `stop-limit` orders require a `stopPrice` that triggers a limit order at `price` when the market reaches the trigger.Enum values: limitstop-limit

quantitystring

Original order quantity

filledQuantitystring

Amount filled so far

remainingQuantitystring

Amount remaining to fill

pricestring

Limit price

stopPricestring

Stop trigger price (populated for `stop-limit` orders)

avgExecutionPricestring

Average price of fills

createdAtstring (date-time)

updatedAtstring (date-time)

cancelledAtstring (date-time)

contractMetadataobject

contractMetadata.contractIdstring

contractMetadata.contractNamestring

contractMetadata.contractTickerstring

contractMetadata.eventTickerstring

contractMetadata.eventNamestring

contractMetadata.categorystring

contractMetadata.contractStatusstring

contractMetadata.imageUrlstring

contractMetadata.eventImageUrlstring

Image URL for the parent event

contractMetadata.eventTypestring

Event type ("binary" or "categorical")

contractMetadata.expiryDatestring (date-time)

contractMetadata.resolvedAtstring (date-time)

contractMetadata.resolutionSidestring

Winning outcome if resolved ("yes" or "no")

contractMetadata.descriptionstring

contractMetadata.sortOrderinteger

Display sort ordering

contractMetadata.parentEventTickerstring

Parent event ticker for sub-events

contractMetadata.templatestring

Contract template type (e.g. "binary", "sports_game", "crypto_up_down")

contractMetadata.colorstring

Display color

contractMetadata.startTimestring (date-time)

Start datetime (ISO 8601)