Novaquill

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

CodeMeaning
HONEYPOTBuy works, sell fails in simulation
BUY_FAILSBuying reverts (trading off or restricted)
EXTREME_SELL_TAX / HIGH_SELL_TAX / SELL_TAXSell tax ≥30% / ≥10% / >0.5%
EXTREME_BUY_TAX / HIGH_BUY_TAX / BUY_TAXBuy tax ≥30% / ≥10% / >0.5%
TRANSFER_BLOCKEDWallet-to-wallet transfer fails
UPGRADEABLELogic can be replaced via proxy
OWNER_CAN_MINTOwner can inflate supply
BLACKLISTAddresses can be blocked
PAUSABLETransfers can be paused
MUTABLE_FEESFees can be changed after launch
TRADING_TOGGLEOwner can switch trading off
LOW_LIQUIDITY / THIN_LIQUIDITYPool under $5k / $50k
LP_NOT_LOCKED / OWNER_HOLDS_LPLiquidity can be pulled
OWNER_CONCENTRATION / OWNER_HOLDSOwner holds ≥20% / ≥5% of supply
NO_LIQUIDITY_FOUNDNo pool found to test against

New-launch feed

GET https://novaquill.dev/api/v1/launches?chain=bsc|base|all&limit=50&minScore=60

Newest 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