Get user orders

GET

/apps/{appId}/users/{userId}/orders

Authorization

appApiKey

headerx-app-api-key<token>

App-scoped API key. It is the only credential on partner-admin reads, paper-trading admin, and webhook rotate or replay. POST /bot-protection/verify requires it together with x-app-id.

Query Parameters

orderId?string

orderType?string

Value in"market""limit"

quoteId?string

externalId?string

Length1 <= length <= 128

clientOrderId?string

Length1 <= length <= 128

venueMarketIds?array<string>|string

status?string

Order lifecycle status. In flight: pending (accepted, funds being checked), signing, pending_bridge (funds moving to the venue's chain), submitting, submitted (sent to the venue, awaiting confirmation). Resting limit orders: open, partially_filled_open, cancel_pending (cancel requested, awaiting the venue). Terminal: filled, partial_fill (the unfilled rest will not fill; see partialFillReason), failed, expired, cancelled.

Value in"pending""signing""pending_bridge""submitting""submitted""open""partially_filled_open""cancel_pending""filled""partial_fill""failed""expired""cancelled"

cursor?string

limit?integer

Range1 <= value <= 100

Response Body

200

application/json

response

data*array<>

This page of results.

nextCursor*string

Pass as cursor to fetch the next page; null on the last page.

hasMore*boolean

true when another page exists.

Example Request

curl -X GET 'https://api.t.sufwankhalid.com/apps/string/users/string/orders'

Example Request

curl -X GET 'https://api.t.sufwankhalid.com/apps/string/users/string/orders'

Example ResponseSchema

{
  "data": [
    {
      "id": "string",
      "quoteId": "string",
      "externalId": "string",
      "clientOrderId": "string",
      "venue": "kalshi",
      "status": "pending",
      "side": "string",
      "amountRaw": "string",
      "orderType": "market",
      "limitPriceRaw": "string",
      "limitSizeRaw": "string",
      "timeInForce": "GTC",
      "postOnly": true,
      "expiresAt": "2019-08-24T14:15:22Z",
      "reservedCostRaw": "string",
      "filledSizeRaw": "string",
      "filledCostRaw": "string",
      "remainingSizeRaw": "string",
      "averageFillPriceRaw": "string",
      "venueOrderId": "string",
      "tokenId": "string",
      "cancelRequestedAt": "string",
      "cancelledAt": "string",
      "cancelReason": "string",
      "slippageBps": 0,
      "quotedPriceRaw": "string",
      "quotedCostRaw": "string",
      "quotedSharesRaw": "string",
      "quotedToWinRaw": "string",
      "filledAmountRaw": "string",
      "executionPrice": "string",
      "actualSharesRaw": "string",
      "actualToWinRaw": "string",
      "partialFillReason": "string",
      "fees": {
        "venueFeeBasis": "fill",
        "quoted": {
          "venueFeeRaw": "string",
          "appFeeRaw": "string",
          "appFeeBips": 0,
          "referralFeeRaw": "string"
        },
        "actual": {
          "dagRunId": "string",
          "venueFeeRaw": "string",
          "appFee": {
            "bips": 0,
            "dueRaw": "string",
            "collectedRaw": "string",
            "status": "pending",
            "finalizedAt": "2019-08-24T14:15:22Z"
          },
          "bridge": {
            "relayFeeUsd": "string",
            "originGasCostUsd": "string",
            "operationCount": 0,
            "pricedOperationCount": 0
          },
          "referral": {
            "referrer": "string",
            "payer": "user",
            "feeBips": 0,
            "dueRaw": "string",
            "paidRaw": "string",
            "status": "pending"
          }
        }
      },
      "txHash": "string",
      "errorMessage": "string",
      "dagRunId": "string",
      "signerAddress": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "venueMarket": {
        "id": "string",
        "venueEventId": "string",
        "question": "string",
        "image": "string"
      },
      "venueMarketOutcome": {
        "label": "string",
        "title": "string"
      }
    }
  ],
  "nextCursor": "string",
  "hasMore": true
}

{  "data": [    {      "id": "string",      "quoteId": "string",      "externalId": "string",      "clientOrderId": "string",      "venue": "kalshi",      "status": "pending",      "side": "string",      "amountRaw": "string",      "orderType": "market",      "limitPriceRaw": "string",      "limitSizeRaw": "string",      "timeInForce": "GTC",      "postOnly": true,      "expiresAt": "2019-08-24T14:15:22Z",      "reservedCostRaw": "string",      "filledSizeRaw": "string",      "filledCostRaw": "string",      "remainingSizeRaw": "string",      "averageFillPriceRaw": "string",      "venueOrderId": "string",      "tokenId": "string",      "cancelRequestedAt": "string",      "cancelledAt": "string",      "cancelReason": "string",      "slippageBps": 0,      "quotedPriceRaw": "string",      "quotedCostRaw": "string",      "quotedSharesRaw": "string",      "quotedToWinRaw": "string",      "filledAmountRaw": "string",      "executionPrice": "string",      "actualSharesRaw": "string",      "actualToWinRaw": "string",      "partialFillReason": "string",      "fees": {        "venueFeeBasis": "fill",        "quoted": {          "venueFeeRaw": "string",          "appFeeRaw": "string",          "appFeeBips": 0,          "referralFeeRaw": "string"        },        "actual": {          "dagRunId": "string",          "venueFeeRaw": "string",          "appFee": {            "bips": 0,            "dueRaw": "string",            "collectedRaw": "string",            "status": "pending",            "finalizedAt": "2019-08-24T14:15:22Z"          },          "bridge": {            "relayFeeUsd": "string",            "originGasCostUsd": "string",            "operationCount": 0,            "pricedOperationCount": 0          },          "referral": {            "referrer": "string",            "payer": "user",            "feeBips": 0,            "dueRaw": "string",            "paidRaw": "string",            "status": "pending"          }        }      },      "txHash": "string",      "errorMessage": "string",      "dagRunId": "string",      "signerAddress": "string",      "createdAt": "string",      "updatedAt": "string",      "venueMarket": {        "id": "string",        "venueEventId": "string",        "question": "string",        "image": "string"      },      "venueMarketOutcome": {        "label": "string",        "title": "string"      }    }  ],  "nextCursor": "string",  "hasMore": true}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Query Parameters

Response Body