List User Token Listings

Returns the user's own secondary-market listings of one token, newest first, one row per listing. Listings still awaiting chain confirmation are not listed; open, completed and canceled ones are. Take the deal_id of an open listing (status = 0) to delist it.

Required permission: secondary-market:view

Request

GET /v2/users/{user_id}/secondary-markets/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/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6913b20e55654191dede3801",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "user_id": "680c02896d91ca0145cfeb81",
      "deal_id": 12,
      "quantity": 10,
      "price": {
        "amount": "12",
        "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	Listing ID
data[].token_id	string	Token listed
data[].user_id	string	Seller (this user)
data[].deal_id	integer	On-chain deal ID of the listing
data[].quantity	integer	Whole tokens in the listing
data[].price	object	Unit price: amount (decimal string), decimal, symbol, address of the payment currency
data[].status	integer	0 open, 1 completed (sold), 2 canceled
data[].created_at	string	When the listing was recorded (RFC 3339)
data[].updated_at	string	Last change (RFC 3339)
total	integer	Number of listings matching
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.