OTC Trades FOP

get

Retrieve a list of OTC Trades FOP available in the system

Query parameters
modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Default: ORPossible values:
orderanyOptional

Array of fields and directions to order. Supported fields: createdAt, status, amount

Responses
200

Successfully retrieved a list of items.

application/json
Responseall of
get
/otc-trades-fop
GET /otc-trades-fop HTTP/1.1
Host: 
Accept: */*
200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:00:00.000Z",
      "id": "b046afb3-01f2-417b-8c60-a9e531e76c45",
      "status": "initiated",
      "assetId": "c6dbe04e-3f1e-4bbb-9601-043d61bef062",
      "amount": 200,
      "initiatorAccountAddress": "text",
      "initiatorBrokerId": "7d3a33ef-fea9-4eb0-a4dd-1c770baffdf4",
      "acceptorAccountAddress": "text",
      "acceptorBrokerId": "30faf888-1597-4f65-a231-3e69d9e9db47",
      "reason": "internal",
      "tradedAt": "2025-10-26T12:01:29.078Z"
    }
  ]
}

Initiate FOP OTC trade

post

Initiate a Free-of-Payment Over-The-Counter trade, between two accounts

Body
initiatorAccountAddressstringRequired

Initiator account address

Pattern: r[0-9a-zA-Z]{24,34}
assetIdstring · uuidRequired

Initiator sending asset id

Example: 6cd122ad-8f44-4e56-ad25-4a51b5ac0cea
amountinteger · int64Required

Initiator sending asset amount in units

Example: 200
acceptorAccountAddressstringRequired

Accepter account address

Pattern: r[0-9a-zA-Z]{24,34}
reasonstring · enumOptional

Reason for this trade, required for currency transactions

Possible values:
tradedAtstring · date-timeRequired

Trade day in ISO 8601 format YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ

Example: 2037-10-01
Responses
201

Initiated FOP OTC trade

application/json
post
/otc-trades-fop
POST /otc-trades-fop HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 169

{
  "initiatorAccountAddress": "text",
  "assetId": "6cd122ad-8f44-4e56-ad25-4a51b5ac0cea",
  "amount": 200,
  "acceptorAccountAddress": "text",
  "reason": "error",
  "tradedAt": "2037-10-01"
}
201

Initiated FOP OTC trade

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "b046afb3-01f2-417b-8c60-a9e531e76c45",
  "status": "initiated",
  "assetId": "c6dbe04e-3f1e-4bbb-9601-043d61bef062",
  "amount": 200,
  "initiatorAccountAddress": "text",
  "initiatorBrokerId": "7d3a33ef-fea9-4eb0-a4dd-1c770baffdf4",
  "acceptorAccountAddress": "text",
  "acceptorBrokerId": "30faf888-1597-4f65-a231-3e69d9e9db47",
  "reason": "internal",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}
get

Get OTC Trade as FOP.

Path parameters
otcTradeFopIdstring · uuidRequired

UUIDv4 of OTC FOP Trade

Example: 2a50bfbf-5962-4b3f-94d8-5a95a7342001
Responses
200

Retrieve full information about a single OTC Trade Fop

application/json
get
/otc-trades-fop/{otcTradeFopId}
GET /otc-trades-fop/{otcTradeFopId} HTTP/1.1
Host: 
Accept: */*
200

Retrieve full information about a single OTC Trade Fop

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "b046afb3-01f2-417b-8c60-a9e531e76c45",
  "status": "initiated",
  "assetId": "c6dbe04e-3f1e-4bbb-9601-043d61bef062",
  "amount": 200,
  "initiatorAccountAddress": "text",
  "initiatorBrokerId": "7d3a33ef-fea9-4eb0-a4dd-1c770baffdf4",
  "acceptorAccountAddress": "text",
  "acceptorBrokerId": "30faf888-1597-4f65-a231-3e69d9e9db47",
  "reason": "internal",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}

Change FOP OTC trade

patch

Accept/Cancel/Reject a Free-Of-Payment Over-The-Counter trade

Path parameters
otcTradeFopIdstring · uuidRequired

UUIDv4 of OTC FOP Trade

Example: e1563fd5-962c-44d9-881c-3e2b6551e262
Body
statusstring · enumRequired

Status of the trade

Example: completedPossible values:
Responses
200

Changed FOP OTC trade

application/json
patch
/otc-trades-fop/{otcTradeFopId}
PATCH /otc-trades-fop/{otcTradeFopId} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "status": "completed"
}
200

Changed FOP OTC trade

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "b046afb3-01f2-417b-8c60-a9e531e76c45",
  "status": "initiated",
  "assetId": "c6dbe04e-3f1e-4bbb-9601-043d61bef062",
  "amount": 200,
  "initiatorAccountAddress": "text",
  "initiatorBrokerId": "7d3a33ef-fea9-4eb0-a4dd-1c770baffdf4",
  "acceptorAccountAddress": "text",
  "acceptorBrokerId": "30faf888-1597-4f65-a231-3e69d9e9db47",
  "reason": "internal",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}
PreviousOTC Trades DVPNextOwnership Changes