---
title: "Solana token rug check for a pump.fun token before buying (paid, x402)"
method: GET
path: "/v1/token-risk/{address}"
---

# Solana token rug check for a pump.fun token before buying (paid, x402)

`GET /v1/token-risk/{address}`

## Request

- Base URL: `https://getrugshield.com` (the document declares no server; this is the origin it was published from)
- URL: `https://getrugshield.com/v1/token-risk/{address}`
- Auth: none declared

Solana token rug warnings for pump.fun tokens before buying: checks recent fees linked to known sniper clusters and whether the creator launched many tokens with few graduating. These advisory signals were evaluated on selected historical tokens; results may differ for new tokens. Returns RISK_FLAGS or NO_FLAGS; NO_FLAGS does not mean safe. Input: token mint (base58).

## Path parameters

- `address` string, required

## Headers

- `Idempotency-Key` string
- `X-RugShield-Job-ID` string

## Response `200`

Completed paid result with a recoverable job ID; the server confirmed settlement before sending.

- object
  - `mint` string, required
  - `token_name` string, nullable, required
  - `token_symbol` string, nullable, required
  - `deployer` string, required
  - `verdict` 'RISK_FLAGS' | 'NO_FLAGS', required
  - `flags` object[], required
    - `id` string, required
    - `detail` string, required
    - `measured_precision` number: Historical share of flagged tokens labeled rug in a selected cohort; not a prospective guarantee.
    - `false_positive_rate` number: Historical share of labeled healthy tokens flagged in a selected cohort; not a prospective guarantee.
    - `sample` string: Selected historical evaluation cohort and date; does not establish performance on new tokens.
    - `hits` object[]
      - `signature` string, nullable, required
      - `fee_lamports` integer, required
      - `fee_payer` string, nullable, required
      - `matches` string, required
  - `deployer_stats` object, nullable, required
    - `tokens_launched` integer, required
    - `graduation_rate` number, required
  - `checks_unavailable` string[], required
  - `note` string, required
  - `job_id` string, required
  - `status_url` string, required
  - `charged` true, required
  - `recovery` object, required
    - `status_url` string, required
    - `retry_with_original_proof` boolean, required
    - `job_id_header` string, required

## Other responses

- `402`: Payment Required: x402 challenge with the exact USDC price and accepted payment networks
- `409`: Original proof/key/job handle conflicts or settlement outcome needs manual review; no new payment is attempted.
- `422`: Validation Error
- `502`: No usable result; payment is not settled.
- `503`: Processing, ready for a signed retry, or queue busy. No settlement occurred; Retry-After is a polling interval, not a completion deadline.

---

[API](https://skmtc.dev/getrugshield/apis/rugshield-parallel-solana-risk-api.md) · [All operations](https://skmtc.dev/getrugshield/apis/rugshield-parallel-solana-risk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getrugshield/apis/rugshield-parallel-solana-risk-api/revisions/5395ade4e1f8?raw)