Skip to main content
GET
/
data
/
order
/
{id}
Get order
curl --request GET \
  --url https://clob.forka.st/data/order/{id}
{
  "order": {
    "associateTrades": [
      "01J9PQTW6J5N5R0A6VY3T3V9RJ"
    ],
    "id": "01J9R1Z4Q6YKQ4JE2T6V9N7A8B",
    "status": "live",
    "market": "0x9febb3d92e347a0990353d363df23878",
    "originalSize": "250.000000",
    "outcome": "0x34b62d0ca7bf5d069a0f3c8ec7d8f9a1",
    "makerAddress": "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC",
    "owner": "01J8ZK6QP5DHBFR0J2TXGZ82C0",
    "price": "0.450000",
    "side": "BUY",
    "sizeMatched": "75.000000",
    "assetId": "0x34b62d0ca7bf5d069a0f3c8ec7d8f9a1",
    "expiration": "0",
    "type": "GTC",
    "createdAt": "2024-09-16T13:02:44.581Z",
    "updatedAt": "2024-09-16T13:37:11.902Z"
  }
}
Retrieve the latest state for a previously submitted order. The response captures execution progress, timestamps, and any trades already linked to the order. Link back to POST /order to see the payload that generates each ULID, and use DELETE /order if you need to retire the order after inspection.

Response fields

FieldTypeDescription
associateTradesstring[]Trade identifiers linked to this order. Empty when no matches occurred.
idstringULID assigned to the order.
statusstringLifecycle state: live, matched, delayed, or unmatched.
marketstringMarket identifier associated with the order.
originalSizestringSize requested when the order was submitted.
outcomestringMarket outcome identifier (market address + outcome index).
makerAddressstringAddress that funded the maker side.
ownerstringAPI key owner recorded with the order when available.
pricestringLimit price formatted with fixed precision.
sidestringEither BUY or SELL.
sizeMatchedstringTotal quantity matched so far.
assetIdstringToken identifier for the traded outcome.
expirationstringExpiration timestamp in Unix seconds.
typestringExecution policy (GTC, GTD, FAK, FOK).
createdAtstringISO-8601 timestamp for when the order was inserted.
updatedAtstringISO-8601 timestamp for the most recent update (fill, cancel, etc.).
status reflects the latest lifecycle transition: live (resting), matched (filled immediately), delayed (awaiting deferred matching), or unmatched (marketable but ultimately unfilled after the delay window).

Path Parameters

id
string
required

ULID of the order to fetch.

Response

Order detail response

order
object
required