Detect Bundled Tokens

Checks if a token is part of a liquidity bundle or wrapped asset, including honeypot/farming risk.

// def check_bundled_token(token_address):
    url = f"{BASE_URL}/api/token/bundled"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {"token_address": token_address}

    try:
        response = requests.post(url, json=payload, headers=headers)
        response.raise_for_status()
        bundled_data = response.json()
        return bundled_data
    except requests.exceptions.RequestException as e:
        print(f"Error checking bundled token: {e}")
        return None

# Fetch and display bundled token information
bundled_info = check_bundled_token(TOKEN_ADDRESS)
if bundled_info:
    print("Bundled Token Info:")
    print(bundled_info)

Example API Response:

// {
  "token": {
    "name": "Example Token",
    "symbol": "EXT",
    "address": "0xEXAMPLETOKEN123456",
    "decimals": 9,
    "total_supply": "1,000,000,000",
    "market_cap": "2,500,000 USDC",
    "current_price": {
      "SOL": "0.005 SOL",
      "USDC": "0.10 USDC"
    }
  },
  "is_bundled": true,
  "bundle_details": {
    "wrapped_in": "TOKEN_X",
    "liquidity_lock": {
      "status": "Locked",
      "unlock_date": "2025-06-15T00:00:00Z",
      "locked_percentage": "80%"
    },
    "honeypot_risk": {
      "status": "Low",
      "reason": "No transfer tax, no blacklist, no high slippage requirement."
    },
    "contract_audit": {
      "audited": true,
      "auditor": "CertiK",
      "audit_link": "https://example.com/audit-report",
      "issues_found": {
        "critical": 0,
        "high": 1,
        "medium": 2,
        "low": 3
      }
    }
  },
  "liquidity_analysis": {
    "total_liquidity": "5000 SOL",
    "liquidity_provider_distribution": {
      "top_10_holders": "70%",
      "top_50_holders": "85%",
      "top_100_holders": "92%"
    },
    "dex_pools": [
      {
        "pool_name": "Raydium",
        "pair": "EXT/USDC",
        "liquidity": "2500 SOL",
        "daily_volume": "15000 USDC",
        "impermanent_loss_risk": "Moderate"
      },
      {
        "pool_name": "Orca",
        "pair": "EXT/SOL",
        "liquidity": "2500 SOL",
        "daily_volume": "12000 SOL",
        "impermanent_loss_risk": "High"
      }
    ]
  },
  "trading_activity": {
    "daily_transactions": 1240,
    "buy_sell_ratio": {
      "buys": "60%",
      "sells": "40%"
    },
    "whale_activity": {
      "whale_transactions_last_24h": 15,
      "largest_trade": {
        "wallet": "Whale_Wallet_1",
        "amount": "500,000 EXT",
        "value": "50,000 USDC",
        "transaction_hash": "0xLARGETRADE123456"
      }
    },
    "bot_activity": {
      "detected_bots": 3,
      "bot_trading_percentage": "5%",
      "notable_bots": [
        {
          "wallet": "BOT_WALLET_1",
          "sniping_attempts": 5,
          "profit_margin": "1200 USDC",
          "last_sniped_token": "TOKEN_Y"
        },
        {
          "wallet": "BOT_WALLET_2",
          "sniping_attempts": 3,
          "profit_margin": "800 USDC",
          "last_sniped_token": "TOKEN_Z"
        }
      ]
    }
  },
  "security_warnings": {
    "blacklist_status": "Not blacklisted",
    "contract_upgradability": {
      "is_upgradable": false,
      "owner_address": "0xCONTRACTOWNER123456"
    },
    "minting_privileges": {
      "has_minting_privileges": false,
      "last_mint_transaction": null
    }
  }
}