Documentation

Forensic Risk Evidence

RugBurn exposes Solana token, wallet, deployer, and decision evidence through the dashboard, API, Telegram workflow, and local MCP server.

Quickstart

CHECK A TOKEN IN THREE CALLS

Generate a key, call token risk, then inspect evidence, facets, hard caps, and limitations before your system takes action.

curl
curl https://rugburn.io/api/v1/token/risk \  -H "Authorization: Bearer $RUGBURN_API_KEY" \  -H "Content-Type: application/json" \  -d '{"address":"TOKEN_MINT_ADDRESS"}'
typescript
async function getTokenRisk(address: string) {  const response = await fetch("https://rugburn.io/api/v1/token/risk", {    method: "POST",    headers: {      "Authorization": `Bearer ${process.env.RUGBURN_API_KEY}`,      "Content-Type": "application/json",    },    body: JSON.stringify({ address }),  });  if (!response.ok) throw new Error("RugBurn risk check failed");  return response.json();}
python
import osimport requestsresponse = requests.post(    "https://rugburn.io/api/v1/token/risk",    headers={"Authorization": f"Bearer {os.environ['RUGBURN_API_KEY']}"},    json={"address": "TOKEN_MINT_ADDRESS"},    timeout=20,)response.raise_for_status()print(response.json()["data"]["recommendedAction"])
Use Cases

WHERE RUGBURN FITS

Hackathon teams, agent builders, and bot developers

Agentic Builder Guardrail

Call pre-trade checks and token evidence before an agent recommends, trades, alerts, or writes a public claim.

The API returns decision, confidence, evidence age, invalidation rules, sources, and limitations.

Fast Solana traders and Telegram groups

Trencher Pre-Entry Check

Paste a mint, read structure, liquidity, ownership, deployer, flow, and stale evidence before entry.

Use the app for quick triage, then add serious mints to watches for state-change alerts.

Private desks, quant groups, and paid communities

Trading Team Risk Gate

Add RugBurn as a pre-trade filter or post-signal review step before a strategy acts.

Batch candidate tokens offline, compare misses, and tune thresholds with weekly calibration notes.

Compliance teams and Solana payment operators

VASP Pilot Triage

Screen token, wallet, and deployer evidence before routing suspicious assets for operator review.

Use wallet risk, deployer history, and token forensics as screening data, not a legal compliance guarantee.

Token teams, launchpads, and community operators

Project Trust Report

Share a clear risk report that explains where the project is strong and where buyers should still review.

A packet with facets, actors, freshness, and limitations is easier to defend than a naked score screenshot.

Test Console

TRY TOKEN RISK WITH YOUR KEY

Browser test

Use a low-scope test key. The key is not stored by this page, but production apps should call RugBurn from a backend or agent runtime.

Boundaries

WHAT NOT TO OVERCLAIM

RugBurn is forensic risk evidence and screening, not financial advice.

The API serves cached public v1 reports; unbounded full scans are protected.

The v3.3 behavioral model is a measured shadow model until calibration proves failure capture.

Accuracy alone is not marketed as rug detection when precision and recall are weak.

RESPONSE ANATOMY

Read score index, risk level, facets, hard caps, sources, limitations, and generated metadata.

CALIBRATION NOTES

Treat precision, recall, failed-token separation, and Brier score as stronger model-health signals than accuracy alone.

PILOT PLAYBOOK

Bring 20 token mints, one target workflow, and one success metric. RugBurn will help test fit quickly.

Next Step

TEST A REAL WORKFLOW, NOT A PERFECT DEMO

Send a token list, agent flow, trading rule, or forensic review case. We will tell you where RugBurn helps, where it misses, and what data is needed next.