Archalis Radar API

Ratings from AAA to C for BNB Chain tokens, a SCAM label for confirmed patterns, and on-chain forensics of every rug pull. Built so a trading bot can decide in one request whether a token is worth the risk.

Quick start

Base URL: https://api.archalis.com/v1. No key is needed to try it: requests without a key use the free plan, counted per IP address.

curl https://api.archalis.com/v1/token/0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82

With a key:

curl -H "X-API-Key: ark_..." https://api.archalis.com/v1/token/0x...

Keys and plans

Send your key in the X-API-Key header, or as Authorization: Bearer ark_.... For the stream, which browsers open without headers, ?key=ark_... also works.

Daily counters reset at 00:00 UTC. Every response carries X-RateLimit-Remaining-Day.

Token rating

Returns the latest rating in our archive, with the time it was computed in analyzedAt. If the token is not in the archive, or you add ?fresh=1, the radar analyzes it now: this takes a few seconds and counts against your fresh analyses.

A real response: a token whose liquidity was 100% locked, emptied by insiders 31 minutes after launch (some fields omitted).

{
  "chain": "bsc",
  "token": "0xd0d87cd37f498b79a9d4f37b7e623bd05ea2db96",
  "symbol": "NOKc",
  "rating": {
    "grade": "D",
    "label": "default: rug pull",
    "class": "default",
    "provisional": false,
    "outlook": null,
    "score": 19
  },
  "flags": [
    "SIMULATION_NOT_RUN",
    "RIGGED_BALANCES",
    "LOW_LIQUIDITY",
    "NEW_TOKEN",
    "INSIDER_DUMP"
  ],
  "market": {
    "type": "v2",
    "dex": "PancakeSwap V2",
    "pair": "0x7f3dadc63ebc3945b1cb981b7e5e30b2d653aec5",
    "base": "WBNB",
    "liquidityUsd": 0.07
  },
  "contract": {
    "simulated": false,
    "honeypot": false,
    "sellTaxPct": null,
    "ownerRenounced": true,
    "upgradable": false,
    "ownerPowers": []
  },
  "liquidity": {
    "burnedPct": 0,
    "lockedPct": 100,
    "inWalletsPct": 0,
    "verified": true,
    "locks": [
      {
        "locker": "PinkLock V2",
        "pct": 100,
        "unlockAt": null,
        "permanent": true
      }
    ]
  },
  "collapse": {
    "kind": "insider_dump",
    "isRugPull": true,
    "liquidityDropPct": 99.99,
    "minutesAfterLaunch": 31,
    "pulledPct": 0,
    "insiderSoldPct": 99.99,
    "marketSoldPct": 0
  },
  "analyzedAt": "2026-10-16T22:34:06.000Z",
  "source": "archive"
}

Grades

AAA to BBB are investment grade, BB and B speculative, CCC to C junk. SCAM is a confirmed scam pattern (not a grade). D means the rug pull already happened. Tokens younger than 24 hours get a provisional rating: "provisional": true.

Collapse

When liquidity falls 70% or more from its peak, collapse says why, from on-chain forensics: liquidity_pulled and insider_dump are rug pulls; market_crash and coordinated_selling are not.

Batch

Up to 50 tokens per request, from the archive only. Each token counts as one request.

curl -X POST https://api.archalis.com/v1/tokens \
  -H "X-API-Key: ark_..." -H "content-type: application/json" \
  -d '{"tokens": ["0x...", "0x..."]}'

Tokens not yet analyzed come back as {"token": "0x...", "error": "not_in_archive"}: ask for them one by one with GET /v1/token.

Creator

Everything we know about the wallet that opened a pool: its launches with initial and current grade, which ones ended in a rug pull and how, who funded it, and the network of linked wallets (shared volume bots, cross launches, common funders) with its rug pulls.

Real-time stream

Server-Sent Events. Each event carries the full token object described above.

// Node.js 18+ or the browser
const es = new EventSource('https://api.archalis.com/v1/stream?key=ark_...');
es.addEventListener('new', (e) => {
  const { token } = JSON.parse(e.data);
  const avoid = ['HONEYPOT', 'SERIAL_RUG_LAUNCHER', 'LP_UNLOCKED', 'SUPPLY_OUTSIDE_POOL'];
  if (token.flags.some((f) => avoid.includes(f))) return;
  console.log(token.symbol, token.rating.grade, token.market?.liquidityUsd);
});
es.addEventListener('rug', (e) => console.log('rug pull', JSON.parse(e.data).token.symbol));

Usage

Your plan, its limits, its expiry and today's consumption. It does not count against your quota.

Default rates

For each initial grade: how many new pools received it and how many then ended in a rug pull. Public and free, no key and no quota. It is how you can check that the ratings work, the same evidence credit rating agencies publish.

Risk flags

Stable codes, meant to be filtered by a program. New codes may be added; existing ones do not change meaning.

Errors

Errors return a JSON body {"error": {"code": "...", "message": "..."}}.

What it does not do

Ratings are automated assessments of structural risk based on public blockchain data. They are not investment advice and not a recommendation to buy or sell.

• Not for same-block sniping. The first rating arrives a few seconds after the pool is created (median about 7 seconds).
• BNB Chain only for now. PancakeSwap Infinity and Uniswap V4 pools are not covered yet.
• A rug pull is confirmed after the fact. Real-time exit alerts for tokens you hold are on the roadmap.
• How every grade is computed is public: methodology.