List OTC Transactions

Lists every accept and cancel started on one offer, newest first. Get OTC Offer Detail shows only the latest one; this list shows the whole history, for example an accept that failed twice before it settled. The offer's token node must be inside your API key's node subtree. An offer nobody has acted on answers an empty page.

Required permission: otc:view

Request

GET /v2/admin/otcs/{otc_id}/transactions?page={page}&per_page={per_page}

Parameters

Name	Type	In	Description
otc_id	string	path	Required. The offer's own ID (24-character hex)
type	integer	query	1 accepts only, 2 cancels only. Omit for both
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/otcs/6a8b5d02f9129816a6cc79f4/transactions?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6a8b5e13f9129816a6cc7a12",
      "type": 1,
      "status": 3,
      "hash": "0x9f2c1b7e4a0d3c5b6e8f1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f",
      "error": null,
      "message": null,
      "created_at": "2026-08-23T17:43:31.004Z",
      "updated_at": "2026-08-23T17:44:01.220Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	Transactions on this page
data[].id	string	OTC transaction ID
data[].type	integer	1 accept, 2 cancel
data[].status	integer	1 Started, 2 InProgress, 3 Done, 4 Error, 5 PendingReceipt
data[].hash	string or null	On-chain transaction hash, once known
data[].error	string or null	Failure reason when status is 4
data[].message	string or null	Reason given with a cancel, when there was one
data[].created_at	string	When the transaction was started
data[].updated_at	string	Last status change
total	integer	Number of transactions on the offer (after the type filter)
page	integer	Current page
per_page	integer	Items per page

Errors

Status	Code	Description
400	10015	Validation failed — see details. Includes an otc_id that is not a 24-character hex ID and a type other than 1 or 2
400	11001 (domain 11)	Offer not found
400	10001 (domain 5)	The offer's token was not found
400	10001 (domain 2)	The token's node was not found
403	10005 (domain 2)	The token's node is outside your API key's node subtree
500	10000	Unexpected server error

See Errors for the error format and common codes.