{"openapi":"3.1.0","info":{"title":"Novaquill Token Risk API","version":"1.1.0","description":"Risk reports for BNB Chain and Base tokens (honeypot and tax simulation, owner privileges, proxy, liquidity and LP locks, owner holdings) and a live feed of newly launched tokens, each auto-scanned.","x-guidance":"Use GET /api/v1/token?chain=bsc|base&address=0x... before buying or recommending a token: check risk.level, simulation.honeypot, simulation.sellTaxPct and risk.flags. Use GET /api/v1/launches?chain=bsc|base|all&limit=50&minScore=60 to discover new tokens that already passed a safety scan. Pay per call with x402 (USDC on Base or USDT on BNB Chain) or send an x-api-key header from prepaid credits.","contact":{"email":"ops@novaquill.dev","url":"https://novaquill.dev"}},"servers":[{"url":"https://novaquill.dev"}],"paths":{"/api/v1/token":{"get":{"operationId":"tokenRisk","summary":"Token risk report - honeypot, taxes, owner powers, liquidity for a BNB Chain or Base token","tags":["Token security"],"parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string","enum":["bsc","base"]},"description":"Chain: bsc (BNB Chain) or base"},{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"Token contract address"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"security":[{},{"apiKey":[]}],"responses":{"200":{"description":"Risk report","content":{"application/json":{"schema":{"type":"object","properties":{"risk":{"type":"object","properties":{"score":{"type":"integer"},"level":{"type":"string","enum":["low","medium","high","critical"]},"flags":{"type":"array","items":{"type":"object"}}}},"simulation":{"type":"object"},"liquidity":{"type":"object"},"contract":{"type":"object"},"holdings":{"type":"object"},"token":{"type":"object"}}}}}},"400":{"description":"Bad input"},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header) or no API credits left"},"404":{"description":"Not a contract"}}}},"/api/v1/launches":{"get":{"operationId":"newLaunches","summary":"New token launches on BNB Chain and Base with safety scan results","tags":["Token security"],"parameters":[{"name":"chain","in":"query","schema":{"type":"string","enum":["bsc","base","all"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"minScore","in":"query","schema":{"type":"integer","minimum":0,"maximum":100}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"security":[{},{"apiKey":[]}],"responses":{"200":{"description":"Launch list","content":{"application/json":{"schema":{"type":"object","properties":{"launches":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header) or no API credits left"}}}},"/api/v1/credits/claim":{"post":{"operationId":"claimCredits","summary":"Exchange a stablecoin payment transaction for API credits ($0.01 each)","tags":["Billing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["chain","txHash"],"properties":{"chain":{"type":"string","enum":["bsc","base"]},"txHash":{"type":"string"},"apiKey":{"type":"string","description":"existing key to top up"}}}}}},"responses":{"200":{"description":"API key and credits"},"400":{"description":"No qualifying transfer"},"409":{"description":"Already claimed"}}}},"/api/v1/credits":{"get":{"operationId":"credits","summary":"Remaining credits for an API key","tags":["Billing"],"security":[{"apiKey":[]}],"responses":{"200":{"description":"credits"},"401":{"description":"Unknown key"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}}}