# RugShield Token Risk API

> RugShield Token Risk API is a paid API for AI agents from getrugshield.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns risk flags and a verdict for a given Solana token address, including deployer stats and rug pull indicators

## Facts

- Endpoint: GET https://getrugshield.com/v1/token-risk/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rugshield-token-risk-api-30f90e42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GF8Zpc2mzVsHvJ2AlsBeC

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 rugshield-token-risk-api-30f90e42
```

Example prompt: Before I buy any of this token, can you check whether the mint address EXAMPLEm1ntAddress1111111111111111111pump is flagged as a rug pull risk on RugShield?

## When to prefer this

Use this endpoint when an agent needs a fast, per-token risk signal for a specific Solana mint address before executing a buy, especially for pump.fun tokens. It is best suited for single-token lookups with high-precision flag data and deployer history. Prefer the multi-advisor aggregator endpoint (RugShield Solana Risk Panel) when you want consensus from multiple independent advisors rather than a single-source verdict.

## Known failure modes

- Invalid or non-existent mint address returns an error or empty result
- Token too new to have sufficient on-chain history — checks_unavailable list populated
- Payment failure over x402 protocol blocks the response
- Rate limiting if calls exceed allowed throughput
- Token address on a non-Solana chain returns an error

## How this service works

RugShield aggregates Solana risk checks: one API call runs independent advisors in parallel, plus our own code-based flags. Pay in USDC via x402.

## Output

A JSON object containing the token mint address, a verdict string (e.g. RISK_FLAGS or CLEAN), an array of risk flags each with an ID, detail, sample data, measured precision, and false positive rate, deployer address, token name and symbol, deployer stats (graduation rate and tokens launched), and a list of checks that were unavailable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mint": "EXAMPLEm1ntAddress1111111111111111111pump",
  "note": "No flag does not mean safe. These advisory signals were evaluated on selected historical tokens and can miss rugs.",
  "flags": [
   {
    "id": "FACTORY_DEPLOYER",
    "detail": "deployer launched 24,310 tokens, 0.4% graduated",
    "sample": "149 rugs + 49 healthy tokens (2026-05; threshold selected on this cohort)",
    "measured_precision": 0.889,
    "false_positive_rate": 0.02
   }
  ],
  "verdict": "RISK_FLAGS",
  "deployer": "EXAMPLEdep1oyerWa11etAddress1111111111111",
  "token_name": "Example",
  "token_symbol": "EXM",
  "deployer_stats": {
   "graduation_rate": 0.004,
   "tokens_launched": 24310
  },
  "checks_unavailable": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rugshield-token-risk-api-30f90e42/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from getrugshield.com](https://www.zero.xyz/host/getrugshield.com/llms.txt)