List Token Listings

Returns the open secondary-market listings of one token, newest first, one row per listing. These are the offers behind Get Token Secondary Market Summary. Take a listing's deal_id and quantity to quote or buy it; a listing is bought whole.

A token with nothing listed answers an empty page, not a 404.

Required permission: secondary-market:view

Request

GET /v2/users/secondary-markets/tokens/{token_id}/listings

Parameters

Name	Type	In	Description
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/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1/listings?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6913b20e55654191dede3801",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "user_id": "680c02896d91ca0145cfeb82",
      "deal_id": 13,
      "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
data[].deal_id	integer	On-chain deal ID; send it to the quote and buy endpoints
data[].quantity	integer	Whole tokens in the listing; a buy must send exactly this quantity
data[].price	object	Unit price: amount (decimal string), decimal, symbol, address of the payment currency
data[].status	integer	Always 0 (open) on this endpoint
data[].created_at	string	When the listing was recorded (RFC 3339)
data[].updated_at	string	Last change (RFC 3339)
total	integer	Number of open listings of the token
page	integer	Requested page
per_page	integer	Requested page size

Errors

Status	Code	Description
400	10015	Validation failed (page, per_page) — see details
400	10016	token_id is not a valid 24-character hex id
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.