{"openapi":"3.1.0","info":{"title":"Honeypot Token Safety API","version":"1.0.0","description":"Live EVM token-safety checks — does this token let you sell, and what will it cost you? A \"honeypot\" is a token you can buy but cannot sell: the contract blocks the sell, traps your money or charges a punishing tax. This API detects it the only reliable way — by actually simulating a buy and a sell of the token against its real liquidity pool on-chain, right now (powered by honeypot.is), and reporting whether the sell went through, the live buy/sell/transfer tax, the gas cost and a plain risk summary. Beyond the honeypot verdict it returns the token's DEX trading pairs with their on-chain reserves and USD liquidity, the largest holders with the top-10 supply concentration (a top-heavy token can be dumped on you), and whether the contract source is verified/open and makes proxy calls. Covers Ethereum, BNB Chain, Base and other EVM chains. This is the EVM token-safety cut via live buy/sell simulation — distinct from the Solana rug-risk feed, which inspects SPL mint authorities on a different chain with a different method. A safety signal, not financial advice — always verify before trading.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/honeypot-api","description":"oanor gateway"}],"tags":[{"name":"Safety"},{"name":"Market"},{"name":"Holders"},{"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/contract":{"get":{"operationId":"get_v1_contract","tags":["Safety"],"summary":"Source-verification and proxy-call analysis","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address","schema":{"type":"string"},"example":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"description":"EVM chain (default eth)","schema":{"type":"string"},"example":"eth"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Whether an EVM token's contract is verified and open-source. is_open_source true means the code is published and auditable; has_proxy_calls true means the contract delegates to other contracts (logic can change — a risk). contracts_checked/contracts_open_source count how many of the contracts in the token's call graph are open-source. A closed-source token you cannot read is harder to trust. Pass address and chain. Live.","chain":"Ethereum","source":"honeypot.is public API (api.honeypot.is/v2/GetContractVerification), keyless","address":"0x6982508145454Ce325dDbE47a25d4ec3d2311933","chain_id":1,"is_contract":true,"contract_calls":0,"is_open_source":true,"has_proxy_calls":false,"root_open_source":true,"contracts_checked":1,"full_check_performed":true,"contracts_open_source":1},"meta":{"timestamp":"2026-06-13T04:41:56.251Z","request_id":"3a7d39c0-2f3b-4b5b-bd2a-a2c36ea30785"},"status":"ok","message":"Contract analysis 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/scan":{"get":{"operationId":"get_v1_scan","tags":["Safety"],"summary":"Honeypot verdict + buy/sell tax + risk for a token","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address (0x + 40 hex)","schema":{"type":"string"},"example":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"description":"EVM chain (eth/bsc/base/polygon/arbitrum/avalanche/optimism or chainID; default eth)","schema":{"type":"string"},"example":"eth"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Pepe","note":"The live honeypot/safety check for an EVM token, simulated against its real liquidity pool right now. is_honeypot is true if the sell could not be completed (your money would be trapped) — honeypot_reason says why. buy_tax_pct/sell_tax_pct/transfer_tax_pct are the real taxes the contract charges (a high sell tax is a soft trap even when not a hard honeypot). risk/risk_level/flags are honeypot.is's plain summary. Pass address (token contract) and chain (Ethereum/Optimism/BNB Chain/Polygon/Base/Arbitrum/Avalanche or a numeric chainID; default Ethereum). This is a safety signal, not financial advice. Live.","pair":{"name":"Uniswap V2: PEPE-WETH","address":"0xA43fe16908251ee70EF74718545e4FE6C5cCEc9f","liquidity_usd":19805013.5},"risk":"low","chain":"Ethereum","flags":[],"source":"honeypot.is public API (api.honeypot.is/v2/IsHoneypot), keyless","symbol":"PEPE","address":"0x6982508145454Ce325dDbE47a25d4ec3d2311933","buy_gas":151216,"chain_id":1,"decimals":18,"is_proxy":false,"sell_gas":105214,"risk_level":1,"buy_tax_pct":0,"is_honeypot":false,"open_source":true,"sell_tax_pct":0,"total_holders":556532,"transfer_tax_pct":0,"simulation_success":true},"meta":{"timestamp":"2026-06-13T04:41:56.362Z","request_id":"b10575c1-fb3d-478e-8413-95242be501b6"},"status":"ok","message":"Scan completed 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/pairs":{"get":{"operationId":"get_v1_pairs","tags":["Market"],"summary":"DEX trading pairs with liquidity for a token","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address","schema":{"type":"string"},"example":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"description":"EVM chain (default eth)","schema":{"type":"string"},"example":"eth"},{"name":"limit","in":"query","required":false,"description":"Max pairs (1-50)","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The DEX trading pairs for an EVM token — each with its pool address, the two paired tokens, on-chain reserves, USD liquidity and the router (which DEX). The deepest-liquidity pair is the one a honeypot check simulates against; thin liquidity is itself a risk. Pass address, chain and limit (1-50). Live.","chain":"Ethereum","count":10,"pairs":[{"name":"Uniswap V2: PEPE-WETH","router":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"address":"0xa43fe16908251ee70ef74718545e4fe6c5ccec9f","chain_id":1,"reserves":[3.515708202591076e+30,5.944880741518268e+21],"liquidity_usd":19805013.5},{"name":"Uniswap V3: PEPE-WETH","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"address":"0x11950d141ecb863f01007add7d1a342041227b58","chain_id":1,"reserves":[5.3534336513437606e+29,3.5242840119703626e+19],"liquidity_usd":117941.57},{"name":"Uniswap V3: PEPE-WETH","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"address":"0xf239009a101b6b930a527deaab6961b6e7dec8a6","chain_id":1,"reserves":[7.07793813988336e+27,5853873345007420000],"liquidity_usd":19532.03},{"name":"Uniswap V3: PEPE-MATIC","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"],"address":"0x4476fc21ee9a44c34ec34dd7ac4cfbb5a986e529","chain_id":1,"reserves":[7.96484739398165e+26,2.5812060004269175e+22],"liquidity_usd":9819.63},{"name":"Uniswap V3: WBTC-PEPE","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","0x6982508145454ce325ddbe47a25d4ec3d2311933"],"address":"0x992c59d45dd67706d7aaa118beb331c203858417","chain_id":1,"reserves":[7161499,1.4486685622250744e+27],"liquidity_usd":9085.51},{"name":"Uniswap V3: PEPE-USDC","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"address":"0xcee31c846cbf003f4ceb5bbd234cba03c6e940c7","chain_id":1,"reserves":[9.512410006359558e+26,4339049857],"liquidity_usd":8677.19},{"name":"PancakeSwap V3: PEPE-WETH","router":"0x1b81d678ffb9c0263b24a97847620c99d213eb14","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"],"address":"0x3202acfd55232f3706aa81a4f18a98686b5e1d1b","chain_id":1,"reserves":[1.2734514727612376e+27,1582890767433039000],"liquidity_usd":5272.26},{"name":"Uniswap V3: PEPE-USDT","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xdac17f958d2ee523a2206206994597c13d831ec7"],"address":"0xa7bc6c09907fa2ded89f1c8d05374621cb1f88c5","chain_id":1,"reserves":[1.158425487745157e+27,32895637],"liquidity_usd":65.75},{"name":"Uniswap V2: PEPE-USDC","router":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"address":"0x5a75ed4624bbda1e992dd006ea2aca83d64c30fb","chain_id":1,"reserves":[1.0134554597961036e+25,28349583],"liquidity_usd":56.7},{"name":"Uniswap V3: PEPE-BNB","router":"0xe592427a0aece92de3edee1f18e0157c05861564","tokens":["0x6982508145454ce325ddbe47a25d4ec3d2311933","0xb8c77482e45f1f44de1745f52c74426c631bdd52"],"address":"0x0bc22b3cda38abd5f6583bbabea128c14f978c7c","chain_id":1,"reserves":[4.3547929094776957e+24,20527441267286764],"liquidity_usd":26.92}],"source":"honeypot.is public API (api.honeypot.is/v1/GetPairs), keyless","address":"0x6982508145454Ce325dDbE47a25d4ec3d2311933","chain_id":1},"meta":{"timestamp":"2026-06-13T04:41:56.459Z","request_id":"abf27d39-b030-43fa-8b82-2344c6b78362"},"status":"ok","message":"Pairs 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/holders":{"get":{"operationId":"get_v1_holders","tags":["Holders"],"summary":"Largest holders + top-10 supply concentration","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address","schema":{"type":"string"},"example":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},{"name":"chain","in":"query","required":false,"description":"EVM chain (default eth)","schema":{"type":"string"},"example":"eth"},{"name":"limit","in":"query","required":false,"description":"Max holders (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The largest holders of an EVM token and how concentrated its supply is. top10_concentration_pct is the share of total supply held by the ten biggest wallets — a high figure means a few wallets could dump the token on you (note some top holders are the liquidity pool or known CEX wallets, flagged via alias/is_contract). supply_pct is each holder's share. balance is the raw on-chain amount (apply token decimals for a human figure). Pass address, chain and limit (1-50). Live.","chain":"Ethereum","count":20,"source":"honeypot.is public API (api.honeypot.is/v1/TopHolders), keyless","address":"0x6982508145454Ce325dDbE47a25d4ec3d2311933","holders":[{"address":"0xf977814e90da44bfa03b6295a0616a897441acec","balance":"40000000000000000000000000000000","supply_pct":9.5082,"is_contract":false},{"address":"0x5a52e96bacdabb82fd05763e25335261b270efcb","balance":"33141296548784849877378668900100","supply_pct":7.8778,"is_contract":false},{"address":"0x1d48963dd8fada6ab5c2c7b92eba81ecc5030270","balance":"28424454468599944748790607839220","supply_pct":6.7566,"is_contract":false},{"address":"0x3f9a8345729ea842708e080e238c92731e5699b8","balance":"15106826498227278586742131868515","supply_pct":3.591,"is_contract":false},{"address":"0x611f7bf868a6212f871e89f7e44684045ddfb09d","balance":"13866267870149525164791531110000","supply_pct":3.2961,"is_contract":false},{"address":"0xc671b05671a7cd3080c6ceae79d284bdde0ef271","balance":"9559902433932399148356665292413","supply_pct":2.2724,"is_contract":false},{"address":"0x15da7556d5ed888306839bed06f868aeaedcb0d7","balance":"9073343691353832060906002600000","supply_pct":2.1568,"is_contract":false},{"address":"0x76ec5a0d3632b2133d9f1980903305b62678fbd3","balance":"8164196827630296637833530999119","supply_pct":1.9407,"is_contract":false},{"address":"0x000000000000000000000000000000000000dead","balance":"6917426201966638803916875905641","supply_pct":1.6443,"is_contract":false},{"address":"0xa023f08c70a23abc7edfc5b6b5e171d78dfc947e","balance":"6164153879834181105785176564872","supply_pct":1.4652,"is_contract":false},{"address":"0xc93e48d89f2d6dbc1672908aa68ce7c24d0413b4","balance":"5800000000100020000000000000000","supply_pct":1.3787,"is_contract":false},{"address":"0x262190cce7b2515fc32aba9569e8c1cbee031ccc","balance":"5621514660910235653894585357100","supply_pct":1.3363,"is_contract":false},{"address":"0x59779b3aa3540f45b3e7255b4b5b25a8764be686","balance":"5601738779717224226399874521100","supply_pct":1.3316,"is_contract":false},{"address":"0x43684d03d81d3a4c70da68febdd61029d426f042","balance":"5479390931863770000000000000000","supply_pct":1.3025,"is_contract":false},{"address":"0x40b38765696e3d5d8d9d834d8aad4bb6e418e489","balance":"5056978137620335438564989775384","supply_pct":1.2021,"is_contract":false},{"address":"0xd4bb423838a66347f5d6860437cef53e540b5f13","balance":"4385644553022491928042990429090","supply_pct":1.0425,"is_contract":false},{"address":"0xefef30bd1cca520619306c95091ab18473febc5c","balance":"4065302494867890355269874092615","supply_pct":0.9663,"is_contract":false},{"address":"0xd2dd7b597fd2435b6db61ddf48544fd931e6869f","balance":"3691919486320052175420487300000","supply_pct":0.8776,"is_contract":false},{"address":"0xc3681709ee476308b45812eabe0eb22f3b816880","balance":"3662091085355055000000000000000","supply_pct":0.8705,"is_contract":false},{"address":"0x841ed663f2636863d40be4ee76243377dff13a34","balance":"3626176527260161841975485804531","supply_pct":0.862,"is_contract":false}],"chain_id":1,"total_supply":"420689899646442539491331875576506","top10_concentration_pct":40.51},"meta":{"timestamp":"2026-06-13T04:41:56.569Z","request_id":"070cf7e9-dabb-4629-b244-ee56b056b28a"},"status":"ok","message":"Holders 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":"scan/pairs/holders/contract all take address (the token contract, 0x + 40 hex) and chain (Ethereum/Optimism/BNB Chain/Polygon/Base/Arbitrum/Avalanche or a numeric EVM chainID; default Ethereum). pairs and holders also take limit (1-50). meta takes no parameters. Honeypot detection is a live on-chain simulation; results are a safety signal, not financial advice — always verify before trading.","sample":{"symbol":"PEPE","is_honeypot":false,"sell_tax_pct":0},"source":"honeypot.is public API (api.honeypot.is), keyless, live","service":"honeypot-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/scan":"Honeypot verdict + buy/sell tax + risk for a token (address=0x..., chain=eth).","GET /v1/pairs":"DEX trading pairs with liquidity for a token.","GET /v1/holders":"Largest holders + top-10 supply concentration.","GET /v1/contract":"Source-verification and proxy-call analysis."},"description":"Live EVM token-safety checks from honeypot.is, keyless. A honeypot is a token you can buy but cannot sell; honeypot.is detects it by actually simulating a buy and a sell against the token's real liquidity pool on-chain. The scan endpoint returns the honeypot verdict, the live buy/sell/transfer tax, gas and a risk summary; pairs lists the token's DEX trading pairs with reserves and USD liquidity; holders returns the largest holders and the top-10 supply concentration; contract reports whether the source is verified/open and whether it makes proxy calls. The EVM token-safety cut (Ethereum, BNB Chain, Base and other EVM chains) — distinct from the Solana rug-risk feed (rugcheck), which inspects SPL mint authorities on a different chain. A safety signal, not financial advice.","upstream_status":"ok","supported_chains":{"1":"Ethereum","10":"Optimism","56":"BNB Chain","137":"Polygon","8453":"Base","42161":"Arbitrum","43114":"Avalanche"}},"meta":{"timestamp":"2026-06-13T04:41:56.684Z","request_id":"b20edf16-cb44-4baa-a779-4e1162f27dc2"},"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":10000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":2900,"monthly_call_quota":160000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":8400,"monthly_call_quota":700000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":23500,"monthly_call_quota":3400000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/honeypot-api"}