Get Token by ID

Retrieves detailed information about a specific token by its ID.

Request

GET /v2/admin/tokens/{tokenID}

Parameters

Name	Type	In	Description
tokenID	string	path	Required. The ID of the token to retrieve

Headers

Name	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. Must be application/json

Example

curl --location --request GET '\{\{baseUrl\}\}/v2/admin/tokens/68aeb272d9336c619ce249f6' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

A successful response returns detailed token information:

{
  "id": "68aeb272d9336c619ce249f6",
  "category_id": "667e9251ca818a2138ed4915",
  "type": 1,
  "node_id": "6810a8e5b45680e7d2f95bad",
  "node_name": "Oha",
  "listing_contract_address": "",
  "status": 6,
  "name": "Hiper House 23 (Yeni)",
  "description": "Hiper house token 2",
  "token_name": "TokenName Yeni",
  "token_symbol": "HPHE",
  "node_contract": {
    "diamond_address": null
  },
  "meta": {
    "images": [
      {
        "url": "https://fra1.digitaloceanspaces.com/apex/dev/token/680a89d5dcaf5609fe5374cd/images/af8fd0e2-d3c9-4b15-982c-13ed669fc904.jpeg",
        "is_default": true
      },
      {
        "url": "https://fra1.digitaloceanspaces.com/apex/dev/token/689c4fd02e09b543ffed72a0/images/d38c0e8e-f327-491f-8a6f-170bb09777ff.png",
        "is_default": false
      }
    ],
    "documents": [
      {
        "id": "689ee76a5ca4c34ad0bc346d",
        "name": "c8985d4a-0855-4f2c-913a-27b2871ac556.pdf",
        "url": "https://fra1.digitaloceanspaces.com/apex/dev/token/689c4fd02e09b543ffed72a0/documents/9c7ce825-729c-4af2-a91a-44a08b66ddb1.pdf",
        "type": 1
      }
    ]
  },
  "contract": {
    "address": "0xaaf6574c752a8cb8e4f220afc195240f347ffe95",
    "tx_hash": ""
  },
  "value": {
    "token_price": {
      "amount": 1000,
      "decimal": 6,
      "symbol": "USDT",
      "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
    },
    "total_value": {
      "amount": 0,
      "decimal": 0,
      "symbol": "",
      "address": ""
    },
    "salable_percentage": 0,
    "salable_value": {
      "amount": 0,
      "decimal": 0,
      "symbol": "",
      "address": ""
    },
    "max_supply": 300,
    "listed_supply": 300,
    "sold_supply": 0
  },
  "is_public": false,
  "is_open_to_otc": false,
  "is_open_to_secondary_market": true,
  "oracle": {
    "id": "oracle-id",
    "code": "oracle-code"
  },
  "distribution_token": {
    "agent": 1,
    "integration": {
      "chain_id": 0,
      "abi": "",
      "contract_address": "",
      "function_name": "",
      "currency_token_address": "",
      "is_approved": false,
      "args": []
    }
  },
  "metric": {
    "term_duration_in_months": 10,
    "min_purchase_quantity": 1,
    "max_purchase_quantity": 30,
    "min_tokens_required_for_rental_income": 10,
    "rental_income": {
      "amount": 10,
      "decimal": 6,
      "symbol": "USDT",
      "address": ""
    },
    "rental_payment_period_in_days": 10,
    "rental_payment_start_date": null,
    "listing_date": null
  },
  "created_at": "2025-08-27T07:23:30.666Z"
}

Response Fields

Token Object Fields

Field	Type	Description
id	string	Unique identifier for the token
category_id	string	Category ID of the token
type	integer	Token type (0 = standard, 1 = special)
node_id	string	ID of the associated node
node_name	string	Name of the associated node
listing_contract_address	string	Listing contract address
status	integer	Status code of the token
name	string	Display name of the token
description	string	Description of the token
token_name	string	Token name
token_symbol	string	Token symbol
node_contract	object	Node contract addresses
meta	object	Metadata including images and documents
contract	object	Token contract information
value	object	Token value and supply information
is_public	boolean	Whether the token allows public transfers
is_open_to_otc	boolean	Whether the token is open to OTC trading
is_open_to_secondary_market	boolean	Whether the token is open to secondary market
oracle	object/null	Oracle configuration (id, code) for price feeds
distribution_token	object/null	Distribution token information including integration config
metric	object	Token metrics and rental information
created_at	string	ISO 8601 timestamp when the token was created

Node Contract Object Fields

Field	Type	Description
diamond_address	string/null	Diamond contract address (may be null)

Meta Object Fields

Field	Type	Description
images	array	Array of image objects
documents	array	Array of document objects

Image Object Fields

Field	Type	Description
url	string	URL of the image
is_default	boolean	Whether this is the default image

Document Object Fields

Field	Type	Description
id	string	Document ID
name	string	Document name
url	string	Document URL
type	integer	Document type

Contract Object Fields

Field	Type	Description
address	string	Token contract address
tx_hash	string	Transaction hash

Value Object Fields

Field	Type	Description
token_price	object	Token price information
total_value	object	Total value information
salable_percentage	number	Percentage of tokens that are salable
salable_value	object	Salable value information
max_supply	number	Maximum supply of tokens
listed_supply	number	Number of tokens listed
sold_supply	number	Number of tokens sold

Price Object Fields

Field	Type	Description
amount	number	Price amount
decimal	integer	Number of decimal places
symbol	string	Price symbol (e.g., USDT)
address	string	Contract address of the price token

Distribution Token Integration Object Fields

Field	Type	Description
chain_id	integer	Blockchain chain ID
abi	string	Contract ABI for integration
contract_address	string	Integration contract address
function_name	string	Contract function to call
currency_token_address	string	Currency token contract address
is_approved	boolean	Whether integration is approved
args	array	Integration arguments

Metric Object Fields

Field	Type	Description
term_duration_in_months	number/null	Duration of the token term in months
min_purchase_quantity	number	Minimum purchase quantity
max_purchase_quantity	number	Maximum purchase quantity
min_tokens_required_for_rental_income	number	Minimum tokens required for rental income
rental_income	object	Rental income information
rental_payment_period_in_days	number	Rental payment period in days
rental_payment_start_date	string/null	ISO 8601 timestamp of rental payment start date
listing_date	string/null	ISO 8601 timestamp of listing date

Token Types

Value	Description
0	Standard Token
1	Special Token

Status Codes

Status Code	Description
200	Success - Token information retrieved successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Token ID does not exist
500	Internal Server Error