Market

Get orders

get

Get paginated list of orders for a specific listing

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

Query parameters

modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Possible values:

orderanyOptional

Array of fields and directions to order. Supported fields: createdAt, id, accountAddress, type, side, status, amount, filledAmount, price, placedAt, cancelledAt, expiresAt

Responses

200

Successfully retrieved a list of items.

application/json

get

/market/listings/{listingId}/orders

HTTPcURLJavaScriptPython

GET /market/listings/{listingId}/orders HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "c0e9214c-1788-495e-8b65-b582c9ce0589",
      "marketId": "73c1bf5d-bf6a-49e1-b022-7e84b593a8e8",
      "listingId": "78cfff3e-9825-435d-927f-5d83c2b2a4e1",
      "baseAssetId": "0edbbd22-c7a2-48aa-b6c6-22f2a77051f9",
      "quoteAssetId": "f9b304df-0482-467e-94f3-3029036c98df",
      "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "type": "limit",
      "side": "buy",
      "status": "open",
      "amount": 1,
      "filledAmount": 1,
      "price": 101,
      "placedAt": "2026-03-22T12:30:18.126Z",
      "cancelledAt": "2025-12-06T08:55:12.149Z",
      "expiresAt": "2026-01-10T08:55:12.149Z"
    }
  ]
}

Place order

post

Place an order on a listed asset pair

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

Body

application/json

accountAddressstring · xrp-addressRequired

Investment account address that is placing the order

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

typestring · enumRequired

Type of the order execution

Possible values:

sidestring · enumRequired

Side of the order indicating buy or sell

Possible values:

amountinteger · int64 · min: 1Required

Amount of the base asset to trade

priceinteger · int64 · min: 1Optional

Price per unit of the base asset. Required for limit orders

expiresAtstring · date-timeOptional

Optional expiration date of the order, defaults to 30 days from creation if not provided

Example: 2026-01-10T08:55:12.883Z

Responses

201

Placed order

application/json

post

/market/listings/{listingId}/orders

HTTPcURLJavaScriptPython

POST /market/listings/{listingId}/orders HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "type": "limit",
  "side": "buy",
  "amount": 1,
  "price": 1,
  "expiresAt": "2026-01-10T08:55:12.883Z"
}

201

Placed order

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "c0e9214c-1788-495e-8b65-b582c9ce0589",
  "marketId": "73c1bf5d-bf6a-49e1-b022-7e84b593a8e8",
  "listingId": "78cfff3e-9825-435d-927f-5d83c2b2a4e1",
  "baseAssetId": "0edbbd22-c7a2-48aa-b6c6-22f2a77051f9",
  "quoteAssetId": "f9b304df-0482-467e-94f3-3029036c98df",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "type": "limit",
  "side": "buy",
  "status": "open",
  "amount": 1,
  "filledAmount": 1,
  "price": 101,
  "placedAt": "2026-03-22T12:30:18.126Z",
  "cancelledAt": "2025-12-06T08:55:12.149Z",
  "expiresAt": "2026-01-10T08:55:12.149Z"
}

Get order

get

Get specific order by its ID for a specific listing

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

orderIdstring · uuidRequired

Order UUID identifier, global in scope of TSS

Example: 1f37a856-1f74-4b8a-9505-9b547f315419

Responses

200

Retrieved order

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

Order UUID identifier, global in scope of TSS

Example: c0e9214c-1788-495e-8b65-b582c9ce0589

marketIdstring · uuidRequired

Market identifier where the order is placed

Example: 73c1bf5d-bf6a-49e1-b022-7e84b593a8e8

listingIdstring · uuidRequired

Identifier of the market listing (trading pair)

Example: 78cfff3e-9825-435d-927f-5d83c2b2a4e1

baseAssetIdstring · uuidRequired

Base asset identifier in the trading pair

Example: 0edbbd22-c7a2-48aa-b6c6-22f2a77051f9

quoteAssetIdstring · uuidRequired

Quote asset identifier in the trading pair

Example: f9b304df-0482-467e-94f3-3029036c98df

accountAddressstring · xrp-addressRequired

Investment account address that placed the order

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

typestring · enumRequired

Type of the order execution

Possible values:

sidestring · enumRequired

Side of the order indicating buy or sell

Possible values:

statusstring · enumRequired

Status of the order lifecycle:

• open: Order is active and not yet fully filled or cancelled
• filled: Order has been fully filled/executed
• rejected: Order could not be executed
• cancelled: Order has been cancelled by the user or system
• expired: Order has reached its expiration time without being fully filled

Possible values:

amountinteger · int64Required

Amount of the base asset to trade

Example: 1

filledAmountinteger · int64Required

Amount of the base asset that is filled

Example: 1

priceinteger · int64Required

Price per unit of the base asset, denominated in the quote asset

Example: 101

placedAtstring · date-timeRequired

Placement date of the order

cancelledAtstring · date-time · nullableRequired

Cancellation date of the order

Example: 2025-12-06T08:55:12.149Z

expiresAtstring · date-time · nullableRequired

Expiration date of the order

Example: 2026-01-10T08:55:12.149Z

get

/market/listings/{listingId}/orders/{orderId}

HTTPcURLJavaScriptPython

GET /market/listings/{listingId}/orders/{orderId} HTTP/1.1
Accept: */*

200

Retrieved order

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "c0e9214c-1788-495e-8b65-b582c9ce0589",
  "marketId": "73c1bf5d-bf6a-49e1-b022-7e84b593a8e8",
  "listingId": "78cfff3e-9825-435d-927f-5d83c2b2a4e1",
  "baseAssetId": "0edbbd22-c7a2-48aa-b6c6-22f2a77051f9",
  "quoteAssetId": "f9b304df-0482-467e-94f3-3029036c98df",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "type": "limit",
  "side": "buy",
  "status": "open",
  "amount": 1,
  "filledAmount": 1,
  "price": 101,
  "placedAt": "2026-03-22T12:30:18.126Z",
  "cancelledAt": "2025-12-06T08:55:12.149Z",
  "expiresAt": "2026-01-10T08:55:12.149Z"
}

Cancel order

patch

Cancel an open order on a listed pair

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

orderIdstring · uuidRequired

Order UUID identifier, global in scope of TSS

Example: 5f7f3b9f-a8ad-4d27-b256-b192231b2451

Body

application/json

statusstring · enumRequired

Status of the order lifecycle:

• open: Order is active and not yet fully filled or cancelled
• filled: Order has been fully filled/executed
• rejected: Order could not be executed
• cancelled: Order has been cancelled by the user or system
• expired: Order has reached its expiration time without being fully filled

Possible values:

Responses

200

Updated order

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

Order UUID identifier, global in scope of TSS

Example: c0e9214c-1788-495e-8b65-b582c9ce0589

marketIdstring · uuidRequired

Market identifier where the order is placed

Example: 73c1bf5d-bf6a-49e1-b022-7e84b593a8e8

listingIdstring · uuidRequired

Identifier of the market listing (trading pair)

Example: 78cfff3e-9825-435d-927f-5d83c2b2a4e1

baseAssetIdstring · uuidRequired

Base asset identifier in the trading pair

Example: 0edbbd22-c7a2-48aa-b6c6-22f2a77051f9

quoteAssetIdstring · uuidRequired

Quote asset identifier in the trading pair

Example: f9b304df-0482-467e-94f3-3029036c98df

accountAddressstring · xrp-addressRequired

Investment account address that placed the order

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

typestring · enumRequired

Type of the order execution

Possible values:

sidestring · enumRequired

Side of the order indicating buy or sell

Possible values:

statusstring · enumRequired

Status of the order lifecycle:

• open: Order is active and not yet fully filled or cancelled
• filled: Order has been fully filled/executed
• rejected: Order could not be executed
• cancelled: Order has been cancelled by the user or system
• expired: Order has reached its expiration time without being fully filled

Possible values:

amountinteger · int64Required

Amount of the base asset to trade

Example: 1

filledAmountinteger · int64Required

Amount of the base asset that is filled

Example: 1

priceinteger · int64Required

Price per unit of the base asset, denominated in the quote asset

Example: 101

placedAtstring · date-timeRequired

Placement date of the order

cancelledAtstring · date-time · nullableRequired

Cancellation date of the order

Example: 2025-12-06T08:55:12.149Z

expiresAtstring · date-time · nullableRequired

Expiration date of the order

Example: 2026-01-10T08:55:12.149Z

patch

/market/listings/{listingId}/orders/{orderId}

HTTPcURLJavaScriptPython

PATCH /market/listings/{listingId}/orders/{orderId} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "status": "cancelled"
}

200

Updated order

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "c0e9214c-1788-495e-8b65-b582c9ce0589",
  "marketId": "73c1bf5d-bf6a-49e1-b022-7e84b593a8e8",
  "listingId": "78cfff3e-9825-435d-927f-5d83c2b2a4e1",
  "baseAssetId": "0edbbd22-c7a2-48aa-b6c6-22f2a77051f9",
  "quoteAssetId": "f9b304df-0482-467e-94f3-3029036c98df",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "type": "limit",
  "side": "buy",
  "status": "open",
  "amount": 1,
  "filledAmount": 1,
  "price": 101,
  "placedAt": "2026-03-22T12:30:18.126Z",
  "cancelledAt": "2025-12-06T08:55:12.149Z",
  "expiresAt": "2026-01-10T08:55:12.149Z"
}

Get market

get

Get market details and current status

Responses

200

Market details

application/json

statusstring · enumRequired

Status of the market:

• open - market is open and accepting trades
• closed - market is closed and not accepting trades
• halted - market is halted and not accepting trades, until unhalted

Possible values:

namestringRequired

Name of the market

Example: Axiology DLT market

identifierCodestring · iso-10383 · min: 4 · max: 4Required

Market Identifier Code (MIC) as per ISO 10383 standard

Example: AXIOPattern: ^[A-Z]{4}$

tzstring · iana-time-zoneRequired

Time zone (IANA) that market operates in

Example: Europe/Vilnius

get

/market

HTTPcURLJavaScriptPython

GET /market HTTP/1.1
Accept: */*

200

Market details

{
  "status": "open",
  "name": "Axiology DLT market",
  "identifierCode": "AXIO",
  "tz": "Europe/Vilnius",
  "workingHours": {
    "monday": {
      "open": "08:00",
      "close": "16:00"
    },
    "tuesday": {
      "open": "08:00",
      "close": "16:00"
    },
    "wednesday": {
      "open": "08:00",
      "close": "16:00"
    },
    "thursday": {
      "open": "08:00",
      "close": "16:00"
    },
    "friday": {
      "open": "08:00",
      "close": "16:00"
    },
    "saturday": {
      "open": "08:00",
      "close": "16:00"
    },
    "sunday": {
      "open": "08:00",
      "close": "16:00"
    }
  }
}

Get market halts

get

Get all market halts

Query parameters

modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Possible values:

sizenumber · min: 1OptionalDefault: 10Example: 10

pagenumber · min: 1OptionalDefault: 1Example: 1

Responses

200

Successfully retrieved a list of items.

application/json

get

/market/halts

HTTPcURLJavaScriptPython

GET /market/halts HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "55dd9d7f-69a7-426e-bf08-344d1a454670",
      "marketId": "d33bda3e-0214-4d1a-ac91-f167a4a17775",
      "status": "ended",
      "startedAt": "2025-12-07T08:55:12.068Z",
      "reason": "Volatility",
      "endedAt": "2025-12-09T08:55:12.068Z",
      "resumeReason": "Market stabilized"
    }
  ]
}

Get listings

get

Get paginated list of market listings

Query parameters

modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Possible values:

orderanyOptional

Array of fields and directions to order. Supported fields: status, initiatedAt, listedAt, delistingInitiatedAt, createdAt, updatedAt

Responses

200

Successfully retrieved a list of items.

application/json

get

/market/listings

HTTPcURLJavaScriptPython

GET /market/listings HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "id": "2834f686-5af9-4fb4-a348-28591a1e6550",
      "baseAssetId": "b14a18af-f55d-474e-b544-1a0caf97fc1c",
      "quoteAssetId": "6514ce64-f4d8-4f41-8cd4-dd1b575562ee",
      "status": "listed",
      "initiatedAt": "2026-03-22T12:30:18.126Z",
      "listedAt": "2026-03-22T12:30:18.126Z",
      "delistingInitiatedAt": "2026-03-22T12:30:18.126Z",
      "delistedAt": "2026-03-22T12:30:18.126Z",
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z"
    }
  ]
}

Get trades

get

Get paginated list of trades for a market listing

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

Query parameters

modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Possible values:

orderanyOptional

Array of fields and directions to order. Supported fields: createdAt, sellAccountAddress, buyAccountAddress, amount, price, totalPrice, executedAt, executionOrder

Responses

200

Successfully retrieved a list of items.

application/json

get

/market/listing/{listingId}/trades

HTTPcURLJavaScriptPython

GET /market/listing/{listingId}/trades HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "c87fa393-70b4-4b22-b12a-51d22b6bd1a5",
      "marketId": "6909ab8e-f753-4c8f-8b5c-c00edc4dea7c",
      "listingId": "d182e7a6-6e34-4f38-9f24-475705a9e124",
      "baseAssetId": "9bdf7618-cd67-44d3-9165-0f9e6070d677",
      "quoteAssetId": "1835649e-9948-44c1-8be0-8ef1de4da9d1",
      "sellOrderId": "abc22e2b-67a2-4946-a954-f8a0379582fb",
      "sellAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "buyOrderId": "6f3f5998-cd88-4cfd-ad3e-dcad6e67dac4",
      "buyAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "amount": 2,
      "price": 101,
      "totalPrice": 202,
      "executedAt": "2026-03-22T12:30:18.126Z",
      "executionOrder": "0006330060-0000000000-0000000019"
    }
  ]
}

Get trade

get

Get a single trade by its ID for a market listing

Path parameters

listingIdstring · uuidRequired

Listing UUID identifier, global in scope of TSS

Example: 6b7ccbb6-e2fc-4617-80a5-5e10114370a5

tradeIdstring · uuidRequired

Trade UUID identifier, global in scope of TSS

Example: 9b17c64e-069d-4f4f-9ed9-9ffd34e2df6f

Responses

200

Trade

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

Trade UUID identifier, global in scope of TSS

Example: c87fa393-70b4-4b22-b12a-51d22b6bd1a5

marketIdstring · uuidRequired

Market identifier where the trade occurred

Example: 6909ab8e-f753-4c8f-8b5c-c00edc4dea7c

listingIdstring · uuidRequired

Identifier of the market listing (trading pair)

Example: d182e7a6-6e34-4f38-9f24-475705a9e124

baseAssetIdstring · uuidRequired

Base asset identifier in the trading pair

Example: 9bdf7618-cd67-44d3-9165-0f9e6070d677

quoteAssetIdstring · uuidRequired

Quote asset identifier in the trading pair

Example: 1835649e-9948-44c1-8be0-8ef1de4da9d1

sellOrderIdstring · uuidRequired

UUID identifier of the sell order

Example: abc22e2b-67a2-4946-a954-f8a0379582fb

sellAccountAddressstring · xrp-addressRequired

Sell investor's account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

buyOrderIdstring · uuidRequired

UUID identifier of the buy order

Example: 6f3f5998-cd88-4cfd-ad3e-dcad6e67dac4

buyAccountAddressstring · xrp-addressRequired

Buy investor's account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

amountinteger · int64Required

Amount of the base asset traded

Example: 2

priceinteger · int64Required

Price per unit of the base asset, denominated in the quote asset

Example: 101

totalPriceinteger · int64Required

Actual total price of the trade

Example: 202

executedAtstring · date-timeRequired

Timestamp when the trade was executed

executionOrderstringRequired

Order in which the trade was executed

Example: 0006330060-0000000000-0000000019

get

/market/listing/{listingId}/trades/{tradeId}

HTTPcURLJavaScriptPython

GET /market/listing/{listingId}/trades/{tradeId} HTTP/1.1
Accept: */*

200

Trade

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "c87fa393-70b4-4b22-b12a-51d22b6bd1a5",
  "marketId": "6909ab8e-f753-4c8f-8b5c-c00edc4dea7c",
  "listingId": "d182e7a6-6e34-4f38-9f24-475705a9e124",
  "baseAssetId": "9bdf7618-cd67-44d3-9165-0f9e6070d677",
  "quoteAssetId": "1835649e-9948-44c1-8be0-8ef1de4da9d1",
  "sellOrderId": "abc22e2b-67a2-4946-a954-f8a0379582fb",
  "sellAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "buyOrderId": "6f3f5998-cd88-4cfd-ad3e-dcad6e67dac4",
  "buyAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "amount": 2,
  "price": 101,
  "totalPrice": 202,
  "executedAt": "2026-03-22T12:30:18.126Z",
  "executionOrder": "0006330060-0000000000-0000000019"
}