# Token Security Heuristics API

> Token Security Heuristics API is a paid API for AI agents from shelf.thirdmade.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Analyzes a token contract address for honeypot signals, proxy detection, and liquidity pool data to help trading agents avoid rug pulls and scams.

## Facts

- Endpoint: GET https://shelf.thirdmade.net/probe/token-security
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-security-heuristics-api-421a782e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9hAdmQK-M-NIilUyt7kot

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability token-security-heuristics-api-421a782e
```

Example prompt: Before I buy this token, can you run a security check on contract address 0xabc123...def on Base and tell me if it looks like a honeypot or has any rug pull signals?

## When to prefer this

Use this endpoint when an AI trading agent needs a fast, cheap ($0.01) pre-trade security screen for any token on Base. Prefer this over manual contract inspection when you need programmatic honeypot and proxy detection with LP data in a single call. Best suited for automated pipelines where every new token must pass a security gate before a swap is executed.

## Known failure modes

- Invalid or malformed contract address returns an error
- Contract address not found on specified chain returns empty or not-found result
- Unsupported chain specified returns an error (only Base supported by default)
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Network timeout if the blockchain RPC is slow to respond

## How this service works

Token security heuristics: honeypot signals, proxy detection, LP data. Trading agents use this to avoid rugs.

## Output

Returns structured security heuristics for the token contract including honeypot detection flags, proxy contract signals, and liquidity pool (LP) data, enabling trading agents to assess rug pull risk before executing trades.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default)"
      },
      "address": {
       "type": "string",
       "description": "Token contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-security-heuristics-api-421a782e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from shelf.thirdmade.net](https://www.zero.xyz/host/shelf.thirdmade.net/llms.txt)