# RugShield x402 risk API

> Pay-per-call Solana safety checks for AI agents: rug check, multi-advisor risk panel and pre-sign transaction guard, paid in USDC on Base or Solana over x402. No account, no API key.

Every paid route first answers HTTP 402 with the exact price and both payment options (USDC on Base,
USDC on Solana mainnet; on Solana the facilitator pays the network fee). Any x402 client pays and retries.

## Choose the right check

- Have an unsigned Solana transaction and need a decision before signing? Use POST /v1/tx-guard.
- Have a pump.fun token mint and need specific rug warnings before buying? Use GET /v1/token-risk/{address}.
- Need several independent opinions or a consensus? Read GET /v1/advisors for free, then use
  GET /v1/risk-panel/{mint} with optional ?advisors=id,id. A missing flag never proves safety.

## Pay without signup

1. Read the free [OpenAPI schema](/openapi.json) for exact inputs and responses.
2. Call the chosen paid route. The HTTP 402 response carries a PAYMENT-REQUIRED header with
   the exact USDC amount, recipient and accepted network options.
3. An x402-capable client signs payment with its own wallet and retries the same request.
   No API key or account is required. Never send a wallet seed or private key to this API.

Payment-aware MCP clients can connect to [/mcp/](/mcp/). The paid MCP tools are
`check_solana_transaction` and `check_solana_token_risk`; the HTTP risk panel is not an MCP tool.
An ordinary MCP client without x402 payment handling cannot complete a paid call automatically.

## Paid

- [POST /v1/tx-guard](/openapi.json): Solana transaction safety check before signing. Send the unsigned transaction (base64); get ALLOW, WARN or BLOCK with balance changes and reasons. US$ 0.01.
- [GET /v1/token-risk/{mint}](/openapi.json): Solana token rug check for pump.fun tokens; advisory flags with measured precision. US$ 0.01.
- [GET /v1/risk-panel/{mint}?advisors=a,b](/openapi.json): several independent risk APIs paid in parallel; each verdict normalized 0-1, a consensus and each advisor's hit rate on our traffic. Price = chosen advisors + max(US$ 0.005, 15% of advisor cost); not charged when no advisor answers.

Under load, tx-guard and token-risk answer 503 with Retry-After (not charged). Send `Prefer: respond-async` to get HTTP 202 with a job id instead (charged on accept) and poll it for free.

## Free

- [GET /v1/advisors](/v1/advisors): advisors, prices and measured track records.
- [GET /v1/jobs/{job_id}](/openapi.json): result of an accepted async call; POST .../retry reruns a failed one.
- [GET /openapi.json](/openapi.json): OpenAPI schema.
- [GET /apis.json](/apis.json): API directory metadata and links to all discovery surfaces.
- [GET /.well-known/x402](/.well-known/x402): paid resource discovery.