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"
}
PreviousTop TradersNextStreaming

Last updated