# Read one limit order by ID.
# Needs openssl, curl and OLYMPEX_API_KEY_ID, OLYMPEX_SECRET_KEY, OLYMPEX_PASSPHRASE.
ORDER_ID='afc47108-d059-473c-b2e1-5f2ca7951466' # from POST /limit-order
METHOD=GET
ENDPOINT="/limit-order/$ORDER_ID"
QUERY=''
BODY='' # GET has no body: the signature covers the empty string
TS="${OLYMPEX_TIMESTAMP:-$(date +%s)}"
NONCE="${OLYMPEX_NONCE:-$(openssl rand -hex 12)}"
BODY_HASH="$(printf '%s' "$BODY" | openssl dgst -sha256 -binary | openssl base64 -A | tr '+/' '-_' | tr -d '=')"
VALUE_INFO="$(printf '%s\n%s\n%s' "$TS" "$NONCE" "$BODY_HASH")"
MESSAGE="$(printf 'OLPX-HMAC-SHA256-V2\n%s\n%s\n%s\n%s\n%s\n%s' "$TS" "$NONCE" "$METHOD" "/api/v1$ENDPOINT" "$QUERY" "$BODY_HASH")"
curl -sS -X "$METHOD" "https://api-rest.olympex.io/api/v1$ENDPOINT${QUERY:+?$QUERY}" \
  -H "content-type: application/json" \
  -H "x-api-key-id: $OLYMPEX_API_KEY_ID" \
  -H "x-value-info: $(printf '%s' "$VALUE_INFO" | openssl base64 -A)" \
  -H "x-passphrase: $OLYMPEX_PASSPHRASE" \
  -H "x-signature: $(printf '%s' "$MESSAGE" | openssl dgst -sha256 -hmac "$OLYMPEX_SECRET_KEY" -binary | od -An -v -tx1 | tr -d ' \n')"

import { olympexRequest } from "./sign-request.ts"; // /authentication/sign-requests

type LimitOrder = { id: string; status: string; expired: string; txHash: string; reasonFail: string[]; attemptNumber: number };

const FINAL = new Set(["completed", "failed", "cancelled"]);
const orderId = "afc47108-d059-473c-b2e1-5f2ca7951466"; // from POST /limit-order

let order = await olympexRequest<LimitOrder>("GET", `/limit-order/${orderId}`);
const stopAt = Number(order.expired) + 60 * 60_000; // the order's own expiry (Unix ms) plus an hour
while (!FINAL.has(order.status) && Date.now() < stopAt) { // any other status, known or not, isn't final
  await new Promise((resolve) => setTimeout(resolve, 30_000)); // poll every 15 to 60 seconds
  order = await olympexRequest<LimitOrder>("GET", `/limit-order/${orderId}`);
}

if (order.status === "completed") console.log(`Executed in ${order.txHash}`);
else if (order.status === "failed") console.log(`Failed after ${order.attemptNumber} attempts: ${order.reasonFail.join("; ")}`);
else if (order.status === "cancelled") console.log("Cancelled");
else console.log(`Still ${order.status} an hour after its expiry: check it again later, or cancel it`);

import time

from sign_request import olympex_request  # /authentication/sign-requests

FINAL = {"completed", "failed", "cancelled"}
order_id = "afc47108-d059-473c-b2e1-5f2ca7951466"  # from POST /limit-order

order = olympex_request("GET", f"/limit-order/{order_id}")
stop_at = int(order["expired"]) / 1000 + 60 * 60  # the order's own expiry (Unix ms) plus an hour, in seconds
while order["status"] not in FINAL and time.time() < stop_at:  # any other status, known or not, isn't final
    time.sleep(30)  # poll every 15 to 60 seconds
    order = olympex_request("GET", f"/limit-order/{order_id}")

if order["status"] == "completed":
    print("Executed in", order["txHash"])
elif order["status"] == "failed":
    print(f'Failed after {order["attemptNumber"]} attempts:', "; ".join(order["reasonFail"]))
elif order["status"] == "cancelled":
    print("Cancelled")
else:
    print(f'Still {order["status"]} an hour after its expiry: check it again later, or cancel it')

{
  "success": true,
  "data": {
    "id": "afc47108-d059-473c-b2e1-5f2ca7951466",
    "accountTo": "0x1E67cb01969D79B2B895179e4A07D24a839dBb52",
    "chainId": 137,
    "gasPrice": "35",
    "inTokenAddress": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
    "outTokenAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "slippage": "1",
    "tokenASymbol": "ETH",
    "tokenBSymbol": "USDC",
    "amount": 0.5,
    "price": 4200,
    "priceTrigger": 4200,
    "expired": "1791302400000",
    "txHash": "",
    "status": "pending",
    "reasonFail": [],
    "attemptNumber": 0,
    "allowance": "",
    "estimateGas": "",
    "effectivePriceGas": "",
    "createdAt": "2026-09-29T16:01:22.237Z",
    "updatedAt": "2026-09-29T16:01:22.237Z",
    "deletedAt": ""
  },
  "meta": {
    "requestId": "EdkevjVXoAMEZIw=",
    "version": "v1",
    "accountType": "integrator",
    "apiKeyId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Limit order not found",
    "details": []
  },
  "meta": {
    "requestId": "EdjeXjypoAMEbrQ=",
    "version": "v1",
    "accountType": "integrator",
    "apiKeyId": "00000000-0000-4000-8000-000000000000"
  }
}

{
  "message": "Forbidden"
}