Get Active Orders

REST APIs Prediction Markets Order ManagementGet Active Orders

Get Active Orders

POSThttps://api.gemini.com/v1/prediction-markets/orders/active

Returns a list of currently open (active) orders for the authenticated user.

POSTv1/prediction-markets/orders/active

curl --request POST \
  --url https://api.gemini.com/v1/prediction-markets/orders/active \
  --header 'X-GEMINI-APIKEY: <string>' \
  --header 'X-GEMINI-PAYLOAD: <string>' \
  --header 'X-GEMINI-SIGNATURE: <string>'

Roles

The API key you use to access this endpoint must have the Trader role assigned. See Roles 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

Filter by contract instrument symbolExample: GEMI-FEDJAN26-DN25

limitinteger

Maximum number of results to return (default 50, max 100)

offsetinteger

Number of results to skip for pagination

Responses

Successful response

ordersarray

orders[].orderIdinteger (int64)

Example: 12345678

orders[].hashOrderIdstring

orders[].clientOrderIdstring

orders[].globalOrderIdstring

orders[].statusstring·enum

Enum values: openfilledcancelled

orders[].symbolstring

orders[].sidestring·enum

Enum values: buysell

orders[].outcomestring·enum

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

orders[].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

orders[].quantitystring

Original order quantity

orders[].filledQuantitystring

Amount filled so far

orders[].remainingQuantitystring

Amount remaining to fill

orders[].pricestring

Limit price

orders[].stopPricestring

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

orders[].avgExecutionPricestring

Average price of fills

orders[].createdAtstring (date-time)

orders[].updatedAtstring (date-time)

orders[].cancelledAtstring (date-time)

orders[].contractMetadataobject

orders[].contractMetadata.contractIdstring

orders[].contractMetadata.contractNamestring

orders[].contractMetadata.contractTickerstring

orders[].contractMetadata.eventTickerstring

orders[].contractMetadata.eventNamestring

orders[].contractMetadata.categorystring

orders[].contractMetadata.contractStatusstring

orders[].contractMetadata.imageUrlstring

orders[].contractMetadata.eventImageUrlstring

Image URL for the parent event

orders[].contractMetadata.eventTypestring

Event type ("binary" or "categorical")

orders[].contractMetadata.expiryDatestring (date-time)

orders[].contractMetadata.resolvedAtstring (date-time)

orders[].contractMetadata.resolutionSidestring

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

orders[].contractMetadata.descriptionstring

orders[].contractMetadata.sortOrderinteger

Display sort ordering

orders[].contractMetadata.parentEventTickerstring

Parent event ticker for sub-events

orders[].contractMetadata.templatestring

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

orders[].contractMetadata.colorstring

Display color

orders[].contractMetadata.startTimestring (date-time)

Start datetime (ISO 8601)

paginationobject

pagination.limitinteger

pagination.offsetinteger

pagination.countinteger

Number of items in current response

Example Responses

{
  "orders": [
    {
      "orderId": 12345678901,
      "status": "open",
      "symbol": "GEMI-FEDJAN26-DN25",
      "side": "buy",
      "outcome": "yes",
      "orderType": "limit",
      "quantity": "100",
      "filledQuantity": "25",
      "remainingQuantity": "75",
      "price": "0.65",
      "avgExecutionPrice": "0.64",
      "createdAt": "2025-12-15T10:30:00.000Z",
      "updatedAt": "2025-12-15T11:00:00.000Z",
      "cancelledAt": null,
      "contractMetadata": {
        "contractId": "contract_123",
        "contractName": "FEDJAN26-DN25",
        "contractTicker": "FEDJAN26-DN25",
        "eventTicker": "FEDJAN26",
        "eventName": "Will Fed Funds Rate drop at least 0.25% at January 2026 meeting?",
        "category": "economics",
        "contractStatus": "active",
        "imageUrl": "https://example.com/fed.png",
        "expiryDate": "2026-01-31T23:59:59.000Z",
        "resolvedAt": null,
        "description": "Resolves YES if Federal Reserve lowers the target rate by 0.25% or more at the January 2026 FOMC meeting"
      }
    },
    {
      "orderId": 12345678902,
      "status": "open",
      "symbol": "GEMI-FEDJAN26-DN25",
      "side": "sell",
      "outcome": "yes",
      "orderType": "limit",
      "quantity": "50",
      "filledQuantity": "0",
      "remainingQuantity": "50",
      "price": "0.65",
      "avgExecutionPrice": null,
      "createdAt": "2025-12-15T12:00:00.000Z",
      "updatedAt": "2025-12-15T12:00:00.000Z",
      "cancelledAt": null,
      "contractMetadata": {
        "contractId": "contract_123",
        "contractName": "FEDJAN26-DN25",
        "contractTicker": "FEDJAN26-DN25",
        "eventTicker": "FEDJAN26",
        "eventName": "Will Fed Funds Rate drop at least 0.25% at January 2026 meeting?",
        "category": "economics",
        "contractStatus": "active",
        "imageUrl": "https://example.com/fed.png",
        "expiryDate": "2026-01-31T23:59:59.000Z",
        "resolvedAt": null,
        "description": "Resolves YES if Federal Reserve lowers the target rate by 0.25% or more at the January 2026 FOMC meeting"
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 2
  }
}

PreviousCancel Order NextPositions

Last modified on May 5, 2026

curl --request POST \ --url https://api.gemini.com/v1/prediction-markets/orders/active \ --header 'X-GEMINI-APIKEY: <string>' \ --header 'X-GEMINI-PAYLOAD: <string>' \ --header 'X-GEMINI-SIGNATURE: <string>'