{"openapi":"3.1.0","info":{"title":"x402 Agent Hub — Onchain Token Security, CFD Microstructure, B2B Lead Dossiers & Visual Studio","version":"1.5.0","description":"Pay-per-call x402 v2 API hub on Base (USDC) providing a cheap multichain Onchain Read API (balances, tokens, transactions, contracts, ENS, portfolios), a US public-company data API from SEC EDGAR (search, profiles, filings, fundamentals, insider trades), worldwide company and notable-person enrichment from Wikidata, Base/EVM/Solana token honeypot & DEX liquidity audits with live swap simulation, ECN CFD/Forex microstructure & ICT killzones, prop-firm risk guard, B2B WhatsApp/SEO outreach dossiers, and deterministic SVG/PNG visual card rendering.","x-guidance":"x402 Agent Hub: 24 pay-per-call HTTP APIs ($0.002-$0.05 USD) settled via x402 v2 (Base Mainnet (USDC), eip155:8453). No API keys: call once to get the 402 PAYMENT-REQUIRED challenge, retry with a signed PAYMENT-SIGNATURE header.\n1) GET /v1/trading/sessions ($0.005): ICT killzones, Silver Bullet windows, rollover alerts.\n2) GET /v1/trading/microstructure ($0.01): ECN spreads, commissions and ATR cost ratios for 14 CFD/FX symbols.\n3) POST /v1/trading/prop-risk ($0.01): Prop-firm lot sizing with drawdown guard.\n4) POST /v1/crypto/token-audit ($0.01): Token honeypot/tax/liquidity audit with live buy/sell simulation.\n5) POST /v1/web/extract ($0.005): Webpage to clean LLM Markdown.\n6) POST /v1/web/lead-enrich ($0.015): Business domain contacts and tech stack.\n7) POST /v1/web/seo-audit ($0.02): 0-100 technical SEO audit.\n8) POST /v1/web/outreach-dossier ($0.05): Lead enrichment plus SEO audit and outreach scripts.\n9) POST /v1/render/card ($0.025): OpenGraph, KPI and sparkline cards as SVG/PNG.\nOnchain Read API (you only pay for successful calls):\n10) GET /v1/chain/balance ($0.002): Native coin balance (ETH, BNB, POL, AVAX) of any address on 7 EVM chains.\n11) GET /v1/chain/token-balance ($0.002): ERC-20 balance of an address, already scaled by the token's decimals.\n12) GET /v1/chain/token-info ($0.002): ERC-20 name, symbol, decimals and total supply.\n13) GET /v1/chain/tx ($0.002): Transaction status, confirmations, value and total fee (incl. L2 L1-data fee).\n14) GET /v1/chain/address-info ($0.003): EOA vs contract, EIP-7702 delegation, proxy implementation, nonce and balance.\n15) GET /v1/chain/ens ($0.002): ENS forward (name -> address) or reverse (address -> primary name) resolution.\n16) GET /v1/chain/portfolio ($0.005): One-call multichain portfolio: native + USDC/USDT balances on 7 EVM chains.\nCompany Data API (SEC EDGAR) (you only pay for successful calls):\n17) GET /v1/company/search ($0.002): Find a US public company's ticker and SEC CIK by name or ticker.\n18) GET /v1/company/profile ($0.002): Company profile: industry, exchanges, fiscal year end, address and latest 10-K/10-Q/8-K links.\n19) GET /v1/company/financials ($0.005): Annual or quarterly fundamentals: revenue, net income, EPS, cash flow, FCF, margins, YoY growth.\n20) GET /v1/company/filings ($0.002): Latest SEC filings (10-K, 10-Q, 8-K, S-1, ...) with direct document links.\n21) GET /v1/company/insider-trades ($0.005): Recent Form 4 insider trades: who bought/sold, shares, price, value and 10b5-1 flag.\nEntity Enrichment API (Wikidata) (you only pay for successful calls):\n22) GET /v1/entity/search ($0.002): Find companies or notable people by name, with Wikidata IDs to disambiguate.\n23) GET /v1/entity/company ($0.003): Company enrichment by name or domain: HQ, industry, CEO, founders, headcount, listings, LEI, socials.\n24) GET /v1/entity/person ($0.003): Notable-person profile: occupations, current employer and roles, education, public social accounts.","contact":{"url":"https://x402-agent-hub.x402-agent-hub.workers.dev","email":"jevon.naldo@gmail.com"}},"servers":[{"url":"https://x402-agent-hub.x402-agent-hub.workers.dev","description":"Cloudflare Edge Global x402 Gateway"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://x402-agent-hub.x402-agent-hub.workers.dev/llms.txt"},"paths":{"/v1/trading/sessions":{"get":{"operationId":"getIctTradingSessions","summary":"Live ICT Killzones, Silver Bullet windows, and CFD rollover spread-danger alerts","description":"Evaluates institutional ICT Killzones (Asian, London Open, NY Open, London Close), 60-minute Silver Bullet FVG windows, daily CFD rollover liquidity danger windows, and Wednesday/Friday triple-swap flags.","tags":["CFD & ICT Oracle"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"at","in":"query","required":false,"description":"Optional ISO-8601 UTC timestamp to evaluate ICT killzones at (e.g. 2026-10-30T14:30:00Z). Omit to evaluate live current UTC time.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"ICT killzone & CFD session intelligence report","content":{"application/json":{"schema":{"type":"object","required":["timestampUtc","fxCfdMarketOpen","activeKillzones","activeSilverBullets","executionAlerts"],"properties":{"timestampUtc":{"type":"string","format":"date-time"},"nyTimeFormatted":{"type":"string"},"fxCfdMarketOpen":{"type":"boolean"},"activeKillzones":{"type":"array","items":{"type":"string"}},"activeSilverBullets":{"type":"array","items":{"type":"string"}},"executionAlerts":{"type":"object","required":["rolloverSpreadDanger","recommendation"],"properties":{"rolloverSpreadDanger":{"type":"boolean"},"wednesdayTripleSwapFxMetals":{"type":"boolean"},"fridayTripleSwapCryptoIndices":{"type":"boolean"},"recommendation":{"type":"string"}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/trading/microstructure":{"get":{"operationId":"getEcnMicrostructure","summary":"Institutional ECN CFD & Forex spread, commission, ATR cost ratio & live FVG oracle","description":"Returns tick-calibrated ECN median spreads, round-turn commissions, M1 ATR, spread-to-ATR execution friction across M1/M5/M15/H1, scalping viability verdicts, and optional live MT5 closed-bar FVG feed for 14 flagship symbols (XAUUSD, BTCUSD, NAS100, US30, US500, GER40, JPN225, USOUSD, EURUSD, GBPUSD, USDJPY, etc.).","tags":["CFD & ICT Oracle"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional ticker symbol (e.g. XAUUSD, BTCUSD, NAS100, US30, US500, GER40, JPN225, USOUSD, EURUSD, GBPUSD, USDJPY). Omit to return all 14 calibrated instruments.","schema":{"type":"string"}}],"responses":{"200":{"description":"ECN microstructure & execution cost report","content":{"application/json":{"schema":{"type":"object","required":["found","count","instruments"],"properties":{"found":{"type":"boolean"},"count":{"type":"integer"},"instruments":{"type":"array","items":{"type":"object","required":["symbol","assetClass","ecnMetrics","scalpingViability"],"properties":{"symbol":{"type":"string"},"assetClass":{"type":"string"},"ecnMetrics":{"type":"object"},"costToAtrPercent":{"type":"object"},"scalpingViability":{"type":"object"}}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/trading/prop-risk":{"post":{"operationId":"calculatePropFirmRisk","summary":"Prop-firm position sizing & daily/max drawdown auto-lock calculator","description":"Computes exact lot size accounting for ECN spread + commission friction, remaining daily and total drawdown buffers, consecutive losses until breach, and automatic trade-lock protection for FTMO/prop-firm trading agents.","tags":["CFD & ICT Oracle"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["symbol","accountBalanceUsd","riskPercent","stopLossPriceDistance"],"properties":{"symbol":{"type":"string","description":"Instrument symbol (e.g. XAUUSD, NAS100, EURUSD, BTCUSD)"},"accountBalanceUsd":{"type":"number","description":"Starting or reference account balance in USD (e.g. 100000)"},"currentEquityUsd":{"type":"number","description":"Current live equity in USD (defaults to accountBalanceUsd)"},"riskPercent":{"type":"number","description":"Risk percentage per trade (e.g. 0.5 for 0.5%)"},"stopLossPriceDistance":{"type":"number","description":"Stop-loss distance in raw price units (e.g. 4.5 on XAUUSD, 25 on NAS100)"},"dailyDrawdownLimitPercent":{"type":"number","description":"Prop-firm daily drawdown breach % (default 5)"},"maxTotalDrawdownLimitPercent":{"type":"number","description":"Prop-firm max total drawdown breach % (default 10)"}}}}}},"responses":{"200":{"description":"Position sizing and prop-firm drawdown guard assessment","content":{"application/json":{"schema":{"type":"object","required":["ok","symbol","sizing","propFirmGuard"],"properties":{"ok":{"type":"boolean"},"symbol":{"type":"string"},"sizing":{"type":"object","required":["recommendedLots","trueRiskIncludingEcnFrictionUsd"],"properties":{"recommendedLots":{"type":"number"},"ecnRoundTurnFrictionUsd":{"type":"number"},"trueRiskIncludingEcnFrictionUsd":{"type":"number"}}},"propFirmGuard":{"type":"object","required":["locked","status","consecutiveLossesUntilBreach"],"properties":{"locked":{"type":"boolean"},"status":{"type":"string"},"consecutiveLossesUntilBreach":{"type":"integer"}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/web/extract":{"post":{"operationId":"extractWebMarkdown","summary":"Convert any public URL into clean, token-efficient LLM Markdown","description":"SSRF-protected webpage fetcher and HTML-to-Markdown distiller returning clean structured Markdown, page title, meta description, canonical URL, latency, word count, and token estimate.","tags":["Web & Lead Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public http/https URL to fetch and convert to Markdown"},"maxChars":{"type":"integer","minimum":500,"maximum":50000,"description":"Maximum Markdown characters to return (default 15000)"}}}}}},"responses":{"200":{"description":"Extracted Markdown and page metadata","content":{"application/json":{"schema":{"type":"object","required":["url","httpStatus","title","wordCount","markdown"],"properties":{"url":{"type":"string"},"finalUrl":{"type":"string"},"httpStatus":{"type":"integer"},"title":{"type":"string"},"metaDescription":{"type":"string"},"wordCount":{"type":"integer"},"estimatedTokens":{"type":"integer"},"markdown":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/web/lead-enrich":{"post":{"operationId":"enrichBusinessLead","summary":"Business domain lead enricher with WhatsApp extractor & Phantom Lead Shield","description":"Enriches a business URL for SDR/sales agents: cleans noisy brand names, classifies authentic websites vs wa.me/linktr.ee/marketplace links (Phantom Lead Shield), extracts normalized E.164 WhatsApp/mobile phones while rejecting office PSTN landlines, discovers emails and socials, and fingerprints CMS/analytics pixels.","tags":["Web & Lead Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Target business website, social bio, or marketplace URL"},"businessName":{"type":"string","description":"Optional raw business/Google Maps title to sanitize"}}}}}},"responses":{"200":{"description":"Enriched business lead dossier","content":{"application/json":{"schema":{"type":"object","required":["sanitizedBrandName","phantomLeadShield","contacts","techStack"],"properties":{"sanitizedBrandName":{"type":"string"},"phantomLeadShield":{"type":"object","required":["isAuthenticWebsite","recommendedTrack"],"properties":{"isAuthenticWebsite":{"type":"boolean"},"classification":{"type":"string"},"recommendedTrack":{"type":"string"}}},"contacts":{"type":"object","required":["whatsappAndMobile","emails"],"properties":{"whatsappAndMobile":{"type":"array","items":{"type":"string"}},"rejectedLandlines":{"type":"array","items":{"type":"string"}},"emails":{"type":"array","items":{"type":"string"}},"socialLinks":{"type":"object"}}},"techStack":{"type":"array","items":{"type":"string"}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/web/seo-audit":{"post":{"operationId":"auditWebsiteSeo","summary":"Instant 0-100 Technical SEO & Website Modernization Audit","description":"Audits any public webpage across HTTPS, title/meta lengths, mobile viewport, H1 hierarchy, canonical tags, OpenGraph completeness, Schema.org JSON-LD, image alt-text coverage, and security headers, returning a 0-100 score, letter grade, modernization verdict, and prioritized fixes.","tags":["Web & Lead Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Target website URL to audit"}}}}}},"responses":{"200":{"description":"Technical SEO & modernization audit report","content":{"application/json":{"schema":{"type":"object","required":["url","seoScore","grade","modernizationCandidate","prioritizedFixes"],"properties":{"url":{"type":"string"},"seoScore":{"type":"integer","minimum":0,"maximum":100},"grade":{"type":"string"},"modernizationCandidate":{"type":"boolean"},"checks":{"type":"object"},"prioritizedFixes":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string"},"issue":{"type":"string"},"fix":{"type":"string"}}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/render/card":{"post":{"operationId":"renderVisualCard","summary":"Deterministic OpenGraph banner, social KPI slide & sparkline card renderer (SVG/PNG)","description":"Renders crisp, typo-free 1200x630 OpenGraph banners, 1080x1350 portrait social KPI cards, or trading signal sparkline charts as JSON (SVG + base64 data URI), raw vector SVG, or rasterized binary PNG.","tags":["Deterministic Visual Studio"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.025"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"template":{"type":"string","enum":["og_banner","social_kpi","trading_signal"],"description":"Layout preset (og_banner 1200x630, social_kpi 1080x1350, trading_signal 1200x630)"},"title":{"type":"string","minLength":1,"description":"Primary card headline"},"subtitle":{"type":"string","description":"Supporting subtitle text"},"badge":{"type":"string","description":"Top pill badge text"},"metricLabel":{"type":"string","description":"KPI card label"},"metricValue":{"type":"string","description":"Primary KPI stat"},"metricDelta":{"type":"string","description":"KPI delta or change text"},"sparkline":{"type":"array","items":{"type":"number"},"description":"Numeric values for deterministic area sparkline chart"},"brandName":{"type":"string","description":"Footer brand attribution"},"accentColor":{"type":"string","description":"6-digit hex accent color (e.g. #10B981)"},"theme":{"type":"string","enum":["dark","light"]},"format":{"type":"string","enum":["json","svg","png"],"description":"Output format: json (default), svg, or png"}}}}}},"responses":{"200":{"description":"Rendered visual card payload (JSON with SVG data URI, or image/svg+xml, or image/png)","content":{"application/json":{"schema":{"type":"object","required":["width","height","mimeType","svg","dataUri"],"properties":{"template":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"mimeType":{"type":"string"},"svg":{"type":"string"},"dataUri":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/v1/crypto/token-audit":{"post":{"operationId":"auditCryptoToken","summary":"Onchain Token Rug, Honeypot, Tax & DEX Liquidity Execution Audit (Base/EVM/Solana)","description":"Audits any EVM (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche) or Solana token contract for honeypots, buy/sell transfer taxes, hidden ownership, mintable supply, whale concentration, LP lock ratio, live DEX liquidity depth, and AMM slippage impact for an intended USD trade size. On Base, Ethereum, BSC, Arbitrum, Optimism and Polygon it also runs a live simulated buy -> sell round trip from a fresh wallet to measure the real taxes and confirm the token can actually be sold.","tags":["Onchain DeFi & Crypto Oracle"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tokenAddress"],"properties":{"tokenAddress":{"type":"string","minLength":32,"description":"0x-prefixed EVM token contract address or Base58 Solana mint address"},"chain":{"type":"string","enum":["base","ethereum","arbitrum","optimism","polygon","bsc","avalanche","solana"],"description":"Target blockchain (defaults to 'base' for 0x addresses or 'solana' for Base58)"},"intendedOrderUsd":{"type":"number","minimum":10,"description":"Intended swap size in USD to estimate AMM pool price impact (default 1000)"}}}}}},"responses":{"200":{"description":"0-100 Token safety scorecard, bytecode risk flags, and live DEX liquidity sizing","content":{"application/json":{"schema":{"type":"object","required":["chain","tokenAddress","tokenSymbol","safetyScore","verdict","riskFlags","contractSecurity","dexMicrostructure"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"string"},"tokenAddress":{"type":"string"},"tokenSymbol":{"type":"string"},"tokenName":{"type":"string"},"safetyScore":{"type":"integer","minimum":0,"maximum":100},"verdict":{"type":"string","enum":["SAFE_TO_TRADE","CAUTION_ELEVATED_RISK","HIGH_RISK_ILLIQUID_OR_CENTRALIZED","DO_NOT_TRADE_CRITICAL_RISK"]},"riskFlags":{"type":"array","items":{"type":"string"}},"contractSecurity":{"type":"object"},"dexMicrostructure":{"type":"object"},"swapSimulation":{"type":"object","description":"Live simulated buy -> sell round trip from a fresh wallet on the token's main V2-style wrapped-native pool (EVM chains except Avalanche). Measured taxes and a blocked sell tighten the verdict; any other non-PASSED status is inconclusive.","properties":{"status":{"type":"string","enum":["PASSED","SELL_BLOCKED","BUY_RECEIVED_ZERO","BUY_REVERTED","SELL_APPROVE_REVERTED","SELL_SWAP_REVERTED","SELL_UNMEASURED","NO_SUPPORTED_POOL","UNSUPPORTED_CHAIN","RPC_ERROR"]},"buyTaxPercent":{"type":["number","null"]},"sellTaxPercent":{"type":["number","null"]},"estimatedRoundTripLossPercent":{"type":["number","null"]}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/web/outreach-dossier":{"post":{"operationId":"generateOutreachDossier","summary":"All-in-One B2B Sales Lead, Tech-Gap Audit & Ready-to-Send WhatsApp/Email Outreach Dossier","description":"Single-call composite B2B SDR intelligence endpoint: runs Brand Sanitizer, Phantom Lead Shield, normalized E.164 WhatsApp/mobile & email extraction, CMS/pixel stack detection, 0-100 Technical SEO revenue-leak audit, and generates personalized, non-spammy WhatsApp & Cold Email scripts referencing the target's exact technical gaps.","tags":["Web & Lead Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Target business website, social bio, or marketplace URL"},"businessName":{"type":"string","description":"Optional raw business title to sanitize"},"agencyOffer":{"type":"string","description":"Optional description of your product/agency offer to weave into the generated outreach scripts"}}}}}},"responses":{"200":{"description":"Complete B2B lead enrichment, revenue-leak audit, and personalized outreach scripts","content":{"application/json":{"schema":{"type":"object","required":["sanitizedBrandName","leadTier","seoScore","contacts","detectedRevenueLeaks","outreachScripts"],"properties":{"ok":{"type":"boolean"},"sanitizedBrandName":{"type":"string"},"leadTier":{"type":"string"},"seoScore":{"type":"integer"},"contacts":{"type":"object"},"techStackSignals":{"type":"array","items":{"type":"string"}},"detectedRevenueLeaks":{"type":"array","items":{"type":"string"}},"outreachScripts":{"type":"object","properties":{"whatsappFirstTouch":{"type":"string"},"coldEmailSubject":{"type":"string"},"coldEmailBody":{"type":"string"}}}}}}}},"402":{"description":"Payment Required"}}}},"/v1/chain/balance":{"get":{"operationId":"getNativeBalance","summary":"Native coin balance (ETH, BNB, POL, AVAX) of any address on 7 EVM chains","description":"Native coin balance of any address on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC or Avalanche, with raw wei and formatted units plus the block it was read at. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted.","schema":{"type":"string","example":"base"}},{"name":"address","in":"query","required":true,"description":"0x-prefixed wallet or contract address.","schema":{"type":"string","example":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072"}}],"responses":{"200":{"description":"Native coin balance (ETH, BNB, POL, AVAX) of any address on 7 EVM chains","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"chainId":{"type":"integer"},"address":{"type":"string"},"blockNumber":{"type":"integer"},"balance":{"type":"object"}}},"example":{"chain":"base","chainId":8453,"address":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072","blockNumber":38211554,"balance":{"symbol":"ETH","decimals":18,"raw":"1250000000000000","formatted":"0.00125"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/token-balance":{"get":{"operationId":"getTokenBalance","summary":"ERC-20 balance of an address, already scaled by the token's decimals","description":"ERC-20 token balance of any address on 7 EVM chains, returned raw and decimal-formatted with the token symbol, so agents never mis-scale USDC (6) vs 18-decimal tokens. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted.","schema":{"type":"string","example":"base"}},{"name":"address","in":"query","required":true,"description":"0x-prefixed wallet or contract address.","schema":{"type":"string","example":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072"}},{"name":"token","in":"query","required":true,"description":"0x-prefixed ERC-20 token contract address.","schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}],"responses":{"200":{"description":"ERC-20 balance of an address, already scaled by the token's decimals","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"chainId":{"type":"integer"},"address":{"type":"string"},"token":{"type":"string"},"blockNumber":{"type":"integer"},"balance":{"type":"object"}}},"example":{"chain":"base","chainId":8453,"address":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","blockNumber":38211554,"balance":{"symbol":"USDC","decimals":6,"raw":"4250000","formatted":"4.25"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/token-info":{"get":{"operationId":"getTokenInfo","summary":"ERC-20 name, symbol, decimals and total supply","description":"ERC-20 token metadata on 7 EVM chains: name, symbol, decimals and formatted total supply in one call. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted.","schema":{"type":"string","example":"base"}},{"name":"token","in":"query","required":true,"description":"0x-prefixed ERC-20 token contract address.","schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}],"responses":{"200":{"description":"ERC-20 name, symbol, decimals and total supply","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"chainId":{"type":"integer"},"token":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"totalSupply":{"type":"object"}}},"example":{"chain":"base","chainId":8453,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","symbol":"USDC","decimals":6,"totalSupply":{"symbol":"USDC","decimals":6,"raw":"4170000000000000","formatted":"4170000000"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/tx":{"get":{"operationId":"getTransactionStatus","summary":"Transaction status, confirmations, value and total fee (incl. L2 L1-data fee)","description":"Status of any transaction on 7 EVM chains: pending / success / reverted, confirmations, block time, from/to, value and the all-in fee (including the OP-stack L1 data fee on Base and Optimism). Use it to confirm a payment or deployment landed. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted.","schema":{"type":"string","example":"base"}},{"name":"hash","in":"query","required":true,"description":"0x-prefixed 32-byte transaction hash.","schema":{"type":"string","example":"0x4f9955a6481d1386b261c3a9e68bc385df78d40190fe8cef895942283e33d985"}}],"responses":{"200":{"description":"Transaction status, confirmations, value and total fee (incl. L2 L1-data fee)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"chainId":{"type":"integer"},"hash":{"type":"string"},"status":{"type":"string"},"blockNumber":{"type":"integer"},"timestampUtc":{"type":"string"},"confirmations":{"type":"integer"},"from":{"type":"string"},"to":{"type":"string"},"value":{"type":"object"},"fee":{"type":"object"}}},"example":{"chain":"base","chainId":8453,"hash":"0x4f9955a6481d1386b261c3a9e68bc385df78d40190fe8cef895942283e33d985","status":"success","blockNumber":30000000,"timestampUtc":"2025-05-09T11:15:47.000Z","confirmations":23303683,"from":"0xc1a86592ec35568a99046378e2d849b03acc74d6","to":"0xcb1838c233d5dc4cc1942312c066474d1186790d","value":{"symbol":"ETH","decimals":18,"raw":"5000000000000000","formatted":"0.005"},"fee":{"symbol":"ETH","decimals":18,"raw":"21064060127140","formatted":"0.00002106406012714"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/address-info":{"get":{"operationId":"getAddressInfo","summary":"EOA vs contract, EIP-7702 delegation, proxy implementation, nonce and balance","description":"Classify any address on 7 EVM chains before interacting with it: EOA, EIP-7702-delegated EOA or contract, code size, nonce, native balance, and proxy detection (EIP-1967 implementation/admin/beacon slots, legacy ZeppelinOS proxies such as USDC, and EIP-1167 minimal proxies). You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted.","schema":{"type":"string","example":"base"}},{"name":"address","in":"query","required":true,"description":"0x-prefixed wallet or contract address.","schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}],"responses":{"200":{"description":"EOA vs contract, EIP-7702 delegation, proxy implementation, nonce and balance","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"chainId":{"type":"integer"},"address":{"type":"string"},"type":{"type":"string"},"codeSizeBytes":{"type":"integer"},"nonce":{"type":"integer"},"delegatedTo":{"type":"string"},"proxy":{"type":"object"}}},"example":{"chain":"base","chainId":8453,"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","type":"CONTRACT","codeSizeBytes":1852,"nonce":1,"delegatedTo":null,"proxy":{"standard":"ZEPPELINOS","implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779","admin":"0x4fc7850364958d97B4d3f5A08f79db2493f8cA44","beacon":null}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/ens":{"get":{"operationId":"resolveEns","summary":"ENS forward (name -> address) or reverse (address -> primary name) resolution","description":"Resolve an ENS name to an address, or an address to its primary ENS name, via the Ethereum mainnet Universal Resolver (CCIP-read / offchain names supported). Pass exactly one of 'name' or 'address'. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"name","in":"query","required":false,"description":"ENS name to resolve, e.g. vitalik.eth.","schema":{"type":"string","example":"vitalik.eth"}},{"name":"address","in":"query","required":false,"description":"Address to reverse-resolve to its primary ENS name.","schema":{"type":"string","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}],"responses":{"200":{"description":"ENS forward (name -> address) or reverse (address -> primary name) resolution","content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"}}},"example":{"direction":"forward","name":"vitalik.eth","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/chain/portfolio":{"get":{"operationId":"getMultichainPortfolio","summary":"One-call multichain portfolio: native + USDC/USDT balances on 7 EVM chains","description":"One call returns an address's native coin, USDC and USDT balances on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC and Avalanche (or a 'chains' subset), plus a total stablecoin USD figure, instead of 21 separate reads. Chains whose RPC fails are listed in chainsFailed. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Onchain Read API"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"query","required":true,"description":"0x-prefixed wallet or contract address.","schema":{"type":"string","example":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072"}},{"name":"chains","in":"query","required":false,"description":"Optional comma-separated subset, e.g. base,arbitrum. Defaults to all 7 chains.","schema":{"type":"string","example":"base,ethereum,arbitrum"}}],"responses":{"200":{"description":"One-call multichain portfolio: native + USDC/USDT balances on 7 EVM chains","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chainsQueried":{"type":"array"},"chainsFailed":{"type":"array"},"totals":{"type":"object"},"balances":{"type":"array"}}},"example":{"address":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072","chainsQueried":["base","ethereum","arbitrum"],"chainsFailed":[],"totals":{"stablecoinUsd":12.5},"balances":[{"chain":"base","chainId":8453,"native":{"symbol":"ETH","decimals":18,"raw":"1250000000000000","formatted":"0.00125"},"stablecoins":[{"symbol":"USDC","decimals":6,"raw":"12500000","formatted":"12.5","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/company/search":{"get":{"operationId":"searchCompanies","summary":"Find a US public company's ticker and SEC CIK by name or ticker","description":"Search ~10,000 SEC-registered US public companies by ticker or name and get the ticker, legal name and CIK to use with the other company tools. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Company Data API (SEC EDGAR)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"description":"Ticker or company name fragment, e.g. nvidia.","schema":{"type":"string","example":"apple"}},{"name":"limit","in":"query","required":false,"description":"Max results, 1-25 (default 10).","schema":{"type":"string","example":"5"}}],"responses":{"200":{"description":"Find a US public company's ticker and SEC CIK by name or ticker","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array"}}},"example":{"query":"apple","count":2,"results":[{"ticker":"AAPL","name":"Apple Inc.","cik":320193,"exchange":"Nasdaq"},{"ticker":"APLE","name":"Apple Hospitality REIT, Inc.","cik":1418121,"exchange":"NYSE"}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/company/profile":{"get":{"operationId":"getCompanyProfile","summary":"Company profile: industry, exchanges, fiscal year end, address and latest 10-K/10-Q/8-K links","description":"Official SEC profile of a US public company: legal name, tickers, exchanges, SIC industry, state of incorporation, fiscal year end, website, business address, former names, and direct links to its latest annual, quarterly and current reports. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Company Data API (SEC EDGAR)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"ticker","in":"query","required":false,"description":"US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik.","schema":{"type":"string","example":"AAPL"}},{"name":"cik","in":"query","required":false,"description":"SEC Central Index Key, e.g. 320193 (alternative to ticker).","schema":{"type":"string","example":"320193"}}],"responses":{"200":{"description":"Company profile: industry, exchanges, fiscal year end, address and latest 10-K/10-Q/8-K links","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object"},"tickers":{"type":"array"},"exchanges":{"type":"array"},"industry":{"type":"string"},"fiscalYearEnd":{"type":"string"},"latestFilings":{"type":"object"}}},"example":{"company":{"cik":320193,"ticker":"AAPL","name":"Apple Inc."},"tickers":["AAPL"],"exchanges":["Nasdaq"],"industry":"Electronic Computers","fiscalYearEnd":"09-26","latestFilings":{"annualReport":{"form":"10-K","filingDate":"2025-10-31","documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"}}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/company/financials":{"get":{"operationId":"getCompanyFinancials","summary":"Annual or quarterly fundamentals: revenue, net income, EPS, cash flow, FCF, margins, YoY growth","description":"Reported fundamentals for US-GAAP filers from SEC XBRL data: revenue, operating income, net income, diluted EPS, operating cash flow, capex, free cash flow, total assets/liabilities, equity, cash, margins and YoY revenue growth for the last 1-12 annual or quarterly periods. Q4 and quarterly cash flows are derived from year-to-date filings and flagged. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Company Data API (SEC EDGAR)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"ticker","in":"query","required":false,"description":"US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik.","schema":{"type":"string","example":"AAPL"}},{"name":"cik","in":"query","required":false,"description":"SEC Central Index Key, e.g. 320193 (alternative to ticker).","schema":{"type":"string","example":"320193"}},{"name":"period","in":"query","required":false,"description":"annual (default) or quarterly.","schema":{"type":"string","example":"annual"}},{"name":"limit","in":"query","required":false,"description":"Number of periods, 1-12 (default 4).","schema":{"type":"string","example":"3"}}],"responses":{"200":{"description":"Annual or quarterly fundamentals: revenue, net income, EPS, cash flow, FCF, margins, YoY growth","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object"},"period":{"type":"string"},"currency":{"type":"string"},"periods":{"type":"array"}}},"example":{"company":{"cik":320193,"ticker":"AAPL","name":"Apple Inc."},"period":"annual","currency":"USD","periods":[{"periodEnd":"2025-09-27","fiscalYear":2025,"revenue":416161000000,"netIncome":112010000000,"epsDiluted":7.46,"freeCashFlow":98767000000,"netMarginPercent":26.92,"revenueGrowthYoYPercent":6.43}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/company/filings":{"get":{"operationId":"getCompanyFilings","summary":"Latest SEC filings (10-K, 10-Q, 8-K, S-1, ...) with direct document links","description":"A company's most recent SEC filings, optionally filtered by form type (e.g. 10-K,8-K) and date, with filing/report dates, 8-K item numbers and direct links to the document and filing index. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Company Data API (SEC EDGAR)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"ticker","in":"query","required":false,"description":"US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik.","schema":{"type":"string","example":"AAPL"}},{"name":"cik","in":"query","required":false,"description":"SEC Central Index Key, e.g. 320193 (alternative to ticker).","schema":{"type":"string","example":"320193"}},{"name":"form","in":"query","required":false,"description":"Comma-separated form types, e.g. 10-K,10-Q,8-K.","schema":{"type":"string","example":"8-K"}},{"name":"since","in":"query","required":false,"description":"Only filings on/after this date (YYYY-MM-DD).","schema":{"type":"string","example":"2026-01-01"}},{"name":"limit","in":"query","required":false,"description":"Max filings, 1-50 (default 10).","schema":{"type":"string","example":"5"}}],"responses":{"200":{"description":"Latest SEC filings (10-K, 10-Q, 8-K, S-1, ...) with direct document links","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object"},"count":{"type":"integer"},"filings":{"type":"array"}}},"example":{"company":{"cik":320193,"ticker":"AAPL","name":"Apple Inc."},"count":1,"filings":[{"form":"8-K","filingDate":"2026-07-30","items":"2.02,9.01","documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/..."}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/company/insider-trades":{"get":{"operationId":"getInsiderTrades","summary":"Recent Form 4 insider trades: who bought/sold, shares, price, value and 10b5-1 flag","description":"Parsed SEC Form 4 insider filings for a company: insider name and role (director, officer title, 10% owner), transaction code (open-market buy/sell, award, exercise, tax withholding...), shares, price, USD value, holdings after, 10b5-1 plan flag, plus a buy/sell summary. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Company Data API (SEC EDGAR)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"parameters":[{"name":"ticker","in":"query","required":false,"description":"US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik.","schema":{"type":"string","example":"AAPL"}},{"name":"cik","in":"query","required":false,"description":"SEC Central Index Key, e.g. 320193 (alternative to ticker).","schema":{"type":"string","example":"320193"}},{"name":"limit","in":"query","required":false,"description":"Number of recent Form 4 filings, 1-20 (default 10).","schema":{"type":"string","example":"5"}}],"responses":{"200":{"description":"Recent Form 4 insider trades: who bought/sold, shares, price, value and 10b5-1 flag","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object"},"count":{"type":"integer"},"summary":{"type":"object"},"filings":{"type":"array"}}},"example":{"company":{"cik":320193,"ticker":"AAPL","name":"Apple Inc."},"count":1,"summary":{"openMarketPurchases":0,"openMarketSales":1,"sharesSold":2399,"valueSoldUsd":823720.64},"filings":[{"filingDate":"2026-10-29","owners":[{"name":"Newstead Jennifer","isOfficer":true,"officerTitle":"SVP, GC and Government Affairs"}],"rule10b5_1":true,"transactions":[{"date":"2026-10-27","code":"S","shares":2399,"pricePerShare":343.36,"acquiredOrDisposed":"D"}]}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/entity/search":{"get":{"operationId":"searchEntities","summary":"Find companies or notable people by name, with Wikidata IDs to disambiguate","description":"Search Wikidata for companies, notable people or anything else by name and get IDs, short descriptions and Wikipedia links, so you can pick the right entity before enriching it. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Entity Enrichment API (Wikidata)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"description":"Name to search, e.g. grab.","schema":{"type":"string","example":"grab"}},{"name":"type","in":"query","required":false,"description":"company, person or any (default any).","schema":{"type":"string","example":"company"}},{"name":"limit","in":"query","required":false,"description":"Max results, 1-20 (default 5).","schema":{"type":"string","example":"3"}}],"responses":{"200":{"description":"Find companies or notable people by name, with Wikidata IDs to disambiguate","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"type":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array"}}},"example":{"query":"grab","type":"company","count":1,"results":[{"id":"Q20873932","label":"Grab","description":"Southeast Asian technology company headquartered in Singapore","wikipediaUrl":"https://en.wikipedia.org/wiki/Grab_Holdings"}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/entity/company":{"get":{"operationId":"getCompanyEntity","summary":"Company enrichment by name or domain: HQ, industry, CEO, founders, headcount, listings, LEI, socials","description":"Enrich any company worldwide (private, startup or listed; not just US) by name, website domain or Wikidata ID: website, founding date, headquarters, countries, industries, current CEO, founders, employee count, revenue, stock listings and tickers, LEI/ISIN, legal form, parent and subsidiaries, official X/LinkedIn/GitHub/Instagram accounts, logo and the Wikipedia summary. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Entity Enrichment API (Wikidata)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"parameters":[{"name":"name","in":"query","required":false,"description":"Company name, e.g. Stripe.","schema":{"type":"string","example":"Stripe"}},{"name":"domain","in":"query","required":false,"description":"Company website or domain, e.g. stripe.com (matched to its official website).","schema":{"type":"string","example":"stripe.com"}},{"name":"id","in":"query","required":false,"description":"Wikidata item ID, e.g. Q7624104 (skips name matching).","schema":{"type":"string","example":"Q7624104"}}],"responses":{"200":{"description":"Company enrichment by name or domain: HQ, industry, CEO, founders, headcount, listings, LEI, socials","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"website":{"type":"string"},"founded":{"type":"string"},"headquarters":{"type":"array"},"industries":{"type":"array"},"ceo":{"type":"array"},"employees":{"type":"object"},"identifiers":{"type":"object"},"social":{"type":"object"}}},"example":{"id":"Q7624104","name":"Stripe","website":"https://stripe.com/","founded":"2010","headquarters":[{"id":"Q62","name":"San Francisco"}],"industries":[{"id":"Q837171","name":"financial services"}],"ceo":[{"id":"Q7146257","name":"Patrick Collison"}],"employees":{"count":8000,"asOf":"2022"},"identifiers":{"lei":"549300CLHGIPTCYHQ143","isin":null},"social":{"x":"https://x.com/stripe","linkedin":"https://www.linkedin.com/company/stripe"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}},"/v1/entity/person":{"get":{"operationId":"getPersonEntity","summary":"Notable-person profile: occupations, current employer and roles, education, public social accounts","description":"Professional profile of a notable person (founders, executives, public figures) from Wikidata and Wikipedia: description, occupations, current employers and positions, education, citizenship, birth year, website and public X/LinkedIn/GitHub accounts. No family, residence or full birth dates are returned. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","tags":["Entity Enrichment API (Wikidata)"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"parameters":[{"name":"name","in":"query","required":false,"description":"Person's name, e.g. Jensen Huang.","schema":{"type":"string","example":"Jensen Huang"}},{"name":"id","in":"query","required":false,"description":"Wikidata item ID, e.g. Q305177 (skips name matching).","schema":{"type":"string","example":"Q305177"}}],"responses":{"200":{"description":"Notable-person profile: occupations, current employer and roles, education, public social accounts","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"birthYear":{"type":"integer"},"occupations":{"type":"array"},"education":{"type":"array"},"social":{"type":"object"}}},"example":{"id":"Q305177","name":"Jensen Huang","description":"American entrepreneur and businessman; co-founder and CEO of Nvidia","birthYear":1963,"occupations":[{"id":"Q131524","name":"entrepreneur"}],"education":[{"id":"Q41506","name":"Stanford University"}],"social":{"x":"https://x.com/JensenHuang","linkedin":"https://www.linkedin.com/in/jenhsunhuang"}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"Not found (not charged)"},"503":{"description":"Upstream data source temporarily unavailable (not charged)"}}}}}}