List Tokens

Returns one page of the tokens on offer (status 6, listed), newest first, each with its rate changes and the flags that say what may be done with it: is_public, is_open_to_secondary_market, is_open_to_otc and is_external. node_id narrows the listing to one node; omitted, every node's tokens are listed. A filter that matches nothing answers an empty page.

Like Get Token, value and metric are read from the token's latest confirmed history snapshot, so a change still waiting for the chain is not shown yet.

Required permission: token:view

Request

GET /v2/users/tokens

Parameters

Name	Type	In	Description
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100
node_id	string	query	Only the tokens of this node (24-character hex id)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/users/tokens?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "68ae06cfcccf4e8fc19362d1",
      "category_id": "667e9251ca818a2138ed4885",
      "origin": 0,
      "standard": 0,
      "node_id": "665ae536a6392b75cfd40352",
      "created_by_id": "68d280bbc58073cdf5642d20",
      "node_name": "",
      "status": 6,
      "is_mintable": false,
      "is_public": false,
      "is_open_to_secondary_market": true,
      "is_open_to_otc": true,
      "is_external": false,
      "name": "Sample Token",
      "description": "A sample token for demonstration purposes",
      "token_name": "Sample",
      "token_symbol": "STK",
      "node_contract": {
        "diamond_address": "0x730d22ae2267fc5b40520605868ddb48c29331a7"
      },
      "meta": {
        "images": [
          {
            "url": "https://cdn.example.com/tokens/68ae06cfcccf4e8fc19362d1/cover.png",
            "is_default": true
          }
        ],
        "documents": []
      },
      "contract": {
        "address": "0x4ecde4b1b0a8f7a5d5c1e0f1a2b3c4d5e6f78387",
        "tx_hash": "0x9c1f0e7d3b5a2c4e6f8a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e"
      },
      "value": {
        "token_price": {
          "amount": "1.12",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "total_value": {
          "amount": "11200",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "salable_percentage": "100",
        "salable_value": {
          "amount": "11200",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "max_supply": 10000,
        "listed_supply": 8000,
        "sold_supply": 1200
      },
      "distribution_token": null,
      "metric": {
        "term_duration_in_months": 12,
        "min_purchase_quantity": 1,
        "max_purchase_quantity": 100,
        "min_tokens_required_for_rental_income": 10,
        "rental_income": {
          "amount": "50",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "rental_payment_period_in_days": 30,
        "rental_payment_start_date": "2026-12-01T00:00:00Z",
        "listing_date": "2026-11-01T00:00:00Z"
      },
      "hourly_rate_change": null,
      "daily_rate_change": {
        "start_date": "2026-11-09T00:05:12Z",
        "end_date": "2026-11-09T09:40:03Z",
        "start_value": "1.1",
        "end_value": "1.12",
        "rate": "1.81",
        "change_type": 1
      },
      "weekly_rate_change": null,
      "monthly_rate_change": null,
      "quarterly_rate_change": null,
      "created_at": "2026-10-30T12:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Response Fields

Each item has the token shape described on Get Token, with one difference: node_name is empty on this endpoint.

Field	Type	Description
data	array	Tokens on this page
total	integer	Number of listed tokens matching the filter
page	integer	Requested page
per_page	integer	Requested page size

meta.documents[].url is a signed link that opens the document for 15 minutes and is minted on every read; read the token again for a fresh link instead of storing it.

Errors

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

See Errors for the error format and common codes.