PRO Token Data

Complete token data access for PRO users.

All endpoints in this section require API Key authentication via X-API-Key header. Returns unfiltered, complete data for all requested tokens.

Get complete token details (PRO only)

get

Returns complete token details without any filtering. Includes all data, analyses, and historical information.

Features:

  • Complete security analysis with admin functions

  • Detailed DEX hints and trading information

  • Optional historical snapshots

  • Detailed analyses with actionable insights

  • Monitoring recommendations

All fields are returned without restrictions for PRO users.

Authorizations
X-API-KeystringRequired

API key for PRO plan endpoints (format: lion_pro_xxxxxxxxxxxxxxxx)

Path parameters
addressstringRequired

Token contract address (case-insensitive)

Example: 0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444
Query parameters
chain_idintegerOptional

Blockchain chain ID (1=Ethereum, 56=BSC, 137=Polygon, etc.)

Default: 56Example: 56
include_historybooleanOptional

Include historical snapshots (up to 100 most recent)

Default: trueExample: true
include_analysesbooleanOptional

Include detailed analyses with risk factors, insights, and alerts

Default: trueExample: true
include_admin_functionsbooleanOptional

Include detailed admin functions information

Default: trueExample: true
Responses
200

Complete token details

application/json
get
/pro/tokens/{address}
GET /api/pro/tokens/{address} HTTP/1.1
Host: https:/.alertlions.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "contract_address": "0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
  "chain_id": 56,
  "full_token_data": {
    "token": {
      "name": "DRAGON",
      "symbol": "DRAGON",
      "decimals": 18,
      "total_supply": "10000000000000000000000000"
    },
    "block_timestamp": 1761859607,
    "creation": {
      "block_timestamp": 1761859607,
      "tx_hash": "0x23abca6eb01efb76dfd41437ad48541b542aecc12d29ff8e94a1d794fb3a7c53",
      "creator": "0x24cca64343a9c14a21130df4e7f9dc5c6e3afe43",
      "creator_is_contract": false,
      "block_number": 65454178,
      "gas_used": 3469281,
      "bytecode_hash": "0xc0701112a220016c7a98bd7617f9d6bb9f3cb2472898ff042fb0949490b92b1a",
      "code_len": 3574,
      "proxy_like": false
    },
    "born_block": 65454178
  },
  "security_hints": {
    "contract_template": "text",
    "security_risk_score": 85,
    "ownership_renounced": true,
    "verified_contract": true,
    "has_pause_function": true,
    "has_blacklist_function": true,
    "has_mint_function": true,
    "is_proxy": true,
    "admin_functions": [
      {
        "name": "renounceOwnership",
        "selector": "715018a6",
        "access_control": "owner",
        "risk_level": 50,
        "description": "Can renounce ownership (makes safe)"
      }
    ]
  },
  "current_risk_level": "high",
  "current_risk_score": 85,
  "current_liquidity_usd": 5279.999977891201,
  "is_actively_traded": true,
  "dex_hints": {
    "is_tradable": true,
    "has_liquidity": true,
    "has_v3_liquidity": true,
    "total_liquidity_usd": 5279.999977891201,
    "token_price_usd": 0.000013199999944728,
    "buy_url": "https://dexscreener.com/bsc/0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
    "num_trading_pairs": 1,
    "main_trading_pair": "text",
    "trading_pairs": [
      {}
    ],
    "recommended_dex": "text",
    "volume_24h_usd": 1
  },
  "monitoring_recommendations": {
    "risk_monitoring": [
      "Monitor large transfers",
      "Watch for liquidity changes"
    ],
    "price_alerts": [
      "Set price alert at $0.0001"
    ]
  },
  "data_quality_score": 0.95,
  "analyses": [
    {
      "timestamp": "2025-11-29T20:24:57.543Z",
      "risk_factors": [
        "Low liquidity relative to market cap"
      ],
      "actionable_insights": [
        "Monitor for large transfers"
      ],
      "alerts": [
        {
          "type": "warning",
          "message": "Liquidity below threshold"
        }
      ]
    }
  ],
  "token_history": [
    {
      "timestamp": "2025-11-29T20:24:57.543Z",
      "risk_score": 1,
      "price_usd": 1,
      "liquidity_usd": 1,
      "volume_24h_usd": 1,
      "market_cap_usd": 1
    }
  ],
  "last_updated": "2025-10-22T00:03:41.469346942Z"
}

Get multiple tokens with filters (PRO only)

get

Returns multiple tokens with advanced filtering options. Supports pagination and custom field selection.

Filtering Options:

  • Filter by specific addresses (comma-separated)

  • Filter by chain IDs (comma-separated)

  • Filter by minimum liquidity in USD

  • Filter by maximum risk score

Pagination:

  • Uses offset-based pagination

  • Maximum 100 tokens per request

Note: All token data is returned without filtering for PRO users.

Authorizations
X-API-KeystringRequired

API key for PRO plan endpoints (format: lion_pro_xxxxxxxxxxxxxxxx)

Query parameters
addressesstringOptional

Comma-separated list of token addresses to filter

Example: 0x123...,0x456...
chain_idsstringOptional

Comma-separated list of chain IDs to filter

Example: 1,56,137
min_liquiditynumberOptional

Minimum liquidity in USD

Example: 10000
max_risk_scoreintegerOptional

Maximum security risk score (higher = higher risk)

Example: 60
include_historybooleanOptional

Include historical data for each token

Default: falseExample: false
limitinteger · min: 1 · max: 100Optional

Number of tokens to return

Default: 50Example: 50
offsetintegerOptional

Number of tokens to skip (for pagination)

Default: 0Example: 0
Responses
200

List of tokens with pagination

application/json
get
/pro/tokens
GET /api/pro/tokens HTTP/1.1
Host: https:/.alertlions.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "tokens": [
    {
      "contract_address": "0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
      "chain_id": 56,
      "current_risk_score": 85,
      "current_liquidity_usd": 5279.999977891201,
      "data_quality_score": 0.95,
      "last_updated": "2025-10-22T00:03:41.469346942Z"
    }
  ],
  "pagination": {
    "total": 100,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Bulk token operations (PRO only)

post

Performs bulk operations on multiple tokens in a single request. Supports fetching complete data for multiple tokens efficiently.

Features:

  • Fetch up to 50 tokens in a single request

  • Optional historical data and analyses for each token

  • Processing time tracking

  • Cache hit rate reporting

Use Cases:

  • Monitor multiple tokens simultaneously

  • Batch data export

  • Portfolio analysis

  • Automated trading systems

Performance:

  • Processing time scales with number of tokens

  • Includes cache hit rate for optimization insights

  • Recommended for up to 50 tokens per request

Authorizations
X-API-KeystringRequired

API key for PRO plan endpoints (format: lion_pro_xxxxxxxxxxxxxxxx)

Body
include_historybooleanOptional

Include historical data for each token (up to 50 snapshots)

Default: true
include_analysesbooleanOptional

Include detailed analyses with risk factors, insights, and alerts

Default: true
include_admin_functionsbooleanOptional

Include detailed admin functions information

Default: true
Responses
200

Bulk operation results

application/json
post
/pro/tokens/bulk
POST /api/pro/tokens/bulk HTTP/1.1
Host: https:/.alertlions.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "tokens": [
    {
      "address": "0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
      "chain_id": 56
    }
  ]
}
{
  "tokens": [
    {
      "contract_address": "0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
      "chain_id": 56,
      "full_token_data": {
        "token": {
          "name": "DRAGON",
          "symbol": "DRAGON",
          "decimals": 18,
          "total_supply": "10000000000000000000000000"
        },
        "block_timestamp": 1761859607,
        "creation": {
          "block_timestamp": 1761859607,
          "tx_hash": "0x23abca6eb01efb76dfd41437ad48541b542aecc12d29ff8e94a1d794fb3a7c53",
          "creator": "0x24cca64343a9c14a21130df4e7f9dc5c6e3afe43",
          "creator_is_contract": false,
          "block_number": 65454178,
          "gas_used": 3469281,
          "bytecode_hash": "0xc0701112a220016c7a98bd7617f9d6bb9f3cb2472898ff042fb0949490b92b1a",
          "code_len": 3574,
          "proxy_like": false
        },
        "born_block": 65454178
      },
      "security_hints": {
        "contract_template": "text",
        "security_risk_score": 85,
        "ownership_renounced": true,
        "verified_contract": true,
        "has_pause_function": true,
        "has_blacklist_function": true,
        "has_mint_function": true,
        "is_proxy": true,
        "admin_functions": [
          {
            "name": "renounceOwnership",
            "selector": "715018a6",
            "access_control": "owner",
            "risk_level": 50,
            "description": "Can renounce ownership (makes safe)"
          }
        ]
      },
      "current_risk_level": "high",
      "current_risk_score": 85,
      "current_liquidity_usd": 5279.999977891201,
      "is_actively_traded": true,
      "dex_hints": {
        "is_tradable": true,
        "has_liquidity": true,
        "has_v3_liquidity": true,
        "total_liquidity_usd": 5279.999977891201,
        "token_price_usd": 0.000013199999944728,
        "buy_url": "https://dexscreener.com/bsc/0xac69165e7b171fbdb6cbd2ffb0c00ec4a9614444",
        "num_trading_pairs": 1,
        "main_trading_pair": "text",
        "trading_pairs": [
          {}
        ],
        "recommended_dex": "text",
        "volume_24h_usd": 1
      },
      "monitoring_recommendations": {
        "risk_monitoring": [
          "Monitor large transfers",
          "Watch for liquidity changes"
        ],
        "price_alerts": [
          "Set price alert at $0.0001"
        ]
      },
      "data_quality_score": 0.95,
      "analyses": [
        {
          "timestamp": "2025-11-29T20:24:57.543Z",
          "risk_factors": [
            "Low liquidity relative to market cap"
          ],
          "actionable_insights": [
            "Monitor for large transfers"
          ],
          "alerts": [
            {
              "type": "warning",
              "message": "Liquidity below threshold"
            }
          ]
        }
      ],
      "token_history": [
        {
          "timestamp": "2025-11-29T20:24:57.543Z",
          "risk_score": 1,
          "price_usd": 1,
          "liquidity_usd": 1,
          "volume_24h_usd": 1,
          "market_cap_usd": 1
        }
      ],
      "last_updated": "2025-10-22T00:03:41.469346942Z"
    }
  ],
  "metadata": {
    "total_tokens": 2,
    "processing_time_ms": 330,
    "cache_hit_rate": 0.8
  }
}
PreviousRate LimitingNextModels

Last updated