{"openapi":"3.1.0","info":{"title":"Token Security API","version":"1.0.0","description":"Live smart-contract risk and safety analysis for crypto tokens and wallet addresses — the on-chain due-diligence check to run before you buy a token or interact with an address, powered by the public GoPlus Security data, no key, nothing stored. The token endpoint scans an ERC-20-style contract on any supported chain and returns whether it is a honeypot, its buy and sell tax, whether it is mintable or has a hidden or privileged owner who can pause trading or take back ownership, whether it is open-source or a proxy, and its holder and LP-holder counts. The address endpoint screens a wallet address against twenty risk signals — cybercrime, money laundering, phishing, sanctions, stealing attacks, honeypot-related addresses and more — and reports exactly which, if any, are flagged. The chains endpoint lists the 40+ supported blockchains. Catch scam tokens, honeypots and tainted addresses before they cost you. This is the real-time contract-security and risk-screening cut of crypto — distinct from the historical exploit database, the price and the on-chain APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tokensecurity-api","description":"oanor gateway"}],"tags":[{"name":"Token"},{"name":"Address"},{"name":"Chains"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/token":{"get":{"operationId":"get_v1_token","tags":["Token"],"summary":"Token contract security scan","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"Token contract address","schema":{"type":"string"},"example":"0xdac17f958d2ee523a2206206994597c13d831ec7"},{"name":"chain","in":"query","required":false,"description":"GoPlus chain id (default 1=Ethereum)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"1","source":"GoPlus","buy_tax":0,"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","is_proxy":false,"sell_tax":0,"is_in_dex":true,"cannot_buy":false,"token_name":"Tether USD","is_honeypot":false,"is_mintable":true,"hidden_owner":false,"holder_count":14781635,"token_symbol":"USDT","total_supply":97070655229.72336,"is_anti_whale":false,"owner_address":"0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828","self_destruct":false,"is_blacklisted":true,"is_open_source":true,"is_whitelisted":false,"trading_cooldown":false,"transfer_pausable":true,"slippage_modifiable":true,"owner_change_balance":true,"honeypot_same_creator":false,"can_take_back_ownership":false},"meta":{"timestamp":"2026-06-11T16:46:44.139Z","request_id":"9fca1541-5274-4f97-a4f6-c6aa93486529"},"status":"ok","message":"Token security retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/address":{"get":{"operationId":"get_v1_address","tags":["Address"],"summary":"Wallet address risk screening","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Wallet address","schema":{"type":"string"},"example":"0xdAC17F958D2ee523a2206206994597C13D831ec7"},{"name":"chain","in":"query","required":false,"description":"GoPlus chain id (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"flagged lists the set risk signals; an empty list means no risk signals were found for this address.","chain":"1","flags":{"mixer":false,"reinit":false,"fake_kyc":false,"gas_abuse":false,"cybercrime":false,"fake_token":false,"sanctioned":false,"blacklist_doubt":false,"financial_crime":false,"stealing_attack":false,"contract_address":true,"money_laundering":false,"phishing_activities":false,"blackmail_activities":false,"darkweb_transactions":false,"fake_standard_interface":false,"honeypot_related_address":false,"malicious_mining_activities":false,"number_of_malicious_contracts_created":false},"risky":false,"source":"GoPlus","address":"0xdAC17F958D2ee523a2206206994597C13D831ec7","flagged":[],"is_contract":true},"meta":{"timestamp":"2026-06-11T16:46:44.686Z","request_id":"026d3121-e930-44d7-b765-4f4dc52e063e"},"status":"ok","message":"Address security retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chains":{"get":{"operationId":"get_v1_chains","tags":["Chains"],"summary":"Supported blockchains","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":42,"chains":[{"id":"1","name":"Ethereum"},{"id":"56","name":"BSC"},{"id":"42161","name":"Arbitrum"},{"id":"137","name":"Polygon"},{"id":"solana","name":"Solana"},{"id":"204","name":"opBNB"},{"id":"324","name":"zkSync Era"},{"id":"59144","name":"Linea Mainnet"},{"id":"8453","name":"Base"},{"id":"5000","name":"Mantle"},{"id":"130","name":"Unichain"},{"id":"48900","name":"Zircuit Mainnet"},{"id":"534352","name":"Scroll"},{"id":"10","name":"Optimism"},{"id":"43114","name":"Avalanche"},{"id":"25","name":"Cronos"},{"id":"100","name":"Gnosis"},{"id":"tron","name":"Tron"},{"id":"321","name":"KCC"},{"id":"201022","name":"FON"},{"id":"42766","name":"ZKFair"},{"id":"2741","name":"Abstract"},{"id":"146","name":"Sonic"},{"id":"1514","name":"Story"},{"id":"1868","name":"Soneium"},{"id":"688688","name":"Pharos Testnet"},{"id":"5734951","name":"Jovay"},{"id":"143","name":"Monad"},{"id":"9745","name":"Plasma"},{"id":"1672","name":"Pharos Mainnet"},{"id":"177","name":"HashKey Chain"},{"id":"80094","name":"Berachain"},{"id":"480","name":"World Chain"},{"id":"2818","name":"Morph"},{"id":"1625","name":"Gravity"},{"id":"185","name":"Mint"},{"id":"196","name":"X Layer Mainnet"},{"id":"810180","name":"zkLink Nova"},{"id":"200901","name":"Bitlayer Mainnet"},{"id":"4200","name":"Merlin"},{"id":"169","name":"Manta Pacific"},{"id":"81457","name":"Blast"}],"source":"GoPlus"},"meta":{"timestamp":"2026-06-11T16:46:45.039Z","request_id":"544cf16b-cbeb-40ca-b316-66f66cfbb4a5"},"status":"ok","message":"Chains retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"chain is a GoPlus chain id (1=Ethereum, 56=BSC, 137=Polygon, 42161=Arbitrum, solana). Booleans come from the upstream's 0/1 flags; taxes are fractions (0.05 = 5%).","source":"GoPlus Security (api.gopluslabs.io/api/v1, live)","service":"tokensecurity-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/token":"Token contract security — honeypot, taxes, mintable, owner privileges, holders (chain=1&contract=0x...).","GET /v1/chains":"Supported blockchains (id, name).","GET /v1/address":"Wallet risk screening across 20 signals — which are flagged (chain=1&address=0x...)."},"description":"Live smart-contract risk and safety analysis for crypto tokens and wallet addresses, from GoPlus Security. The token endpoint scans a token contract on any supported chain and returns whether it is a honeypot, its buy/sell tax, whether it is mintable or has a privileged/hidden owner who can pause trading or reclaim ownership, whether it is open-source or a proxy, and holder/LP counts. The address endpoint screens a wallet against twenty risk signals (cybercrime, money laundering, phishing, sanctions, stealing attacks, honeypot-related…) and reports which are flagged. The chains endpoint lists supported blockchains. Live, no key, nothing stored. The real-time contract-security / risk-screening cut of crypto — distinct from the historical exploit-database, price and on-chain APIs.","upstream_status":"ok","supported_chains":42},"meta":{"timestamp":"2026-06-11T16:46:45.386Z","request_id":"5d0a2bbd-5ca5-4829-ad07-6e64c3fa738c"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":13000,"rps_limit":3,"hard_limit":true},{"slug":"builder","name":"Builder","price_cents_month":975,"monthly_call_quota":175000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2830,"monthly_call_quota":780000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6350,"monthly_call_quota":2750000,"rps_limit":65,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tokensecurity-api"}