Live API

Token Security

Send a token contract address, get a full security report. Risk level, honeypot detection, contract traits, market data, and tax analysis — all in one call. Your agent should never trade blind.

x402 micropayments$0.03 USDC per call2 free calls to startNo API key required

View API Reference

Integration

API Reference

A standard REST endpoint and an MCP tool, both gated via x402 micropayments on Base.

x402 Micropayments

The first 2 requests per wallet (or per IP when no wallet is sent) are free. After that, callers receive a 402 response and must pay $0.03 USDC on Base through the x402 flow. No API keys needed — payment is the authentication.

REST Endpoint

POST

Endpoint

POST https://token-security.fourotwo.xyz/token-security

Request Body (JSON)

Example

{
  "address": "0xA0b8...3c4d",  // required — token contract address
  "chainId": 1                  // optional — defaults to Ethereum mainnet
}

Parameters

address

required

The token contract address to analyze.

chainId

optional · default: 1 (Ethereum)

The chain ID to check the token on.

Response

Returns token identity (name, symbol), a final risk level (low / medium / high), and detailed risk factors.

Example Response

{
  "name": "Example Token",
  "symbol": "EXT",
  "riskLevel": "high",
  "riskFactors": [
    {
      "factor": "honeypot",
      "risk": "high",
      "label": "Honeypot Detected",
      "value": true,
      "detail": "Token cannot be sold after purchase"
    },
    {
      "factor": "ownerCanMint",
      "risk": "medium",
      "label": "Owner Can Mint",
      "value": true,
      "detail": "Contract owner has minting privileges"
    }
  ]
}

cURL Example

curl -X POST https://token-security.fourotwo.xyz/token-security \
  -H "Content-Type: application/json" \
  -d '{"address": "0xA0b8...3c4d"}'

MCP Server

Streamable HTTP

Also available as an MCP tool (token_security) for agent frameworks like Cursor and Claude Desktop. Uses streamable HTTP transport.

MCP Endpoint

https://token-security.fourotwo.xyz/mcp

MCP Config Example

{
  "mcpServers": {
    "fourotwo-token-security": {
      "url": "https://token-security.fourotwo.xyz/mcp"
    }
  }
}

Learn more about the Model Context Protocol at modelcontextprotocol.io

Additional Endpoints

GET /healthHealth check endpoint

GET /.well-known/agent.jsonOASF agent card