List Secondary Markets

Returns every token that has at least one open secondary-market listing, one row per token, cheapest first (by the lowest listing price). Each row sums the token's open listings and carries the token itself. To see the listings behind a row, use List Token Listings; for one token's row, use Get Token Secondary Market Summary.

A market with nothing listed answers an empty page, not an error.

Required permission: secondary-market:view

Request

GET /v2/users/secondary-markets

Parameters

Name	Type	In	Description
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?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "token": {
        "id": "68ae06cfcccf4e8fc19362d1",
        "category_id": "667e9251ca818a2138ed4885",
        "origin": 0,
        "standard": 0,
        "node_id": "665ae536a6392b75cfd40352",
        "node_name": "",
        "status": 6,
        "is_open_to_secondary_market": true,
        "is_external": false,
        "name": "Sample Token",
        "token_name": "Sample",
        "token_symbol": "STK",
        "value": {
          "token_price": {
            "amount": "1.12",
            "decimal": 6,
            "symbol": "VUSD",
            "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
          }
        },
        "hourly_rate_change": null,
        "daily_rate_change": null,
        "weekly_rate_change": null,
        "monthly_rate_change": null,
        "quarterly_rate_change": null
      },
      "total_supply": 25,
      "total_sold_supply": 0,
      "min_price": "1.2",
      "max_price": "1.5"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

The token object is abridged above; it has the full shape of Get Token.

Response Fields

Field	Type	Description
data[].token_id	string	Token the row is about
data[].token	object	The token, shaped as in Get Token. On this endpoint node_name is empty and the *_rate_change windows are null
data[].total_supply	integer	Sum of quantity over the token's open listings
data[].total_sold_supply	integer	Sum of the sold quantity over those listings
data[].min_price	string	Lowest unit price among the open listings
data[].max_price	string	Highest unit price among the open listings
total	integer	Number of tokens with open listings
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.