{"openapi":"3.1.0","info":{"title":"GlobalAPI x402","version":"2.3.5","summary":"Pay-per-call API for global economic data, company registries, and sanctions screening","description":"Pay-per-call API for global economic data, company registry lookups, and sanctions screening. Economics endpoints include AI commentary on trend direction, surprise vs expectation, and macro regime. Registries: Norway (Brreg), Singapore (ACRA), Canada (ISED), Ireland (CRO), France (Sirene), Denmark (CVR). Sanctions: OFAC SDN, UK FCDO/OFSI, UN Security Council, EU Consolidated — refreshed daily from primary publishers. Pay per call in USDC on Base mainnet via the x402 protocol — no API key required, no subscription.\n\nAll paid endpoints respond with HTTP 402 (Payment Required) when called without a valid x402 payment header. The 402 response includes a `payment-required` header containing base64-encoded payment instructions per the x402 spec.\n\nPrimary use cases: pre-trade OFAC wallet screening, DeFi counterparty compliance, macro-event trading signals, KYB company verification.\n\nSee https://x402.org for the protocol specification.","contact":{"name":"GlobalAPI x402","url":"https://globalapi.dev"},"license":{"name":"Proprietary","url":"https://globalapi.dev/terms"}},"servers":[{"url":"https://globalapi.dev","description":"Production"}],"tags":[{"name":"sanctions","description":"Sanctions screening — OFAC SDN, UK FCDO/OFSI, UN SC, EU Consolidated"},{"name":"compliance","description":"Unified DeFi compliance / counterparty risk"},{"name":"economics-us","description":"US macroeconomic indicators (FRED + BLS)"},{"name":"economics-uk","description":"UK macroeconomic indicators (ONS)"},{"name":"economics-eu","description":"EU macroeconomic indicators (Eurostat)"},{"name":"economics-ca","description":"Canada macroeconomic indicators (Statistics Canada)"},{"name":"economics-jp","description":"Japan macroeconomic indicators (e-Stat)"},{"name":"economics-world","description":"Multi-country macroeconomic indicators (World Bank, IMF, OECD)"},{"name":"registry-eu","description":"European company registries (Norway, Ireland, France, Denmark)"},{"name":"registry-asia","description":"Asian company registries (Singapore ACRA)"},{"name":"registry-na","description":"North American company registries (Canada ISED)"},{"name":"discovery","description":"Free discovery and metadata endpoints"}],"x-x402":{"version":2,"asset":"USDC","network":"base","chainId":"eip155:8453","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","wellKnown":["/.well-known/x402","/.well-known/agent.json","/.well-known/mcp.json"]},"paths":{"/sanctions/wallet/{address}":{"get":{"tags":["sanctions"],"summary":"OFAC crypto wallet sanctions screening","description":"Check any blockchain address (EVM, BTC, Solana, TRX, XRP, etc.) against the OFAC Specially Designated Nationals (SDN) digital currency list. Sub-200ms response; no API key required. Used by DeFi trading agents, bridge protocols, and on-chain lending platforms to screen counterparty wallets before settling a trade or accepting a payment. Returns a clear/match verdict with matched SDN entry details and AI commentary when a hit is found.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Blockchain wallet address — EVM (0x + 40 hex), BTC legacy/P2SH, BTC bech32 (bc1...), Solana base58, TRX, XRP, etc.","example":"0x098b716b8aaf21512996dc57eb0615e2383e2f96"}],"responses":{"200":{"description":"Screening result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletScreeningResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/ServerError"}},"x-pricing":{"amount":"0.002","asset":"USDC","network":"base"}}},"/compliance/counterparty/{address}":{"get":{"tags":["compliance"],"summary":"Unified DeFi counterparty risk check","description":"Bundles OFAC SDN + UK FCDO/OFSI + UN Security Council sanctions screening, on-chain wallet age (first_seen date, age_days from Ethereum mainnet), label hits (mixer, exploit, CEX, bridge, protocol), and outbound transaction count into one call with a PASS / WARN / BLOCK verdict. EVM addresses only (v1). Returns per-signal verdict_reasons so the calling agent can log the exact compliance rationale. For DeFi protocols, on-chain lending agents, treasury managers, and bridge operators that need a full counterparty picture before settling.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"description":"EVM wallet address (0x + 40 hex chars). BTC and Solana planned for a future version.","example":"0xe592427a0aece92de3edee1f18e0157c05861564"}],"responses":{"200":{"description":"Counterparty verdict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterpartyResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/ServerError"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/sanctions/check/{name}":{"get":{"tags":["sanctions"],"summary":"Sanctions name search across OFAC, UK, UN, EU lists","description":"Fuzzy-match an entity or individual name against OFAC SDN, UK FCDO/OFSI, UN Security Council, and EU Consolidated sanctions lists — sourced directly from primary publishers and refreshed daily. Handles transliterations, aliases, and partial names. Returns all hits with source list attribution, entity type, sanction programs, and citation URLs. Sub-200ms. For compliance agents that need raw hit data before applying their own disambiguation logic.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"description":"Entity or individual name to screen. Fuzzy matching handles transliterations and aliases.","example":"Gazprom"}],"responses":{"200":{"description":"Sanctions matches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SanctionsResult"}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/ServerError"}},"x-pricing":{"amount":"0.050","asset":"USDC","network":"base"}}},"/sanctions/check":{"get":{"tags":["sanctions"],"summary":"AI-verified sanctions entity check with PASS / WARN / BLOCK verdict","description":"AI-disambiguated sanctions check — resolves common-name collisions by entity type and country context to produce a definitive PASS / WARN / BLOCK verdict across OFAC SDN, UK FCDO/OFSI, UN SC, and EU Consolidated. Use this endpoint when a name alone is ambiguous (e.g. \"Kim Jong\" or \"Russia Bank\"). Pass name + optional type (individual / entity / vessel / aircraft) + optional ISO-3 country code as query params.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"description":"Entity or individual name to screen against all four sanctions lists.","example":"Gazprom"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["individual","entity","vessel","aircraft"]},"description":"Entity type — narrows AI disambiguation. Omit when unknown."},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"ISO-3 country code — further narrows disambiguation for common names. Example: RUS, PRK, IRN.","example":"RUS"}],"responses":{"200":{"description":"AI-verified verdict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SanctionsVerdict"}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/ServerError"}},"x-pricing":{"amount":"0.100","asset":"USDC","network":"base"}}},"/us/cpi":{"get":{"tags":["economics-us"],"summary":"US CPI inflation","description":"US Consumer Price Index (CPI) from FRED (CPIAUCSL series) with AI commentary on trend direction and surprise vs prior expectation. Returns latest month-over-month and year-over-year figures plus a 24-month history. For macro trading agents running CPI-print event strategies.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/unemployment":{"get":{"tags":["economics-us"],"summary":"US unemployment rate","description":"US unemployment rate from FRED (UNRATE series) with AI commentary on labour market regime and Fed policy implications. Monthly cadence; primary signal for agents modelling risk-asset bias and Fed rate trajectory.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/gdp":{"get":{"tags":["economics-us"],"summary":"US GDP","description":"US real GDP growth from FRED (A191RL1Q225SBEA) with AI commentary on expansion, slowdown, or recession regime. Quarterly cadence; latest available BEA advance estimate.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/fed-rate":{"get":{"tags":["economics-us"],"summary":"US federal funds rate","description":"Federal funds effective rate from FRED (EFFR series) with AI commentary on policy stance and rate trajectory. Used by fixed-income agents and rate-sensitive strategy models.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/economics":{"get":{"tags":["economics-us"],"summary":"US macro snapshot (digest)","description":"Combined US macro snapshot — CPI, unemployment, GDP, and federal funds rate from FRED in one call, with AI commentary on the overall economic regime (expansion / slowdown / recession). For agents that need a single risk-on/risk-off signal without separate indicator calls.","responses":{"200":{"$ref":"#/components/responses/EconDigest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/us/jobs":{"get":{"tags":["economics-us"],"summary":"US nonfarm payrolls","description":"US nonfarm payrolls from BLS (CES0000000001 series) with AI commentary on jobs-market strength and Fed policy implications. Monthly BLS Employment Situation release; primary signal for rate expectations.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/wages":{"get":{"tags":["economics-us"],"summary":"US average hourly earnings","description":"US average hourly earnings from BLS (CES0500000003 series) with AI commentary on wage inflation trajectory. Used by inflation-watching agents and labour cost monitors.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/us/labor":{"get":{"tags":["economics-us"],"summary":"US labour market digest","description":"Combined US labour market digest — nonfarm payrolls and average hourly earnings from BLS in one call with AI commentary on the full jobs-market picture. For agents that track both employment volume and wage inflation together.","responses":{"200":{"$ref":"#/components/responses/EconDigest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/uk/cpi":{"get":{"tags":["economics-uk"],"summary":"UK CPI inflation","description":"UK CPI from the Office for National Statistics (ONS) with AI commentary on trend direction and Bank of England rate implications. Updated monthly.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/uk/unemployment":{"get":{"tags":["economics-uk"],"summary":"UK unemployment rate","description":"UK unemployment rate from ONS with AI commentary on labour market tightness and BoE rate trajectory. Monthly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/uk/gdp":{"get":{"tags":["economics-uk"],"summary":"UK GDP","description":"UK real GDP from ONS with AI commentary on expansion or contraction signals. Quarterly cadence; latest available ONS estimate.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/uk/economics":{"get":{"tags":["economics-uk"],"summary":"UK macro snapshot (digest)","description":"Combined UK macro snapshot — CPI, unemployment, and GDP from ONS in one call with AI commentary on BoE rate trajectory and economic regime.","responses":{"200":{"$ref":"#/components/responses/EconDigest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/eu/inflation":{"get":{"tags":["economics-eu"],"summary":"EU HICP inflation","description":"EU harmonised HICP inflation from Eurostat with AI commentary on ECB rate implications. Covers the euro area aggregate. Monthly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/eu/unemployment":{"get":{"tags":["economics-eu"],"summary":"EU unemployment rate","description":"EU unemployment rate from Eurostat with AI commentary on the labour market across the euro area and ECB policy stance. Monthly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/eu/gdp":{"get":{"tags":["economics-eu"],"summary":"EU GDP growth","description":"EU real GDP growth from Eurostat with AI commentary on expansion or contraction signals for the euro area. Quarterly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/eu/economics":{"get":{"tags":["economics-eu"],"summary":"EU macro snapshot (digest)","description":"Combined EU macro snapshot — HICP inflation, unemployment, and GDP from Eurostat in one call with AI commentary on ECB policy stance and euro area economic regime.","responses":{"200":{"$ref":"#/components/responses/EconDigest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/ca/cpi":{"get":{"tags":["economics-ca"],"summary":"Canada CPI","description":"Canada CPI from Statistics Canada with AI commentary on trend and Bank of Canada rate implications. Monthly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/ca/unemployment":{"get":{"tags":["economics-ca"],"summary":"Canada unemployment rate","description":"Canada unemployment from Statistics Canada with AI commentary on labour market conditions and BoC policy outlook.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/ca/gdp":{"get":{"tags":["economics-ca"],"summary":"Canada GDP","description":"Canada GDP from Statistics Canada with AI commentary on growth trajectory and recession signal. Quarterly cadence.","responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/ca/economics":{"get":{"tags":["economics-ca"],"summary":"Canada macro snapshot (digest)","description":"Combined Canada macro snapshot — CPI, unemployment, and GDP from Statistics Canada in one call with AI commentary on BoC rate trajectory and economic regime.","responses":{"200":{"$ref":"#/components/responses/EconDigest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/world/gdp/{country}":{"get":{"tags":["economics-world"],"summary":"Multi-country GDP (World Bank)","description":"Real GDP for any country from the World Bank (NY.GDP.MKTP.KD.ZG). Pass ISO-2 or ISO-3 country code in the path. Annual cadence; covers 190+ countries.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"ISO-2 or ISO-3 country code, e.g. US, GBR, AUS","example":"USA"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/world/inflation/{country}":{"get":{"tags":["economics-world"],"summary":"Multi-country inflation (World Bank)","description":"Consumer price inflation for any country from the World Bank (FP.CPI.TOTL.ZG). Pass ISO-2 or ISO-3 country code in the path. Annual cadence; 190+ countries.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"ISO-2 or ISO-3 country code, e.g. US, GBR, AUS","example":"GBR"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/world/population/{country}":{"get":{"tags":["economics-world"],"summary":"Multi-country population (World Bank)","description":"Population for any country from the World Bank (SP.POP.TOTL). Pass ISO-2 or ISO-3 country code in the path. Annual cadence; 190+ countries.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"ISO-2 or ISO-3 country code, e.g. US, GBR, AUS","example":"AUS"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/imf/gdp/{country}":{"get":{"tags":["economics-world"],"summary":"IMF WEO real GDP growth","description":"IMF World Economic Outlook (WEO) real GDP growth for any country — pass 3-letter IMF country code in the path. Annual WEO forecast and latest estimate. Published April + October; covers 190+ countries.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"3-letter IMF country code, e.g. USA, GBR, DEU, JPN, AUS","example":"USA"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/imf/inflation/{country}":{"get":{"tags":["economics-world"],"summary":"IMF WEO CPI inflation","description":"IMF WEO CPI inflation for any country — 3-letter IMF country code in path. Annual cadence; includes IMF forecast alongside latest actuals.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"3-letter IMF country code","example":"DEU"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/imf/current-account/{country}":{"get":{"tags":["economics-world"],"summary":"IMF WEO current account balance","description":"IMF WEO current account balance (% of GDP) for any country — 3-letter IMF code in path. Used by EM debt agents and current-account watch models. Annual cadence.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"},"description":"3-letter IMF country code","example":"AUS"}],"responses":{"200":{"$ref":"#/components/responses/EconIndicator"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/no/company/{orgnr}":{"get":{"tags":["registry-eu"],"summary":"Norwegian company lookup (Brreg)","description":"Norwegian company lookup by 9-digit organisation number via the Brønnøysund Register Centre (Brreg). Returns name, status, NACE industry codes, registered address, and registration date. For KYB due-diligence agents verifying Norwegian counterparties.","parameters":[{"name":"orgnr","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{9}$"},"description":"9-digit Norwegian organisation number","example":"923609016"}],"responses":{"200":{"$ref":"#/components/responses/CompanyRecord"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/no/company/search/{name}":{"get":{"tags":["registry-eu"],"summary":"Norwegian company search (Brreg)","description":"Norwegian company name search via Brreg — fuzzy-matches against 1M+ registered entities and returns top hits with official organisation numbers. For KYB agents starting from a name and needing the canonical Brreg record.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"description":"Company name or partial name","example":"Equinor"}],"responses":{"200":{"$ref":"#/components/responses/CompanySearch"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.005","asset":"USDC","network":"base"}}},"/sg/company/{uen}":{"get":{"tags":["registry-asia"],"summary":"Singapore entity lookup (ACRA)","description":"Singapore entity lookup by UEN (Unique Entity Number) via ACRA / data.gov.sg. Returns name, status, primary SSIC activity, and registration details. Monthly dataset refresh.","parameters":[{"name":"uen","in":"path","required":true,"schema":{"type":"string"},"description":"Singapore UEN (Unique Entity Number)","example":"200104428C"}],"responses":{"200":{"$ref":"#/components/responses/CompanyRecord"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/sg/company/search/{name}":{"get":{"tags":["registry-asia"],"summary":"Singapore entity search (ACRA)","description":"Singapore entity name search via ACRA — returns top matching entities with UEN and registration status. Monthly dataset refresh. For KYB agents verifying Singapore-incorporated counterparties from a name.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"description":"Entity name or partial name","example":"Singapore Airlines"}],"responses":{"200":{"$ref":"#/components/responses/CompanySearch"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"x-pricing":{"amount":"0.010","asset":"USDC","network":"base"}}},"/.well-known/x402":{"get":{"tags":["discovery"],"summary":"x402 discovery document","description":"Service-level x402 metadata: name, description, payment config, and full resource list with per-endpoint prices and inputSchema.","responses":{"200":{"description":"x402 discovery document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/agent.json":{"get":{"tags":["discovery"],"summary":"Agent.json discovery document","description":"Google A2A-style agent card with capabilities, endpoints, and payment config. Consumed by agent orchestration frameworks.","responses":{"200":{"description":"Agent card","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp.json":{"get":{"tags":["discovery"],"summary":"MCP discovery document","description":"Model Context Protocol tool list for ChatGPT, Claude, Cursor, and other MCP clients. Each tool includes an x402 payment endpoint.","responses":{"200":{"description":"MCP discovery document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/health":{"get":{"tags":["discovery"],"summary":"Health check","description":"Service health check — version, network, wallet, and active endpoint list. Free, no payment required.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api-health":{"get":{"tags":["discovery"],"summary":"Upstream health","description":"Upstream API connectivity and data-freshness probe — FRED, BLS, ONS, Eurostat, World Bank, IMF, sanctions lists, CDP, Anthropic, Etherscan, SQLite. Free.","responses":{"200":{"description":"Upstream status","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"WalletScreeningResult":{"type":"object","description":"Response from the OFAC crypto wallet sanctions screening endpoint (/sanctions/wallet/:address).","properties":{"query":{"type":"string","description":"The blockchain address that was submitted for screening."},"result":{"type":"string","enum":["clear","match"],"description":"Screening verdict: \"clear\" = no match on the OFAC SDN digital currency list; \"match\" = one or more SDN entries hit for this address."},"matches":{"type":"array","items":{"type":"object"},"description":"Array of matched OFAC SDN entries. Empty array when result is \"clear\". Each entry includes SDN name, sanction programs, and list date."},"checked_lists":{"type":"array","items":{"type":"string"},"example":["OFAC SDN crypto"],"description":"Sanctions lists that were queried. Currently [\"OFAC SDN crypto\"] — the OFAC Specially Designated Nationals digital currency address index."},"commentary":{"type":"string","description":"AI-generated plain-language summary of the match — program affiliations, risk context, and recommended action. Present only when result is \"match\"."},"disclaimer":{"type":"string","description":"Compliance disclaimer. Screening result is one input into a compliance workflow; agent must apply its own compliance policy. Not legal advice."}}},"CounterpartyResult":{"type":"object","description":"Response from the unified DeFi counterparty risk endpoint (/compliance/counterparty/:address).","properties":{"address":{"type":"string","description":"The EVM wallet address that was checked (0x + 40 hex chars)."},"verdict":{"type":"string","enum":["PASS","WARN","BLOCK"],"description":"Risk verdict: PASS = no material risk signals detected; WARN = one or more risk factors present — review before transacting; BLOCK = OFAC sanctions hit or high-confidence risk signal — do not transact."},"verdict_reasons":{"type":"array","items":{"type":"string"},"description":"Human-readable list of the specific signals that produced the verdict. Empty array for PASS. Example values: \"OFAC SDN match\", \"wallet age < 7 days\", \"mixer label\"."},"sanctions":{"type":"object","description":"Aggregated sanctions result covering OFAC SDN, UK FCDO/OFSI, and UN Security Council screening for this address."},"wallet":{"type":"object","description":"On-chain wallet metadata from Ethereum mainnet — first_seen (ISO-8601 date), age_days (integer), outbound_tx_count (nonce). Null when all three fallback layers (Etherscan V2, Routescan, public RPC) timed out. Note: outbound_tx_count is the account nonce — outbound transactions only; receive-only wallets and smart contracts have low nonce even with high activity."},"labels":{"type":"array","items":{"type":"string"},"description":"Intel tags from the wallet-labels dataset. Values include: mixer, exploit, exchange_hot_wallet, exchange_cold_wallet, protocol, bridge, mev_bot. Empty array = no label found for this address."},"disclaimer":{"type":"string","description":"Compliance disclaimer. Counterparty check is one input into a compliance workflow; agent must apply its own policy. Not legal advice."}}},"SanctionsResult":{"type":"object","description":"Response from the sanctions name search endpoint (/sanctions/check/:name).","properties":{"query":{"type":"string","description":"The name or entity string that was submitted for name screening."},"result":{"type":"string","description":"Overall verdict: \"clear\" = no fuzzy-match hits across checked lists; \"match\" = one or more entities matched."},"matches":{"type":"array","items":{"type":"object"},"description":"Array of matched sanctions entries across all checked lists. Each hit includes: list name, entity type, sanction programs, and source citation URL."},"checked_lists":{"type":"array","items":{"type":"string"},"description":"Sanctions lists that were loaded and searched at query time. Includes all lists successfully loaded: OFAC SDN, UK FCDO/OFSI, UN SC, EU Consolidated (when available)."},"commentary":{"type":"string","description":"Plain-language summary of the hits — name disambiguation notes, program affiliations, and risk context."},"disclaimer":{"type":"string","description":"Compliance disclaimer. Name screening results are one input; final determination is the agent's responsibility. Not legal advice."}}},"SanctionsVerdict":{"type":"object","description":"Response from the AI-verified sanctions entity check endpoint (/sanctions/check with query params).","properties":{"query":{"type":"object","description":"The submitted query: name (required) plus optional entity type (individual / entity / vessel / aircraft) and optional ISO-3 country code for disambiguation."},"verdict":{"type":"string","enum":["PASS","WARN","BLOCK"],"description":"AI-disambiguated verdict: PASS = AI confirms no match after resolving name collisions; WARN = possible match requiring human review; BLOCK = high-confidence sanctions hit across one or more lists."},"matches":{"type":"array","items":{"type":"object"},"description":"Underlying fuzzy-match hits the AI verdict was derived from — same shape as SanctionsResult.matches."},"checked_lists":{"type":"array","items":{"type":"string"},"description":"Sanctions lists that were searched: OFAC SDN, UK FCDO/OFSI, UN Security Council, EU Consolidated (when available)."},"commentary":{"type":"string","description":"AI narrative explaining the verdict — why specific hits were confirmed, rejected as name collisions, or flagged for manual review."},"disclaimer":{"type":"string","description":"Compliance disclaimer. AI verdict is one input into a compliance workflow; final determination is the agent's responsibility. Not legal advice."}}},"EconIndicator":{"type":"object","description":"Single economic indicator response — returned by all /*/cpi, /*/gdp, /*/unemployment, /*/fed-rate, and /world/*, /imf/* endpoints.","properties":{"indicator":{"type":"string","description":"Name of the economic indicator as returned by the data source, e.g. \"Consumer Price Index\", \"Unemployment Rate\", \"Real GDP Growth Rate\"."},"source":{"type":"string","description":"Authoritative data source and series identifier, e.g. \"FRED CPIAUCSL\", \"ONS D7G7\", \"Eurostat prc_hicp_midx\". Data is fetched directly — no aggregator or reseller."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country or region code, e.g. \"US\", \"UK\", \"EU\"."},"latest":{"type":"object","description":"Most recent data point as { date: string, value: number, unit: string }. This is the headline number agents should use for macro decisions."},"series":{"type":"array","items":{"type":"object"},"description":"Historical time series ordered newest-first as an array of { date, value } objects. Typically 12–24 months for monthly indicators; 8–12 quarters for quarterly."},"commentary":{"type":"string","description":"AI-generated 2–4 sentence commentary on trend direction, surprise vs prior expectation, and macro regime implications (inflationary, recessionary, or neutral)."}}},"EconDigest":{"type":"object","description":"Combined economic digest response — returned by all /*/economics and /*/labor digest endpoints.","properties":{"source":{"type":"string","description":"Comma-separated list of authoritative data sources used for this digest, e.g. \"FRED, BLS\" for US or \"ONS\" for UK."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country or region code for this digest, e.g. \"US\", \"UK\", \"EU\"."},"indicators":{"type":"object","description":"Object containing each indicator keyed by short name (e.g. cpi, unemployment, gdp, fed_rate). Each value has the same shape as a single EconIndicator response."},"commentary":{"type":"string","description":"AI-generated commentary synthesising all indicators in this digest into a single macro regime narrative — expansion, slowdown, or recession."}}},"CompanyRecord":{"type":"object","description":"A single company record from a national business registry.","properties":{"id":{"type":"string","description":"Official company identifier from the source national registry. Format depends on country: 9-digit org number (Norway), UEN (Singapore), SIREN (France), 8-digit CVR (Denmark), 6-digit company number (Ireland), federal corp number (Canada)."},"name":{"type":"string","description":"Registered legal name of the company as it appears in the authoritative national business registry."},"status":{"type":"string","description":"Registration status normalised to English. Common values: \"Active\", \"Dissolved\", \"Inactive\". Source-specific values may appear for less common statuses."},"address":{"type":"object","description":"Registered office address from the national registry. Field names and structure vary by country; always includes street-level detail when available."},"industry_codes":{"type":"array","items":{"type":"string"},"description":"Industry classification codes assigned by the source registry. E.g. NACE Rev. 2 codes (Norway, EU), SSIC codes (Singapore). Empty array when the registry holds no codes for this entity."},"registration_date":{"type":"string","format":"date","description":"Date the entity was first registered in the national business registry, as an ISO-8601 date string (YYYY-MM-DD)."},"source":{"type":"string","description":"Human-readable name of the authoritative registry this record was fetched from, e.g. \"Brønnøysund Register Centre (Brreg)\", \"ACRA / data.gov.sg\", \"INSEE Sirene\"."}}},"CompanySearch":{"type":"object","description":"Response from a company registry name-search endpoint.","properties":{"query":{"type":"string","description":"The name or partial name that was searched against the national business registry."},"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyRecord"},"description":"Array of matching company records ordered by relevance score from the source registry. May be empty if no entities matched the query."},"source":{"type":"string","description":"Name of the authoritative registry that performed the search."}}},"PaymentRequiredBody":{"type":"object","description":"Body of the HTTP 402 Payment Required response from the x402 middleware.","properties":{"x402Version":{"type":"integer","example":2,"description":"x402 protocol version in use. Always 2 for this service."},"error":{"type":"string","example":"Payment required","description":"Human-readable error string."},"resource":{"type":"object","description":"Resource descriptor: url is the paid endpoint URL; description includes what the endpoint returns and its per-call price.","properties":{"url":{"type":"string","description":"The full URL of the paid endpoint that requires payment."},"description":{"type":"string","description":"Human-readable description of the endpoint, including per-call price."}}},"accepts":{"type":"array","items":{"type":"object"},"description":"Array of accepted payment options. Each entry specifies: scheme (\"exact\"), amount (USDC in micro-units — divide by 1,000,000 for display), asset (\"USDC\"), network (\"eip155:8453\" for Base mainnet), and payTo (wallet address)."}}},"ErrorBody":{"type":"object","description":"Standard error response body for 400, 404, and 500 responses.","properties":{"error":{"type":"string","description":"Short error category string, e.g. \"Bad request\", \"Not found\", \"Internal error\"."},"detail":{"type":"string","description":"Additional diagnostic detail when available. Present on 400 errors with actionable guidance; absent on 500 errors to avoid leaking implementation details."}}}},"responses":{"PaymentRequired":{"description":"Payment required — pay via x402 protocol and retry with the signed payment header","headers":{"payment-required":{"description":"Base64-encoded JSON containing x402 payment instructions per the x402 v2 spec. Decode to get the accepts array with amount, network, and payTo fields.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredBody"}}}},"BadRequest":{"description":"Bad request — invalid parameter format (e.g. malformed wallet address)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"NotFound":{"description":"Not found — entity does not exist in the source registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"ServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"Unavailable":{"description":"Service temporarily unavailable — upstream data source is down and cache is empty. Caller is NOT charged (503 is returned before x402 payment middleware).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"EconIndicator":{"description":"Single economic indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EconIndicator"}}}},"EconDigest":{"description":"Combined economic digest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EconDigest"}}}},"CompanyRecord":{"description":"Company registry record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyRecord"}}}},"CompanySearch":{"description":"Company search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearch"}}}}}}}