List User OTC Offers

Returns the user's own OTC offers on one token, newest first, one row per offer. Offers still awaiting chain confirmation are not listed; open, accepted, canceled and rejected ones are. Take the deal_id of an open offer (status = 0) to cancel it.

Required permission: otc:view

Request

GET /v2/users/{user_id}/otcs/tokens/{token_id}

Parameters

Name	Type	In	Description
user_id	string	path	Required. User ID
token_id	string	path	Required. Token ID
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/users/680c02896d91ca0145cfeb81/otcs/tokens/68ae06cfcccf4e8fc19362d1?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6913a1c455654191dede37f1",
      "deal_id": 12,
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "user_id": "680c02896d91ca0145cfeb81",
      "node_id": "665ae536a6392b75cfd40352",
      "quantity": 3,
      "price": {
        "id": "6913307ec95e268b239b2d8b",
        "amount": "1.1",
        "decimal": 6,
        "symbol": "VUSD",
        "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
      },
      "status": 0,
      "created_at": "2026-11-09T09:40:03Z",
      "updated_at": "2026-11-09T09:41:10Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Response Fields

Field	Type	Description
data[].id	string	Offer ID
data[].deal_id	integer	On-chain deal ID of the offer
data[].token_id	string	Token offered
data[].user_id	string	Seller (this user)
data[].node_id	string	Node that issued the token
data[].quantity	integer	Whole tokens offered
data[].price	object	Unit price: id (currency token ID), amount (decimal string), decimal, symbol, address
data[].status	integer	0 open, 1 accepted, 2 canceled, 3 rejected
data[].created_at	string	When the offer was recorded (RFC 3339)
data[].updated_at	string	Last change (RFC 3339)
total	integer	Number of offers listed
page	integer	Requested page
per_page	integer	Requested page size

Errors

Status	Code	Description
400	10015	Validation failed (page, per_page) — see details
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.