Token Risk API
One endpoint. Give it a chain and a token address, get a risk report as JSON.
Endpoint
GET https://novaquill.dev/api/v1/token?chain=bsc|base&address=0x…
Authentication
Option 1, x402 (no account): call the endpoint; you receive 402 Payment Required with payment requirements ($0.02 in USDC on Base or USDT on BNB Chain via Permit2). Any x402 client pays and retries automatically.
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
const pay = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }] });
const r = await pay("https://novaquill.dev/api/v1/token?chain=bsc&address=0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82");
console.log(await r.json());
Option 2, prepaid API key: buy credits ($0.01 per report), then send the key as a header.
curl -H "x-api-key: nq_…" "https://novaquill.dev/api/v1/token?chain=base&address=0x532f27101965dd16442E59d40670FaF5eBB142E4"
curl -H "x-api-key: nq_…" "https://novaquill.dev/api/v1/credits" # remaining credits
Response
{
"chain": "bsc", "address": "0x…",
"token": { "name": "…", "symbol": "…", "decimals": 18, "totalSupply": "…" },
"risk": { "score": 0-100, "level": "low|medium|high|critical",
"flags": [{ "severity": "critical|high|medium|low|info", "code": "HONEYPOT", "message": "…" }] },
"simulation": { "available": true, "buyOk": true, "sellOk": false, "honeypot": true,
"buyTaxPct": 0, "sellTaxPct": null, "transferTaxPct": null, "via": "PancakeSwap V2" },
"liquidity": { "pair": "0x…", "liquidityUsd": 12763, "lpBurnedPct": 0, "lpLockedPct": 0, "lockers": [], "v3Pools": [] },
"holdings": { "ownerPct": 3.2, "burnedPct": 0, "inV2PoolPct": 41.7 },
"contract": { "owner": "0x…", "ownerRenounced": false, "proxy": null, "verified": true, "privilegedFunctions": ["mint(address,uint256)"] },
"checkedAt": "…"
}
Flag codes
| Code | Meaning |
|---|---|
| HONEYPOT | Buy works, sell fails in simulation |
| BUY_FAILS | Buying reverts (trading off or restricted) |
| EXTREME_SELL_TAX / HIGH_SELL_TAX / SELL_TAX | Sell tax ≥30% / ≥10% / >0.5% |
| EXTREME_BUY_TAX / HIGH_BUY_TAX / BUY_TAX | Buy tax ≥30% / ≥10% / >0.5% |
| TRANSFER_BLOCKED | Wallet-to-wallet transfer fails |
| UPGRADEABLE | Logic can be replaced via proxy |
| OWNER_CAN_MINT | Owner can inflate supply |
| BLACKLIST | Addresses can be blocked |
| PAUSABLE | Transfers can be paused |
| MUTABLE_FEES | Fees can be changed after launch |
| TRADING_TOGGLE | Owner can switch trading off |
| LOW_LIQUIDITY / THIN_LIQUIDITY | Pool under $5k / $50k |
| LP_NOT_LOCKED / OWNER_HOLDS_LP | Liquidity can be pulled |
| OWNER_CONCENTRATION / OWNER_HOLDS | Owner holds ≥20% / ≥5% of supply |
| NO_LIQUIDITY_FOUND | No pool found to test against |
MCP server
Use the scanner as a tool in Claude, Cursor or any MCP client. Remote server (streamable HTTP): https://novaquill.dev/mcp. Tools: token_risk, new_launches. 10 free calls per day; pass api_key for more. Registry name: dev.novaquill/token-risk.
claude mcp add --transport http novaquill https://novaquill.dev/mcp
New-launch feed
GET https://novaquill.dev/api/v1/launches?chain=bsc|base|all&limit=50&minScore=60Newest tokens first, each with score, level, honeypot, buy/sell tax, liquidity and flags. $0.01 per call via x402 or 1 credit with an API key.
Limits and notes
Results are cached for 10 minutes. Simulation uses the main V2 pool (PancakeSwap V2 on BNB Chain, Uniswap V2 on Base) with a small trade from a contract address; tokens that block contract buyers can show as BUY_FAILS. Errors: 400 bad input, 401 unknown key, 402 payment required / no credits, 404 not a contract.
Machine-readable: openapi.json · llms.txt