Get Token Data

Retrieve comprehensive token information including metadata, liquidity events, social links, holder data, and image hashes in a single request.

Endpoint

GET https://enterprise.guardis.io/v1/token/{token_address}

Authentication

Include your API key in the X-API-Key header.

X-API-Key: your_api_key_here

---

Path Parameters

Parameter	Type	Required	Description
token_address	string	Yes	The mint address of the token

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/token/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "x-api-key: your_api_key_here"

---

Response Format

{
  "token": {
    "token_address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "creator_address": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
    "total_supply": "1000000000.000000",
    "name": "Bonk",
    "symbol": "BONK",
    "decimals": 5,
    "mint_authority_address": null,
    "freeze_authority_address": null,
    "creation_slot": 171857304,
    "created_at": "2024-01-15T10:32:08.000Z",
  },
  "metadata": {
    "update_authority_address": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
    "uri": "https://arweave.net/abc123",
    "uri_metadata": {
      "name": "Bonk",
      "symbol": "BONK",
      "description": "The first Solana dog coin",
      "image": "https://arweave.net/xyz789"
    },
    "creators": [
      {
        "address": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
        "verified": true,
        "share": 100
      }
    ],
    "primary_sale_happened": true,
    "is_mutable": false,
    "edition_nonce": null,
    "token_standard": "Fungible",
    "collection": null,
    "uses": null,
    "collection_details": null,
    "programmable_config": null,
    "seller_fee_basis_points": 0
  },
  "liquidity_event": {
    "pair_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "initial_liquidity_solana_amount": "85.500000000",
    "initial_liquidity_token_amount": "500000000.000000",
    "initial_liquidity_value_usd": "15420.75",
    "initial_liquidity_add_slot_number": 171857310,
    "initial_liquidity_add_slot_timestamp": "2024-01-15T10:32:15.000Z",
    "block_time_at": "2024-01-15T10:32:15.000Z"
  },
  "social_links": [
    {
      "platform": "twitter",
      "url": "https://twitter.com/bonaboracho",
      "status_code": 200
    },
    {
      "platform": "telegram",
      "url": "https://t.me/bonkcoin",
      "status_code": 200
    },
    {
      "platform": "website",
      "url": "https://bonk.com",
      "status_code": 200
    }
  ],
  "image_hash": {
    "phash_32": "a4b3c2d1e5f6a7b8",
    "phash_64": "a4b3c2d1e5f6a7b8c9d0e1f2a3b4c5d6",
    "created_at": "2024-01-15T10:32:20.000Z"
  }
}

---

Field Reference

Token

Field	Type	Description
token_address	string	The mint address of the token
creator_address	string	The wallet address that created the token
total_supply	string | null	Total token supply
name	string | null	Token name
symbol	string | null	Token ticker symbol
decimals	integer | null	Number of decimal places
mint_authority_address	string | null	Address with mint authority, null if revoked
freeze_authority_address	string | null	Address with freeze authority, null if revoked
creation_slot	integer | null	Solana slot when the token was created
created_at	string	ISO 8601 timestamp when the record was created
updated_at	string	ISO 8601 timestamp when the record was last updated

Metadata

Field	Type	Description
update_authority_address	string | null	Address with authority to update metadata
uri	string | null	URI pointing to off-chain metadata (e.g., Arweave, IPFS)
uri_metadata	object | null	Parsed JSON content from the metadata URI
creators	array | null	List of creator objects with address, verified status, and share
primary_sale_happened	boolean	Whether the primary sale has occurred
is_mutable	boolean	Whether the metadata can be changed
edition_nonce	integer | null	Edition nonce for NFT standards
token_standard	string | null	Token standard (e.g., "Fungible", "NonFungible")
collection	object | null	Collection information if part of a collection
uses	object | null	Uses information for consumable tokens
collection_details	object | null	Additional collection details
programmable_config	object | null	Configuration for programmable NFTs
seller_fee_basis_points	integer | null	Royalty fee in basis points (100 = 1%)

Liquidity Event

Field	Type	Description
pair_address	string	The on-chain address of the liquidity pool
initial_liquidity_solana_amount	string	Amount of SOL added at pool creation
initial_liquidity_token_amount	string	Amount of tokens added at pool creation
initial_liquidity_value_usd	string	USD value of initial liquidity
initial_liquidity_add_slot_number	integer	Solana slot when liquidity was added
initial_liquidity_add_slot_timestamp	string	ISO 8601 timestamp of liquidity addition
block_time_at	string	ISO 8601 block time of the transaction

Social Links

Field	Type	Description
platform	string	Platform name (e.g., "twitter", "telegram", "website")
url	string	Full URL to the social profile or website
status_code	integer | null	HTTP status code from link validation

Holders

Field	Type	Description
holder_address	string	Wallet address of the token holder
balance	string	Token balance held by this address
is_lp	boolean	Whether this holder is a liquidity pool
created_at	string	ISO 8601 timestamp when this holder record was created

Image Hash

Field	Type	Description
phash_32	string | null	32-bit perceptual hash of the token image (hex encoded)
phash_64	string | null	64-bit perceptual hash of the token image (hex encoded)
created_at	string | null	ISO 8601 timestamp when the hash was generated

Note: Decimal values are returned as strings to preserve precision. Fields may be null if data is not available.

---

Example Usage

JavaScript:

const response = await fetch(
  "https://enterprise.guardis.io/v1/token/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  {
    headers: {
      "X-API-Key": "your_api_key_here"
    }
  }
);

const data = await response.json();

console.log(`Token: ${data.token.name} (${data.token.symbol})`);
console.log(`Initial Liquidity: $${data.liquidity_event.initial_liquidity_value_usd}`);
console.log(`Holders: ${data.holders.length}`);

Python:

import requests

response = requests.get(
    "https://enterprise.guardis.io/v1/token/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

print(f"Token: {data['token']['name']} ({data['token']['symbol']})")
print(f"Initial Liquidity: ${data['liquidity_event']['initial_liquidity_value_usd']}")
print(f"Holders: {len(data['holders'])}")

---

Error Responses

Status Code	Description
400	Invalid token address format
401	Missing or invalid API key
404	Token not found
500	Internal server error

{
  "code": 404,
  "message": "Token not found for the provided mint address"
}