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
Host: 
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2025-12-13T01:37:23.399Z",
      "updatedAt": "2025-12-13T01:37:23.399Z",
      "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": "2025-12-13T01:37:23.399Z",
      "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}

typeall ofRequired

Type of the order execution

string · enumOptional

Type of the order execution

Possible values:

sideall ofRequired

Side of the order indicating buy or sell

string · enumOptional

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
Host: 
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": "2025-12-13T01:37:23.399Z",
  "updatedAt": "2025-12-13T01:37:23.399Z",
  "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": "2025-12-13T01:37:23.399Z",
  "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

get

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

HTTPcURLJavaScriptPython

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

200

Retrieved order

{
  "createdAt": "2025-12-13T01:37:23.399Z",
  "updatedAt": "2025-12-13T01:37:23.399Z",
  "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": "2025-12-13T01:37:23.399Z",
  "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

statusall ofRequired

New status of the order

Example: cancelled

string · enumOptional

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

patch

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

HTTPcURLJavaScriptPython

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

{
  "status": "cancelled"
}

200

Updated order

{
  "createdAt": "2025-12-13T01:37:23.399Z",
  "updatedAt": "2025-12-13T01:37:23.399Z",
  "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": "2025-12-13T01:37:23.399Z",
  "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

get

/market

HTTPcURLJavaScriptPython

GET /market HTTP/1.1
Host: 
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
Host: 
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2025-12-13T01:37:23.399Z",
      "updatedAt": "2025-12-13T01:37:23.399Z",
      "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
Host: 
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": "2025-12-13T01:37:23.399Z",
      "listedAt": "2025-12-13T01:37:23.399Z",
      "delistingInitiatedAt": "2025-12-13T01:37:23.399Z",
      "delistedAt": "2025-12-13T01:37:23.399Z",
      "createdAt": "2025-12-13T01:37:23.399Z",
      "updatedAt": "2025-12-13T01:37:23.399Z"
    }
  ]
}

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
Host: 
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2025-12-13T01:37:23.399Z",
      "updatedAt": "2025-12-13T01:37:23.399Z",
      "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": "2025-12-13T01:37:23.399Z",
      "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

get

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

HTTPcURLJavaScriptPython

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

200

Trade

{
  "createdAt": "2025-12-13T01:37:23.399Z",
  "updatedAt": "2025-12-13T01:37:23.399Z",
  "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": "2025-12-13T01:37:23.399Z",
  "executionOrder": "0006330060-0000000000-0000000019"
}