OTC Trades DVP

get

Retrieve a list of OTC Trades DVP 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, initiatorSendAmount, acceptorSendAmount

Responses
200

Successfully retrieved a list of items.

application/json
Responseall of
get
/otc-trades-dvp
GET /otc-trades-dvp 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": "0c59ee46-b1b7-4988-8fc6-398d52869075",
      "status": "initiated",
      "initiatorAccountAddress": "text",
      "initiatorSendAssetId": "eb9ca72d-fb27-43d2-b67c-6646016055a8",
      "initiatorSendAmount": 200,
      "initiatorBrokerId": "e0b3c2df-c179-4d8d-9f82-3e2703694928",
      "acceptorAccountAddress": "text",
      "acceptorSendAssetId": "53735889-2185-47ca-8cec-4df8c96451e2",
      "acceptorSendAmount": 100,
      "acceptorBrokerId": "92a1631d-8a3f-4a78-9ae2-5306a16bcf77",
      "tradedAt": "2025-10-26T12:01:29.078Z"
    }
  ]
}

Initiate DVP OTC trade

post

Initiate a Delivery-Versus-Payment Over-The-Counter trade, between two accounts

Body
initiatorAccountAddressstringRequired

Initiator account address

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

Initiator sending asset id

Example: fb3271ac-a99f-4459-9f83-cabaff55f7b6
initiatorSendAmountinteger · int64Required

Initiator sending asset amount in units

Example: 200
acceptorAccountAddressstringRequired

Accepter account address

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

Acceptor sending asset id

Example: 60b0c3b6-3310-4abd-8bc1-a2da13bd6360
acceptorSendAmountinteger · int64Required

Accepter sending asset amount in units

Example: 100
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 DVP OTC trade

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

{
  "initiatorAccountAddress": "text",
  "initiatorSendAssetId": "fb3271ac-a99f-4459-9f83-cabaff55f7b6",
  "initiatorSendAmount": 200,
  "acceptorAccountAddress": "text",
  "acceptorSendAssetId": "60b0c3b6-3310-4abd-8bc1-a2da13bd6360",
  "acceptorSendAmount": 100,
  "tradedAt": "2037-10-01"
}
201

Initiated DVP OTC trade

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "0c59ee46-b1b7-4988-8fc6-398d52869075",
  "status": "initiated",
  "initiatorAccountAddress": "text",
  "initiatorSendAssetId": "eb9ca72d-fb27-43d2-b67c-6646016055a8",
  "initiatorSendAmount": 200,
  "initiatorBrokerId": "e0b3c2df-c179-4d8d-9f82-3e2703694928",
  "acceptorAccountAddress": "text",
  "acceptorSendAssetId": "53735889-2185-47ca-8cec-4df8c96451e2",
  "acceptorSendAmount": 100,
  "acceptorBrokerId": "92a1631d-8a3f-4a78-9ae2-5306a16bcf77",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}
get

Get OTC Trade as DVP.

Path parameters
otcTradeDvpIdstring · uuidRequired

UUIDv4 of OTC DVP Trade

Example: 33724516-0359-486a-9ca4-f5f67014c134
Responses
200

Retrieve full information about a single OTC Trade DVP

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

Retrieve full information about a single OTC Trade DVP

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "0c59ee46-b1b7-4988-8fc6-398d52869075",
  "status": "initiated",
  "initiatorAccountAddress": "text",
  "initiatorSendAssetId": "eb9ca72d-fb27-43d2-b67c-6646016055a8",
  "initiatorSendAmount": 200,
  "initiatorBrokerId": "e0b3c2df-c179-4d8d-9f82-3e2703694928",
  "acceptorAccountAddress": "text",
  "acceptorSendAssetId": "53735889-2185-47ca-8cec-4df8c96451e2",
  "acceptorSendAmount": 100,
  "acceptorBrokerId": "92a1631d-8a3f-4a78-9ae2-5306a16bcf77",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}

Change DVP OTC trade

patch

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

Path parameters
otcTradeDvpIdstring · uuidRequired

UUIDv4 of OTC DVP Trade

Example: 3e41e416-7f41-4f02-98ff-b4f5a5de1b3c
Body
statusstring · enumRequired

Status of the trade

Example: completedPossible values:
Responses
200

Changed DVP OTC trade

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

{
  "status": "completed"
}
200

Changed DVP OTC trade

{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "id": "0c59ee46-b1b7-4988-8fc6-398d52869075",
  "status": "initiated",
  "initiatorAccountAddress": "text",
  "initiatorSendAssetId": "eb9ca72d-fb27-43d2-b67c-6646016055a8",
  "initiatorSendAmount": 200,
  "initiatorBrokerId": "e0b3c2df-c179-4d8d-9f82-3e2703694928",
  "acceptorAccountAddress": "text",
  "acceptorSendAssetId": "53735889-2185-47ca-8cec-4df8c96451e2",
  "acceptorSendAmount": 100,
  "acceptorBrokerId": "92a1631d-8a3f-4a78-9ae2-5306a16bcf77",
  "tradedAt": "2025-10-26T12:01:29.078Z"
}
PreviousOperatorNextOTC Trades FOP