{"service":"tokenguard API","version":"1.0.0","description":"Heuristic ERC-20 rug/safety check over public RPC — flags what a token owner CAN do.","detects":["infinite mint / supply inflation","blacklist / freeze holders","pausable transfers","mutable tax/fee (sell-tax honeypot)","max-tx throttling","upgradeable proxy (EIP-1967 / OZ-legacy / beacon)","non-renounced ownership / centralization"],"chains":["base","ethereum","arbitrum","optimism","polygon","bsc"],"danger_selectors":18,"endpoints":{"GET /":"Service info (free)","GET /health":"Health check (free)","POST /scan":"Token rug/safety scan ($0.02 USDC)","POST /wallet":"Wallet intelligence — balances, tx count, EOA/contract, risk flags ($0.02 USDC)","POST /price":"Token price, liquidity, FDV, 24h vol/change ($0.02 USDC)","POST /explain":"Identify an address — EOA/contract, ERC20/721/1155, proxy ($0.02 USDC)","POST /ens":"ENS resolve name<->address ($0.02 USDC)","POST /gas":"Current gas price + base fee for a chain ($0.02 USDC)","POST /onchain_pulse":"One-call on-chain digest: biggest TVL shifts with $ amounts, gas, stables, sentiment ($0.05 USDC)","POST /safe_yields":"Risk-ADJUSTED DeFi yields — ranked by yield per unit of risk, each pool contract-scanned ($0.05 USDC)","POST /yields":"Best DeFi yields (DefiLlama), filter by chain/asset/TVL ($0.05 USDC)","POST /tvl":"Protocol TVL ranking + momentum ($0.05 USDC)","POST /news":"Latest crypto news from 6 major outlets, LLM-ready, filterable ($0.02 USDC)","POST /fx":"Fiat FX rates + conversion (160+ currencies, ECB-backed) ($0.02 USDC)","POST /weather":"Current weather + forecast for any city/coords (Open-Meteo) ($0.02 USDC)","POST /polymarket":"Active prediction markets with YES probabilities (Polymarket CLOB) ($0.02 USDC)","POST /solana":"Solana wallet intelligence — SOL balance + SPL tokens (public RPC) ($0.02 USDC)","POST /ip":"IP geolocation — country/city/lat-lon/ISP/timezone (ipwho.is) ($0.02 USDC)","POST /mempool":"Bitcoin mempool stats + fee estimates sat/vB (mempool.space) ($0.02 USDC)","POST /search":"Knowledge search via Wikipedia+DuckDuckGo — AI agent research ($0.02 USDC)","POST /nft":"NFT collection floor price + volume (CoinGecko) ($0.02 USDC)","POST /trending":"Trending crypto coins+NFTs by search volume (CoinGecko) ($0.02 USDC)","POST /exchange":"Top CEX/DEX by trust score + volume (CoinGecko) ($0.02 USDC)","POST /defi":"DeFi protocol TVL by chain + category (DeFiLlama) ($0.02 USDC)","POST /market":"Global crypto market overview — dominance, volume, market cap (CoinGecko) ($0.02 USDC)","POST /categories":"Top coin categories by market cap — DeFi/NFT/L1/L2/etc (CoinGecko) ($0.02 USDC)","POST /protocols":"DeFi protocol TVL ranking 7742+ protocols, filter by chain/category (DeFiLlama) ($0.02 USDC)","POST /stablecoins":"Stablecoin circulating supply ranking 385+ stables (DeFiLlama) ($0.02 USDC)","POST /chains":"Blockchain TVL overview — 469+ chains ranked by TVL (DeFiLlama) ($0.02 USDC)","POST /hacks":"DeFi exploit history — 574+ incidents sorted by funds lost (DeFiLlama) ($0.02 USDC)","POST /fees":"Protocol fees/revenue — 30d totals for top DeFi protocols (DeFiLlama) ($0.02 USDC)","POST /derivatives":"Derivatives exchanges by open interest — futures/perps (CoinGecko) ($0.02 USDC)","POST /fear_greed":"Crypto Fear & Greed Index 0-100 (alternative.me) ($0.02 USDC)","POST /lightning":"Bitcoin Lightning Network stats — nodes/channels/capacity (mempool.space) ($0.02 USDC)","POST /coinpaprika":"CoinPaprika global market overview — dominance/ATH/active coins ($0.02 USDC)","POST /pyth":"Pyth Network oracle price feed — BTC/ETH/SOL/BNB/USDC real-time ($0.02 USDC)","POST /raydium":"Raydium DEX stats — TVL/volume/fees/APR (Solana AMM) ($0.02 USDC)","POST /dydx":"dYdX v4 perpetual markets — oracle price/funding/OI for 296+ perps ($0.02 USDC)","POST /lido":"Lido stETH staking stats — total staked ETH/APR/holders ($0.02 USDC)","POST /pendle":"Pendle yield tokenization markets — implied APY/fixed yield/liquidity ($0.02 USDC)","POST /orca":"Orca Whirlpool Solana DEX — 14,983+ pools ranked by TVL/volume ($0.02 USDC)","POST /morpho":"Morpho Blue lending vaults — supply APY/borrow APY per asset ($0.02 USDC)","POST /gmx":"GMX v2 perpetual DEX — 127 markets with OI/APR/utilization (Arbitrum) ($0.02 USDC)","POST /btc_rates":"BTC-denominated exchange rates for 76 fiat+crypto currencies (CoinGecko) ($0.02 USDC)","POST /commodities":"Precious metals spot prices: Gold/Silver/Platinum/Palladium in USD (gold-api.com) ($0.02 USDC)","POST /stocks":"US stock prices + S&P 500/NASDAQ/Dow Jones indices (Yahoo Finance) ($0.02 USDC)","POST /btc_stats":"Bitcoin network stats: hash rate, tx count, block time, supply (blockchain.info) ($0.02 USDC)","POST /macro":"Macro economic indicators: inflation/GDP/unemployment for major economies (World Bank) ($0.02 USDC)","POST /token_chart":"Historical price + volume chart for any crypto token up to 365 days (CoinGecko) ($0.02 USDC)","POST /token_dev":"GitHub developer activity for crypto projects: commits/stars/forks/PRs (CoinGecko) ($0.02 USDC)","POST /global_defi":"DeFi global overview: market cap, ETH ratio, dominance, top DeFi coin (CoinGecko) ($0.02 USDC)","POST /scan/trending":"Rug-safety scan of the tokens trending on a chain right now — mint, blacklist, pausable, tax, proxy, ownership. No input required. ($0.005 USDC)","POST /price/trending":"Live price, liquidity, FDV and 24h move for the tokens trending on a chain right now. No input required. ($0.005 USDC)","POST /explain/trending":"What the tokens trending on a chain right now actually are — contract type, tags and a one-line summary. No input required. ($0.005 USDC)","POST /wallet/trending":"Who controls the tokens trending right now — resolves each token's owner and profiles that wallet's balance, activity and flags. No input required. ($0.005 USDC)","POST /nft/trending":"Trending NFT collections with floor price, 24h move, volume and average sale. No input required. ($0.005 USDC)","POST /depeg_radar":"Stablecoin DEPEG-RISK radar: a computed 0-100 risk score per USD stablecoin combining peg deviation (below-peg discounts weighted over premiums, since a discount signals redemption/insolvency fear while a premium is usually yield-bearing by design), 7-day circulating-supply change (redemption pressure), and size (a >$1B coin off-peg raises a systemic flag). Scored, classified (OK/WATCH/ELEVATED/DEPEG) and direction-aware — an early-warning signal, not a raw price list. Zero-input; one DeFiLlama call, no key. ($0.005 USDC)","POST /web/search":"What does the open web say about this query? Ranked title/url/snippet results for agents, served through an automatic multi-engine failover chain so a single call still answers when any one backend is blocked, rate-limited or timing out from a datacenter IP ($0.05 USDC)","POST /web/read":"Fetch a URL and return its main content as clean Markdown (boilerplate stripped) ($0.02 USDC)","POST /web/crawl":"Crawl a site from a start URL (same-domain, breadth-first) and return each page as clean Markdown ($0.02 USDC)","POST /web/sitemap":"Enumerate a site's URLs from robots.txt + sitemap.xml (sitemap-index aware) — map a domain before crawling it ($0.02 USDC)","POST /web/rss":"Parse an RSS/Atom feed into structured items (title, link, published, summary) — or auto-discover the feed from a site URL ($0.02 USDC)","POST /social/bluesky":"Bluesky (AT Protocol) public data: an account's profile plus recent posts with engagement counts, or a keyword post search ($0.02 USDC)","POST /social/mastodon":"Fediverse posts: search any Mastodon instance or read its public timeline, with author, engagement and hashtags ($0.02 USDC)","POST /social/lemmy":"Lemmy (fediverse link aggregator) posts from an instance or a single community, with score and comment counts ($0.02 USDC)","POST /social/hn":"Hacker News full-archive search: stories, comments, Show HN and Ask HN with points, comment counts and URLs ($0.02 USDC)","POST /dev/package":"Package intelligence across npm, PyPI and crates.io in one call: latest version, license, repository, dependencies and download counts ($0.02 USDC)","POST /dev/github":"Public GitHub facts: repo stats with latest release, a user/org profile, or a star-ranked repo search ($0.02 USDC)","POST /dev/stackoverflow":"Stack Exchange question search with score, answer count and whether an answer was accepted ($0.02 USDC)","POST /data/whois":"Domain registration facts over RDAP (structured WHOIS): registrar, creation and expiry dates, status codes, nameservers ($0.02 USDC)","POST /data/certs":"Certificate-transparency history for a domain (crt.sh) — every TLS certificate issued, which doubles as subdomain discovery ($0.02 USDC)","POST /data/wayback":"Internet Archive lookup: whether a snapshot of a URL exists and its closest capture to a given date — read pages that are now dead ($0.02 USDC)","POST /data/papers":"Academic literature search over OpenAlex (250M+ works with citation counts) or arXiv: title, authors, year, venue, DOI, abstract ($0.02 USDC)","POST /data/geocode":"Place name to coordinates, or coordinates to address (OpenStreetMap Nominatim), with country and feature type ($0.02 USDC)","POST /data/country":"Country reference data: capital, region, population, area, currencies, languages, calling code, timezones and borders ($0.02 USDC)","POST /dev/vulns":"Known vulnerabilities for a package (OSV.dev — aggregate of GHSA, PyPA, RustSec, Go and more) or a free-text CVE search (NVD), with severity and fixed versions ($0.02 USDC)","POST /dev/scorecard":"Supply-chain health from deps.dev: OpenSSF Scorecard (14 checks — branch protection, signed releases, pinned deps…) plus stars, license and open issues ($0.02 USDC)","POST /dev/models":"Search the Hugging Face Hub for models or datasets (downloads, likes, task, library, tags) or fetch one by id ($0.02 USDC)","POST /dev/docker":"Docker Hub image facts: pull count, stars, description, last push, and recent tags with sizes and architectures ($0.02 USDC)","POST /data/sec":"US SEC filings data: resolve a ticker to its CIK, then pull a reported XBRL financial concept (Revenues, Assets, NetIncomeLoss…) as a time series ($0.02 USDC)","POST /data/pubmed":"Biomedical literature search over PubMed (NCBI, 37M+ citations): titles, journals, authors, dates and DOIs ($0.02 USDC)","POST /data/holidays":"Public holidays for a country and year (ISO-2 code) — what a scheduling agent needs before proposing a date ($0.02 USDC)","POST /data/books":"Book search over Open Library: title, authors, first publication year, subjects, ISBNs and edition count ($0.02 USDC)","POST /sanctions":"OFAC SDN sanctions screening for a crypto address or a person/company name. Covers all 963 digital-currency addresses OFAC lists across 19 chains (BTC, ETH, TRX, USDT, SOL, XMR and more) plus 19k sanctioned entities and their aliases. Straight from the US Treasury's own list, refreshed daily. ($0.02 USDC)","POST /brief/token":"One-call token due diligence: structural rug/safety scan, live liquidity and market depth, optional dev activity, resolved into a single ok/caution/avoid verdict with the flags that drove it. ($0.05 USDC)","POST /brief/wallet":"One-call counterparty check: wallet activity profile (EOA vs contract, balances, tx count, risk flags) plus OFAC SDN sanctions screening, resolved into a single clear/blocked verdict. Reports 'unscreened' rather than 'clear' if the sanctions list could not be consulted. ($0.05 USDC)","POST /brief/market":"One-call crypto market regime: total market cap and 24h change, Fear & Greed sentiment, and perp funding/open interest, resolved into risk-on / neutral / risk-off plus a crowded-long / crowded-short positioning read. Surfaces leverage fragility that price alone does not show. ($0.05 USDC)","POST /brief/chain":"One-call chain health: current gas cost and congestion level, 30-day TVL trend, and recent exploits filtered to that chain, resolved into a healthy / mixed / strained verdict. Supports base, ethereum, arbitrum, optimism, polygon, bsc. ($0.05 USDC)","POST /brief/company":"One-call company and domain profile from public records: RDAP registration (age, registrar, status, expiry, nameservers) plus certificate-transparency history for infrastructure footprint and subdomain discovery, resolved into a new / established / mature maturity read. Domain-based lead qualification and counterparty vetting without a proprietary data licence. ($0.05 USDC)","POST /brief/entity":"Resolve a company name to canonical public identifiers in one call: GLEIF LEI (with registered country, city and status), SEC CIK and ticker, and Wikidata QID, returned as ranked candidates with a name-similarity score. Company disambiguation and KYB from public registries, freely redistributable. ($0.05 USDC)","POST /intel/x402":"Full x402 market-intelligence report from a complete CDP Bazaar dump: demand-to-supply ratio for every tag with HOST CONCENTRATION so an incumbent's garden is not mistaken for an opening, price percentiles for resources that actually earn (broken out by category), the high-value tier charging $50-$3,208 per call, and calls-per-payer retention for the top 30 earning hosts. Answers what to build, what to charge, and what to avoid. Free preview at GET /intel/x402/preview. ($1.00 USDC)","POST /llm/answer":"What is the actual answer to this question, according to the live web right now? Runs a multi-engine search, reads the top pages, and returns one synthesised answer with inline [1][2] citations and the source URLs behind them — the whole search-read-summarise loop in a single paid call instead of a dozen ($0.02 USDC)","POST /llm/chat":"Run a chat completion against an open-weight 20B-class model — plain prompt in, text out, with automatic failover across independent inference backends so a single call still answers when any one provider is down or rate-limiting ($0.05 USDC)","POST /llm/extract":"Turn messy text — or any URL's page content — into structured JSON matching the shape you ask for, so an agent can consume a web page as data instead of prose ($0.05 USDC)","POST /world/airquality":"How breathable is the air in this place right now? Current PM2.5, PM10, ozone, NO2, SO2, CO and dust plus both the US and European AQI, and the US AQI band ('Good', 'Unhealthy') so the number is directly actionable. Takes a place name, not coordinates ($0.02 USDC)","POST /world/geocode":"Turn a place name into coordinates, country, admin region, timezone, elevation and population — the lookup every other location-aware call needs first ($0.02 USDC)","POST /world/earthquakes":"Which earthquakes have just happened? Recent USGS events worldwide or within a radius of a named place, with magnitude, depth, tsunami flag and felt reports ($0.02 USDC)","POST /world/holidays":"Which days are public holidays in this country? Full year of national and regional holidays with local names and a past/upcoming flag — date arithmetic an agent cannot infer from a calendar alone ($0.02 USDC)","POST /world/indicators":"What are this country's headline economics? World Bank time series for GDP, GDP per capita, population, inflation, unemployment, life expectancy, CO2 per capita or internet penetration, by plain-English alias or raw indicator code ($0.02 USDC)","POST /world/elevation":"How high above sea level is this point? Ground elevation in metres for a place name or a coordinate pair ($0.02 USDC)","POST /cex":"Centralised-exchange metrics: reported volume, pairs and traffic per venue. ($0.02 USDC)","POST /funding":"Current perpetual funding rates across venues. ($0.02 USDC)","POST /dex_agg":"DEX aggregator routing and quoted execution across venues. ($0.02 USDC)","POST /top_movers":"Largest gainers and losers over a window, with volume context. ($0.02 USDC)","POST /orderbook":"Live order-book depth and spread for a pair. ($0.02 USDC)","POST /options":"Options chains: strikes, expiries, implied volatility and open interest. ($0.02 USDC)","POST /liquidations":"Recent liquidations by venue and side, with sizes. ($0.02 USDC)","POST /whale":"Large-holder activity: concentration and recent significant transfers. ($0.02 USDC)","POST /futures":"Futures markets: term structure, basis and open interest. ($0.02 USDC)","POST /screener":"Screen assets on liquidity, volume and momentum filters. ($0.02 USDC)","POST /lending":"Lending-market supply and borrow rates with utilisation, per protocol. ($0.02 USDC)","POST /bridge":"Cross-chain bridge volume and flows, by bridge and by route. ($0.02 USDC)","POST /gas_history":"Historical gas prices per chain, for cost modelling. ($0.02 USDC)","POST /dominance":"Market-share dominance by asset, and how it is shifting. ($0.02 USDC)","POST /borrow":"Borrow rates across lending markets: per-asset APR, utilisation and available liquidity. ($0.02 USDC)","POST /chainlink":"Chainlink oracle feeds: current answer, decimals and last-update age. ($0.02 USDC)","POST /nft_stats":"NFT market statistics: volume, floor and holder counts by collection. ($0.02 USDC)","POST /correlation":"Pairwise price correlation between assets over a chosen window. ($0.02 USDC)","POST /trending_nfts":"NFT collections trending by volume and unique buyers. ($0.02 USDC)","POST /stablecoin_peg":"Stablecoin peg deviation and depth, per issuer. ($0.02 USDC)","POST /kline":"OHLCV candlesticks at a chosen interval, for any listed pair. ($0.02 USDC)","POST /long_short":"Long/short account and position ratios per venue. ($0.02 USDC)","POST /funding_history":"Historical perpetual funding rates, for carry and basis work. ($0.02 USDC)","POST /chain_tvl":"Total value locked per chain, with the change over time. ($0.02 USDC)","POST /protocol_detail":"One protocol in depth: TVL, chains, tokens and history. ($0.02 USDC)","POST /open_interest":"Open interest by venue and contract, with the change over time. ($0.02 USDC)","POST /derivatives_exchanges":"Derivatives venues ranked by open interest and volume. ($0.02 USDC)","POST /protocol_revenue":"Revenue retained by a protocol, separated from total fees. ($0.02 USDC)","POST /options_volume":"Options volume and put/call ratio by expiry. ($0.02 USDC)","POST /dex_volumes":"DEX trading volume by protocol and by chain. ($0.02 USDC)","POST /protocol_fees":"Fees earned by a protocol, daily and cumulative. ($0.02 USDC)","POST /ohlc":"Open/high/low/close series for an asset over a chosen range. ($0.02 USDC)","POST /derivatives_tickers":"Per-contract derivatives tickers: mark price, basis, volume. ($0.02 USDC)","POST /exchange_volume":"Exchange volume time series, per venue. ($0.02 USDC)","GET /world/airquality":"How breathable is the air in this place right now? Current PM2.5, PM10, ozone, NO2, SO2, CO and dust plus both the US and European AQI, and the US AQI band ('Good', 'Unhealthy') so the number is directly actionable. Takes a place name, not coordinates ($0.02 USDC)","GET /world/earthquakes":"Which earthquakes have just happened? Recent USGS events worldwide or within a radius of a named place, with magnitude, depth, tsunami flag and felt reports ($0.02 USDC)","GET /world/elevation":"How high above sea level is this point? Ground elevation in metres for a place name or a coordinate pair ($0.02 USDC)","GET /world/geocode":"Turn a place name into coordinates, country, admin region, timezone, elevation and population — the lookup every other location-aware call needs first ($0.02 USDC)","GET /world/holidays":"Which days are public holidays in this country? Full year of national and regional holidays with local names and a past/upcoming flag — date arithmetic an agent cannot infer from a calendar alone ($0.02 USDC)","GET /world/indicators":"What are this country's headline economics? World Bank time series for GDP, GDP per capita, population, inflation, unemployment, life expectancy, CO2 per capita or internet penetration, by plain-English alias or raw indicator code ($0.02 USDC)"},"payment":{"method":"x402","x402_version":2,"currency":"USDC","network":"Base (eip155:8453)","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","wallet":"0x5bCDA55247B238a573A968B234F788a2D35664Dd","x402_enabled":true}}