Skip to Content
SDK ReferenceTypeScript APIorderbook
SDK reference (auto)

orderbook

Classes

SharedOrderbookClient

Constructors

Constructor
new SharedOrderbookClient(baseUrl, opts?): SharedOrderbookClient;
Parameters
ParameterType
baseUrlstring
optsClientOpts
Returns

SharedOrderbookClient

Methods

isOnline()
isOnline(): Promise<boolean>;
Returns

Promise<boolean>

getStats()
getStats(): Promise<SharedOrderbookStats | null>;
Returns

Promise<SharedOrderbookStats | null>

getRelayers()
getRelayers(): Promise<SharedRelayer[]>;
Returns

Promise<SharedRelayer[]>

getOrders()
getOrders(limit?, status?): Promise<SharedOrder[]>;
Parameters
ParameterTypeDefault value
limitnumber500
status?SharedOrderStatus | "all"undefined
Returns

Promise<SharedOrder[]>

getOrdersWithCounts()
getOrdersWithCounts(limit?, status?): Promise<{ orders: SharedOrder[]; counts: Partial<Record<SharedOrderStatus, number>>; }>;

Variant that returns the full payload including the per-status counts the bucket-tab UI needs. Kept as a separate method so the common getOrders() call site doesn’t have to destructure a wrapper every time.

Parameters
ParameterTypeDefault value
limitnumber500
status?SharedOrderStatus | "all"undefined
Returns

Promise<{ orders: SharedOrder[]; counts: Partial<Record<SharedOrderStatus, number>>; }>

getOrdersByPair()
getOrdersByPair(pair): Promise<SharedOrder[]>;
Parameters
ParameterType
pairstring
Returns

Promise<SharedOrder[]>

Interfaces

SharedOrderbookStats

Properties

PropertyType
totalOrdersnumber
pairsnumber
relayersnumber

SharedRelayer

Properties

PropertyType
addressstring
urlstring
name?string
orderCountnumber
lastHeartbeatnumber

SharedOrder

Properties

PropertyTypeDescription
idstring-
relayerstring-
relayerUrlstring-
noncestring-
pubKeyAxstring-
sellTokenstring-
buyTokenstring-
sellAmountstring-
buyAmountstring-
minFillAmountstring-
maxFeenumber-
expirynumber-
createdAtnumber-
chainId?numberEVM network this order lives on. Present on every row the multi-network backend returns; undefined from a legacy backend.
status?SharedOrderStatusPresent when the API was queried with status=<bucket> or status=all. Undefined for legacy callers reading the default “open”-only view — those rows are always open by definition.

Type Aliases

SharedOrderStatus

type SharedOrderStatus = "open" | "matched" | "cancelled" | "expired";

Lifecycle status the shared orderbook tracks server-side. Mirrors @scatter-dex/types’ OrderStatus union — duplicated here so the SDK consumer doesn’t have to pull the types-only package.

Last updated on