security.contract_health_audit
Read-only
Use this tool to check whether a token's liquidity pool is locked, burned, or freely held by a single wallet before trusting its liquidity - a rug-pull signal that security.token_risk does not cover. Reuses the same GoPlus data as token_risk (no extra upstream call) and rolls it up into a liquidity_health category (LOCKED/PARTIALLY_LOCKED/UNLOCKED/NO_LP_DATA). Does not include any qualitative 'suspicious transaction' judgment - only GoPlus's own lock/burn numbers. Do not use for honeypot or tax checks (use security.token_risk) or market price data. Paid in USDC on Base.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain_id | Yes | EVM chain id, e.g. 8453 for Base. | |
| contract_address | Yes | Token contract address (0x...). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notice | No | ||
| chain_id | Yes | ||
| risk_flags | Yes | ||
| token_name | No | ||
| data_source | Yes | ||
| generated_at | Yes | ||
| token_symbol | No | ||
| lp_burned_pct | No | ||
| lp_locked_pct | No | ||
| lp_holder_count | No | ||
| lp_total_supply | No | ||
| contract_address | Yes | ||
| liquidity_health | Yes | ||
| top_unlocked_holder_pct | No | ||
| top5_unlocked_holder_pct | No | Sum of the top 5 non-locked/non-burned LP holders - catches concentration spread across several wallets that top_unlocked_holder_pct (single largest holder only) would miss. |