Get single order by ID

xo-orderbook-client-rs

// Requires an authenticated client.
let order = client
    .order("0x0011223344556677889900aabbccddeeff00112233445566778899aabbccddee")
    .await?;
println!("status: {:?}", order.status);

const options = {method: 'GET', headers: {XO_API_KEY: '<api-key>'}};

fetch('https://orderbooks.xo.market/data/order/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://orderbooks.xo.market/data/order/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "XO_API_KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://orderbooks.xo.market/data/order/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("XO_API_KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://orderbooks.xo.market/data/order/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["XO_API_KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "101",
  "market": "0x39a12d52b63969654926e095ddd96f5c459112714da03edca769aa58173c78fb",
  "asset_id": "26516164265702901957933644848127860370782874751279270726689263951695181556943",
  "outcome": "Yes",
  "side": "BUY",
  "price": "0.547",
  "original_size": "100000000",
  "size_matched": "15000000",
  "status": "live",
  "created_at": 1779355800,
  "order_hash": "0x0011223344556677889900aabbccddeeff00112233445566778899aabbccddee",
  "maker_address": "0xCAFE000000000000000000000000000000000A11",
  "owner": "346629a1-8226-5a85-823f-3a25ae818e10",
  "expiration": "0",
  "order_type": "GTC"
}

GET

data

order

{id}

xo-orderbook-client-rs

// Requires an authenticated client.
let order = client
    .order("0x0011223344556677889900aabbccddeeff00112233445566778899aabbccddee")
    .await?;
println!("status: {:?}", order.status);

const options = {method: 'GET', headers: {XO_API_KEY: '<api-key>'}};

fetch('https://orderbooks.xo.market/data/order/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://orderbooks.xo.market/data/order/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "XO_API_KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://orderbooks.xo.market/data/order/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("XO_API_KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://orderbooks.xo.market/data/order/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["XO_API_KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "101",
  "market": "0x39a12d52b63969654926e095ddd96f5c459112714da03edca769aa58173c78fb",
  "asset_id": "26516164265702901957933644848127860370782874751279270726689263951695181556943",
  "outcome": "Yes",
  "side": "BUY",
  "price": "0.547",
  "original_size": "100000000",
  "size_matched": "15000000",
  "status": "live",
  "created_at": 1779355800,
  "order_hash": "0x0011223344556677889900aabbccddeeff00112233445566778899aabbccddee",
  "maker_address": "0xCAFE000000000000000000000000000000000A11",
  "owner": "346629a1-8226-5a85-823f-3a25ae818e10",
  "expiration": "0",
  "order_type": "GTC"
}

Authorizations

XO_API_KEY

string

header

required

L2 HMAC request signature. See Authentication.

Path Parameters

string

required

Response

string

required

Numeric order id, serialised as a string for SDK compatibility (py-clob-client reads id as str).

market

string

required

conditionId

asset_id

string

required

Decimal U256 token id (the canonical CLOB asset_id). Empty string when the gateway has no MarketInfo registered for the order's market.

outcome

enum<string>

required

Available options:

Yes,

No

side

enum<string>

required

Available options:

BUY,

SELL

price

string

required

Trimmed decimal (signed-order price).

original_size

string

required

Signed makerAmount/takerAmount converted to human shares.

size_matched

string

required

Cumulative fills so far, human shares.

status

enum<string>

required

Available options:

live,

delayed

created_at

integer<int64>

required

Unix seconds, bare integer (NOT stringified).

order_hash

string

required

0x-prefixed keccak256 of the EIP-712 typed-data digest.

maker_address

string

required

Wallet address (0x-prefixed hex) that placed the order.

owner

string<uuid>

required

UUIDv5 of the authenticated owner (deterministic from maker_address via XO_WALLET_OWNER_NAMESPACE). Stable across sessions — integrators can pre-compute the mapping.

expiration

string

required

Unix seconds as decimal string. "0" = no expiry (GTC).

order_type

enum<string>

required

Available options:

GTC,

GTD,

FOK,

FAK

Overview

Authentication

Market Data

Markets

Trade

Account

WebSockets

Market Data

Markets

Trade

Account

Authentication

Authorizations

Path Parameters

Response