Get Token Secondary Market Summary

Returns one token's secondary-market summary: the quantity on offer and the price range across its open listings, plus the token itself. It is a single object, not a page. The listings behind it are at List Token Listings. A token with no open listing is refused with 11001, even when the token exists.

Required permission: secondary-market:view

Request

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

Parameters

Name	Type	In	Description
token_id	string	path	Required. Token ID

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/users/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "token_id": "68ae06cfcccf4e8fc19362d1",
  "token": {
    "id": "68ae06cfcccf4e8fc19362d1",
    "category_id": "667e9251ca818a2138ed4885",
    "origin": 0,
    "standard": 0,
    "node_id": "665ae536a6392b75cfd40352",
    "node_name": "Uber",
    "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"
}

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

Response Fields

Field	Type	Description
token_id	string	Token the summary is about
token	object	The token, shaped as in Get Token. node_name is the name of the account node above the issuing node (or the issuing node's own name); the *_rate_change windows are null on this endpoint
total_supply	integer	Sum of quantity over the token's open listings
total_sold_supply	integer	Sum of the sold quantity over those listings
min_price	string	Lowest unit price among the open listings
max_price	string	Highest unit price among the open listings

Errors

Status	Code	Description
400	10016	token_id is not a valid 24-character hex id
400	11001	The token has no open listing (domain 11, secondary market not found)
400	10001	Token not found (domain 5)
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.