{"openapi":"3.1.0","info":{"title":"Finanz & SEO Tools API","version":"1.7.0","description":"Pay-per-call JSON API for AI agents: structured web extraction (tables, JSON-LD), German Impressum parser, official German statute lookup, EU e-invoicing (E-Rechnung): parse, validate with the official EN 16931 + XRechnung schematron, and generate XRechnung/EN 16931 CII or UBL, EU identifier checks (VIES VAT, EORI, IBAN, IdNr, LEI), compliance pack (live VIES VAT validation, IBAN + German bank/BIC lookup, EU/UN sanctions screening), web page to Markdown, domain/DNS/email-security/TLS intelligence, on-page SEO audits, x402 API recommendations, multi-chain wallet balances, ERC-20 token risk scans, ECB exchange rates, German holidays and business days, German crypto/capital-gains tax and §19 UStG calculators, savings plans, SEC EDGAR financials and recent filings, ESEF/IFRS key metrics, and EU public-procurement tender search. Payment: x402, USDC on Base. No account or API key needed. Informational calculations, not tax/legal advice.","x-guidance":"Web, domain, crypto and German/EU finance tools. Use GET /v1/web/extract?url= to extract tables, JSON-LD and definition lists; GET /v1/de/impressum?url= to parse a German legal notice; GET /v1/de/law?norm=EStG&paragraph=23 for an official statute section; POST /v1/eu/einvoice to parse XRechnung/ZUGFeRD/UBL into JSON; POST /v1/eu/einvoice/validate (XML, base64 or raw XML/PDF body) to validate an e-invoice against the official EN 16931 + XRechnung schematron; POST /v1/eu/einvoice/generate with {syntax, profile, invoice:{number, issueDate, seller, buyer, payment, lines}} to create a valid XRechnung CII/UBL XML (422 + no charge if a business rule fails); POST /v1/eu/einvoice/from-scan with a raw invoice image/PDF (or {base64}/{url}) for OCR + structured fields with per-field confidence, arithmetic checks and optional ?xrechnung=cii; GET /v1/eu/id-check?id= for VIES VAT, EORI, IBAN, IdNr or LEI; GET /v1/eu/vat-check?vat= for a live VIES VAT validation with name/address (503 + no charge if VIES is down); GET /v1/eu/iban-check?iban= for IBAN checksum plus German bank name/BIC; GET /v1/compliance/sanctions?name= to screen a person or company against the EU and UN sanctions lists; GET /v1/web/read?url= to turn any page into clean Markdown; GET /v1/web/domain-intel?domain= for DNS/email security/TLS/registration; GET /v1/x402/recommend?need= to find other paid APIs; GET /v1/crypto/wallet-balances?address= for multi-chain balances; GET /v1/crypto/token-scan?chain=base&address= for token risk; GET /v1/fx/ecb for ECB exchange rates; GET /v1/de/gross-net?gross=4000&taxClass=1 for the official 2026 Brutto-Netto (BMF PAP); GET /v1/de/late-payment-interest?amount=&from= for § 288 BGB default interest; GET /v1/de/real-estate-transfer-tax?price=&state= for Grunderwerbsteuer; GET /v1/de/address?q= to validate/normalise a German address; GET /v1/de/power/green-hours for the greenest electricity hours; GET /v1/us/filings/financials?ticker=AAPL for SEC XBRL key metrics (3 years / 4 quarters, YoY); GET /v1/us/filings/recent?ticker=AAPL for the latest 8-K/10-Q/10-K with item codes and document links; GET /v1/eu/filings/esef?lei= for IFRS metrics from the latest ESEF report; GET /v1/eu/tenders/search?cpv=72&country=DE for current EU TED procurement notices; MCP clients can use the remote MCP server at /mcp (x402 MCP transport); GET /v1/de/holidays and /v1/de/business-days for German calendars. Use GET /v1/seo/audit?url=<public url> for a full on-page SEO report with prioritized fixes; GET /v1/de/crypto-tax/holding-period?buyDate=YYYY-MM-DD&sellDate=YYYY-MM-DD&gainEur=N to check if a German crypto sale is tax-free; POST /v1/de/crypto-tax/fifo with {transactions:[{type,date,amount,totalEur,feeEur}]} for FIFO gains; GET /v1/de/capital-gains-tax?gainEur=N&fundType=equity for German capital gains tax; GET /v1/de/kleinunternehmer for the §19 UStG check; GET /v1/fin/savings-plan for compound-interest projections. All amounts EUR. Pay per call with x402 (USDC on Base).","contact":{"name":"Finanz-SEO x402","url":"https://finanz-seo-x402.vercel.app/"}},"servers":[{"url":"https://finanz-seo-x402.vercel.app"}],"paths":{"/v1/de/crypto-tax/holding-period":{"get":{"summary":"German crypto tax check (§23 EStG)","description":"German crypto tax check (§23 EStG): is a crypto sale tax-free after the 1-year holding period, first tax-free date, and 1,000 EUR Freigrenze check incl. other private sale gains. Price: $0.005 USDC per call via x402.","operationId":"de_crypto_tax_holding_period","tags":["tax","germany","crypto","finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"holdingPeriodMet":false,"taxFreeFrom":"2026-03-02","daysUntilTaxFree":46,"status":"tax_free_below_freigrenze","taxablePrivateGainsEur":0}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"buyDate","in":"query","required":true,"schema":{"type":"string"},"description":"YYYY-MM-DD","example":"2025-03-01"},{"name":"sellDate","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD, default today","example":"2026-01-15"},{"name":"gainEur","in":"query","required":false,"schema":{"type":"number"},"example":850},{"name":"otherPrivateGainsEur","in":"query","required":false,"schema":{"type":"number"},"description":"other §23 gains same year","example":0}]}},"/v1/de/crypto-tax/fifo":{"post":{"summary":"FIFO capital gains for crypto per German BMF letter (10.05.2022)","description":"FIFO capital gains for crypto per German BMF letter (10.05.2022): splits each sale into tax-free (>1 year) and taxable parts, yearly totals with 1,000 EUR Freigrenze, remaining lots with tax-free dates. Up to 2,000 transactions. Price: $0.02 USDC per call via x402.","operationId":"de_crypto_tax_fifo","tags":["tax","germany","crypto","fifo"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.02","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"method":"FIFO","years":{"2025":{"taxableGainEur":0,"taxFreeGainEur":9996}}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["buy","sell"]},"date":{"type":"string"},"amount":{"type":"number"},"totalEur":{"type":"number"},"feeEur":{"type":"number"}},"required":["type","date","amount","totalEur"]}}},"required":["transactions"]},"example":{"transactions":[{"type":"buy","date":"2024-01-10","amount":0.5,"totalEur":20000,"feeEur":10},{"type":"sell","date":"2025-06-01","amount":0.2,"totalEur":18000}]}}}}}},"/v1/de/kleinunternehmer":{"get":{"summary":"German small-business VAT exemption check (§19 UStG, thresholds since 2025","description":"German small-business VAT exemption check (§19 UStG, thresholds since 2025: 25,000 EUR prior year / 100,000 EUR current year), headroom and invoice note. Price: $0.003 USDC per call via x402.","operationId":"de_kleinunternehmer","tags":["tax","germany","vat","smallbusiness"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"eligible":true,"nextYearEligible":true,"headroomEur":{"currentYearHard":78000,"toStayEligibleNextYear":3000}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"prevYearRevenueEur","in":"query","required":true,"schema":{"type":"number"},"example":18000},{"name":"currentYearRevenueEur","in":"query","required":true,"schema":{"type":"number"},"example":22000}]}},"/v1/de/capital-gains-tax":{"get":{"summary":"German capital gains tax (Abgeltungsteuer 25% + Soli + optional church tax 8/9%), Sparerpauschbetrag","description":"German capital gains tax (Abgeltungsteuer 25% + Soli + optional church tax 8/9%), Sparerpauschbetrag (1,000/2,000 EUR) and fund Teilfreistellung (equity 30%, mixed 15%, real estate 60/80%). Returns net gain and effective rate. Price: $0.003 USDC per call via x402.","operationId":"de_capital_gains_tax","tags":["tax","germany","etf","finance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"totalTaxEur":659.38,"netGainEur":4340.62,"effectiveRatePct":13.19}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"gainEur","in":"query","required":true,"schema":{"type":"number"},"example":5000},{"name":"fundType","in":"query","required":false,"schema":{"type":"string","enum":["none","equity","mixed","realestate","realestate_foreign"]},"example":"equity"},{"name":"joint","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]},"example":"false"},{"name":"churchTaxPct","in":"query","required":false,"schema":{"type":"number","enum":[0,8,9]},"example":0},{"name":"allowanceUsedEur","in":"query","required":false,"schema":{"type":"number"},"example":0}]}},"/v1/fin/savings-plan":{"get":{"summary":"Savings plan / compound interest projection with monthly contributions, yearly increase (Dynamik), f","description":"Savings plan / compound interest projection with monthly contributions, yearly increase (Dynamik), fund costs (TER), inflation-adjusted value, yearly table and German tax estimate on sale. Price: $0.002 USDC per call via x402.","operationId":"fin_savings_plan","tags":["finance","investing","calculator"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.002","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"endValueEur":92000,"paidInEur":49000,"realEndValueEur":62000}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"monthlyEur","in":"query","required":true,"schema":{"type":"number"},"example":200},{"name":"startEur","in":"query","required":false,"schema":{"type":"number"},"example":1000},{"name":"years","in":"query","required":true,"schema":{"type":"number"},"example":20},{"name":"returnPct","in":"query","required":false,"schema":{"type":"number"},"example":6},{"name":"terPct","in":"query","required":false,"schema":{"type":"number"},"example":0.2},{"name":"dynamicPct","in":"query","required":false,"schema":{"type":"number"},"example":0},{"name":"inflationPct","in":"query","required":false,"schema":{"type":"number"},"example":2}]}},"/v1/seo/audit":{"get":{"summary":"Automated on-page SEO audit of any public URL","description":"Automated on-page SEO audit of any public URL: title/meta description length, headings, canonical, noindex/robots, robots.txt and sitemap.xml, image alt coverage, internal/external links, Open Graph/Twitter cards, JSON-LD structured data, response time, page size, word count, score 0-100 and a prioritized fix list. Price: $0.10 USDC per call via x402.","operationId":"seo_audit","tags":["seo","audit","website","marketing"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.10","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"score":62,"title":{"text":"Example Domain","length":14},"fixList":[{"priority":"high","code":"missing_meta_description","message":"Missing meta description."}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"public http(s) URL","example":"https://example.com"}]}},"/v1/web/read":{"get":{"summary":"Read any public web page and get clean main content as Markdown (or text/html) plus title, author, p","description":"Read any public web page and get clean main content as Markdown (or text/html) plus title, author, publish date, language, Open Graph metadata and link stats. Boilerplate (nav, ads, footers) removed. HTML and plain text, max 3 MB source. Price: $0.002 USDC per call via x402.","operationId":"web_read","tags":["web","scrape","markdown","reader"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.002","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"title":"Post title","byline":"Jane Doe","content":"# Heading\n\nArticle text...","wordCount":812,"metadata":{"lang":"en","ogImage":"https://..."}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"public http(s) URL","example":"https://example.com/blog/post"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["markdown","text","html"]},"example":"markdown"},{"name":"maxChars","in":"query","required":false,"schema":{"type":"number"},"description":"500..100000, default 20000","example":20000}]}},"/v1/web/domain-intel":{"get":{"summary":"Domain intelligence in one call","description":"Domain intelligence in one call: DNS (A, AAAA, MX, NS, TXT, CAA, SOA), email security (SPF, DMARC policy, MTA-STS), RDAP registration (registrar, created, expires, age), TLS certificate (issuer, expiry, days left), HTTPS redirect and security headers, plus prioritized findings. Price: $0.004 USDC per call via x402.","operationId":"web_domain_intel","tags":["domain","dns","whois","security"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.004"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.004","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"domain":"example.com","email":{"spf":"v=spf1 -all","dmarcPolicy":"reject"},"registration":{"registrar":"...","ageDays":10000},"tls":{"daysRemaining":60},"findings":[{"severity":"low","code":"no_caa"}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"hostname, e.g. example.com","example":"example.com"}]}},"/v1/x402/recommend":{"get":{"summary":"Find the right paid x402 API for a task","description":"Find the right paid x402 API for a task: describe what you need and get ranked endpoints with price, networks, method, 30-day calls and unique payers. Ranking combines text relevance with real recent paid usage; unused, single-payer and wallet-farming listings are filtered out. Price: $0.003 USDC per call via x402.","operationId":"x402_recommend","tags":["x402","discovery","search","recommendation"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"results":[{"resource":"https://...","priceUsd":0.002,"uniquePayers30d":8,"calls30d":1200}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"need","in":"query","required":true,"schema":{"type":"string"},"example":"convert a web page to markdown"},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"number"},"description":"USD","example":0.01},{"name":"network","in":"query","required":false,"schema":{"type":"string","enum":["base","solana"]},"example":"base"},{"name":"limit","in":"query","required":false,"schema":{"type":"number"},"example":5}]}},"/v1/crypto/wallet-balances":{"get":{"summary":"Multi-chain EVM wallet snapshot","description":"Multi-chain EVM wallet snapshot: native coin plus USDC/USDT/WETH/EURC balances on Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Scroll, Linea, zkSync, Unichain and Gnosis with USD values from Chainlink price feeds. Price: $0.005 USDC per call via x402.","operationId":"crypto_wallet_balances","tags":["crypto","wallet","portfolio","evm"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"totalUsd":499.7,"chains":[{"chain":"base","usd":421,"holdings":[{"symbol":"ETH","amount":"0.24","usd":416}]}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x0000000000000000000000000000000000000000"},{"name":"chains","in":"query","required":false,"schema":{"type":"string"},"description":"comma list, default all","example":"base,ethereum,arbitrum"}]}},"/v1/crypto/token-scan":{"get":{"summary":"ERC-20 token risk scan from on-chain data (Base, Ethereum, Arbitrum)","description":"ERC-20 token risk scan from on-chain data (Base, Ethereum, Arbitrum): name/symbol/supply, owner and renounce status, upgradeable proxy detection, privileged functions in bytecode (mint, blacklist, pause, fee change, trading switch), Uniswap v2/v3 liquidity vs WETH/USDC, risk score and flags. Price: $0.008 USDC per call via x402.","operationId":"crypto_token_scan","tags":["crypto","token","risk","security"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.008"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.008","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"symbol":"TOKEN","ownerRenounced":true,"proxy":null,"liquidity":{"totalUsdEst":1000000},"riskScore":3,"flags":[]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","arbitrum"]},"example":"base"},{"name":"address","in":"query","required":true,"schema":{"type":"string"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}},"/v1/fx/ecb":{"get":{"summary":"Official ECB euro reference exchange rates (about 30 currencies), latest or for any date since 1999,","description":"Official ECB euro reference exchange rates (about 30 currencies), latest or for any date since 1999, any base currency via EUR cross rates, with amount conversion. Weekends/holidays fall back to the previous fixing. Price: $0.002 USDC per call via x402.","operationId":"fx_ecb","tags":["fx","currency","exchange-rate","ecb"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.002","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"base":"USD","date":"2025-06-30","rates":{"EUR":0.853},"converted":{"EUR":85.3}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"base","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"symbols","in":"query","required":false,"schema":{"type":"string"},"example":"EUR,GBP,CHF"},{"name":"amount","in":"query","required":false,"schema":{"type":"number"},"example":100},{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD, default latest","example":"2025-06-30"}]}},"/v1/de/holidays":{"get":{"summary":"German public holidays for any year 1995-2100, nationwide or per federal state (BW, BY, BE, BB, HB, ","description":"German public holidays for any year 1995-2100, nationwide or per federal state (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH), with weekday and which states observe each day. Price: $0.002 USDC per call via x402.","operationId":"de_holidays","tags":["germany","holidays","calendar"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.002","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"year":2026,"state":"HE","holidays":[{"date":"2026-06-04","name":"Fronleichnam"}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"number"},"example":2026},{"name":"state","in":"query","required":false,"schema":{"type":"string"},"example":"HE"}]}},"/v1/de/business-days":{"get":{"summary":"German business-day math per federal state","description":"German business-day math per federal state: count working days between two dates, or add/subtract N working days to compute deadlines (weekends and state holidays excluded). Price: $0.002 USDC per call via x402.","operationId":"de_business_days","tags":["germany","business-days","calendar","deadline"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.002","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"result":"2026-12-29","resultWeekday":"Dienstag"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"state","in":"query","required":true,"schema":{"type":"string"},"example":"HE"},{"name":"from","in":"query","required":true,"schema":{"type":"string"},"example":"2026-12-23"},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"addDays","in":"query","required":false,"schema":{"type":"number"},"example":3}]}},"/v1/web/extract":{"get":{"summary":"Extract structured data from any public web page","description":"Extract structured data from any public web page: HTML tables as JSON (headers, rows, captions), JSON-LD / schema.org objects, and definition lists. No LLM. Useful mid-task when an agent needs tabular or typed data rather than prose. Price: $0.003 USDC per call via x402.","operationId":"web_extract","tags":["web","extract","tables","jsonld","schema.org"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"tables":{"count":1,"items":[{"caption":"Plans","headers":["Plan","Price"],"rows":[{"Plan":"Basic","Price":"9"}]}]},"jsonld":{"types":["Organization"]}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"public http(s) URL","example":"https://example.com/prices"}]}},"/v1/eu/einvoice":{"post":{"summary":"Extract structured JSON from a European e-invoice","description":"Extract structured JSON from a European e-invoice: XRechnung, ZUGFeRD / Factur-X (PDF with embedded, compressed XML), UBL 2.1 and UN/CEFACT CII. Returns seller/buyer (name, address, VAT ID, contact), buyer reference / Leitweg-ID, order reference, issue/due/delivery dates, payment terms, IBAN/BIC, payment reference, line items, VAT breakdown and totals. Send JSON {xml}|{base64}|{url} or the raw XML/PDF as request body (application/xml or application/pdf, max 3.5 MB). Price: $0.008 USDC per call via x402.","operationId":"eu_einvoice","tags":["invoice","xrechnung","zugferd","ubl","eu"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.008"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.008","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"format":"xrechnung-cii","id":"RE-2026-0042","issueDate":"2026-11-22","dueDate":"2026-12-06","buyerReference":"04011000-12345-03","currency":"EUR","seller":{"name":"Muster Software GmbH","vatId":"DE123456789"},"buyer":{"name":"Stadt Beispielhausen"},"payment":{"iban":"DE89370400440532013000","meansCode":"58"},"totals":{"net":1009,"tax":185.83,"gross":1194.83,"payable":1194.83},"lineCount":2,"source":"url-xml"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"UBL or CII XML"},"base64":{"type":"string","description":"base64 XML or ZUGFeRD/Factur-X PDF"},"url":{"type":"string","description":"public http(s) URL of the XML or PDF"}}},"example":{"url":"https://example.com/invoice-xrechnung.xml"}}}}}},"/v1/de/impressum":{"get":{"summary":"Extract the legally required German Impressum (legal notice, § 5 DDG) from a public website","description":"Extract the legally required German Impressum (legal notice, § 5 DDG) from a public website: operator, address, email, phone, VAT ID, Handelsregister (court + HRB/HRA), and the person responsible under § 18 MStV. Follows an /impressum link on the same host when the start page is not the notice itself. Price: $0.005 USDC per call via x402.","operationId":"de_impressum","tags":["germany","impressum","legal-notice","compliance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"address":{"street":"Musterstraße 12","postalCode":"60311","city":"Frankfurt am Main"},"vatId":"DE123456789","register":{"court":"Amtsgericht Frankfurt am Main","type":"HRB","number":"99887"}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"url","in":"query","required":false,"schema":{"type":"string"},"description":"public http(s) URL","example":"https://example.com"},{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"description":"hostname, alternative to url"}]}},"/v1/de/law":{"get":{"summary":"Look up a German federal statute from the official gesetze-im-internet.de publication (Federal Minis","description":"Look up a German federal statute from the official gesetze-im-internet.de publication (Federal Ministry of Justice / Federal Office of Justice). Pass a well-known abbreviation (EStG, UStG, BGB, HGB, AO, GG, DDG, …) or the law title; optional paragraph or article returns the official section text with a link to the official page. Without a paragraph, returns the table of contents. Price: $0.003 USDC per call via x402.","operationId":"de_law","tags":["germany","law","statute","legal"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"lawTitle":"Einkommensteuergesetz (EStG)","sectionLabel":"§ 23","sectionTitle":"Private Veräußerungsgeschäfte","officialUrl":"https://www.gesetze-im-internet.de/estg/__23.html"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"norm","in":"query","required":true,"schema":{"type":"string"},"description":"abbreviation or title, e.g. EStG","example":"EStG"},{"name":"paragraph","in":"query","required":false,"schema":{"type":"string"},"description":"section number, e.g. 23 or 23a","example":"23"},{"name":"article","in":"query","required":false,"schema":{"type":"string"},"description":"article number for laws such as GG"},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"filter the table of contents"}]}},"/v1/eu/id-check":{"get":{"summary":"Check an EU/German identifier in one call","description":"Check an EU/German identifier in one call: EU VAT ID via the official VIES API (name/address when published), EORI via the official Commission EOS service, IBAN ISO 13616 checksum, German tax ID (IdNr) checksum, and LEI via the official GLEIF API. Auto-detects the type, or set type=vat|eori|iban|idnr|lei. A VAT-shaped value is checked against both VIES and EORI. Price: $0.005 USDC per call via x402.","operationId":"eu_id_check","tags":["vat","vies","eori","iban","lei"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"DE123456789","detected":["vat","eori"],"checks":[{"type":"vat","valid":false,"source":"EU VIES REST API (European Commission)"}],"anyValid":false}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"DE123456789"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["auto","vat","eori","iban","idnr","lei"]},"example":"auto"}]}},"/v1/eu/vat-check":{"get":{"summary":"Live EU VAT ID (USt-IdNr.) validation against the official European Commission VIES service","description":"Live EU VAT ID (USt-IdNr.) validation against the official European Commission VIES service: valid/invalid, registered name and address (where the member state publishes them), request date, optional consultation number (pass requesterVat) and approximate trader-name/address matching. Per-country format pre-check. If VIES or the member-state database is down the call returns HTTP 503 with status vies_unavailable and the payment is NOT settled. Price: $0.005 USDC per call via x402.","operationId":"eu_vat_check","tags":["vat","vies","compliance","kyb","eu"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"vat":"IE6388047V","countryCode":"IE","vatNumber":"6388047V","valid":true,"formatValid":true,"status":"valid","name":"GOOGLE IRELAND LIMITED","address":"3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4","nameAndAddressPublished":true,"requestDate":"2026-11-22T18:22:56.474Z","consultationNumber":null,"source":"EU VIES REST API (European Commission)"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"vat","in":"query","required":true,"schema":{"type":"string"},"description":"Full VAT ID with country prefix, e.g. DE811569869, IE6388047V, ATU12345678 (GR is mapped to EL). Spaces/dots ignored.","example":"IE6388047V"},{"name":"countryCode","in":"query","required":false,"schema":{"type":"string"},"description":"Alternative to vat: 2-letter VIES country code (EL for Greece, XI for Northern Ireland)"},{"name":"vatNumber","in":"query","required":false,"schema":{"type":"string"},"description":"Alternative to vat: number without country prefix"},{"name":"requesterVat","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: your own EU VAT ID to receive an official consultation number (qualified confirmation)"},{"name":"traderName","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: name to approximately match (supported by some member states)"},{"name":"traderCity","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: city to approximately match"},{"name":"traderPostalCode","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: postal code to approximately match"},{"name":"traderStreet","in":"query","required":false,"schema":{"type":"string"},"description":"Optional: street to approximately match"}]}},"/v1/eu/iban-check":{"get":{"summary":"IBAN validation (ISO 13616 MOD-97 checksum, country length and format for 80+ countries), print form","description":"IBAN validation (ISO 13616 MOD-97 checksum, country length and format for 80+ countries), print format, bank code, SEPA country flag. For German IBANs: bank name, BIC, city and check-digit method from the official Deutsche Bundesbank Bankleitzahlendatei (flags unknown or deleted BLZ). Optional bic parameter is cross-checked against the bank directory. Offline and fast. Price: $0.003 USDC per call via x402.","operationId":"eu_iban_check","tags":["iban","bic","banking","sepa","payments"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"iban":"DE89370400440532013000","valid":true,"country":"DE","checksumOk":true,"lengthOk":true,"printFormat":"DE89 3704 0044 0532 0130 00","sepaCountry":true,"bankCode":"37040044","accountNumber":"532013000","bank":{"blz":"37040044","name":"Commerzbank","city":"Köln","bic":"COBADEFFXXX","checkDigitMethod":"13","deleted":false},"bicCheck":{"bic":"COBADEFFXXX","formatOk":true,"matchesBankDirectory":true}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"iban","in":"query","required":true,"schema":{"type":"string"},"description":"IBAN, spaces allowed, e.g. DE89 3704 0044 0532 0130 00","example":"DE89370400440532013000"},{"name":"bic","in":"query","required":false,"schema":{"type":"string"},"description":"Optional BIC/SWIFT to cross-check (8 or 11 chars)","example":"COBADEFFXXX"}]}},"/v1/compliance/sanctions":{"get":{"summary":"Sanctions screening","description":"Sanctions screening: fuzzy name match of a person or company against the EU Consolidated Financial Sanctions List (European Commission FSF) and the UN Security Council Consolidated List (all names and aliases, diacritics/transliteration/legal-form tolerant, Jaro-Winkler). Returns top matches with score, list, reference number, entity type, programmes, birth dates, citizenships, UN listing date / EU regulation date, optional birth-year/country consistency flags, and each list's publication date. Screening aid, not legal advice. Price: $0.01 USDC per call via x402.","operationId":"compliance_sanctions","tags":["sanctions","aml","kyc","kyb","compliance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.01","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"query":{"name":"Arkady Rotenberg","normalized":"arkady rotenberg","type":"person","lists":["eu","un"],"minScore":0.85},"potentialMatch":true,"matchCount":2,"matches":[{"score":0.955,"list":"EU","reference":"EU.4182.1","entityType":"person","matchedName":"Arkadi Rotenberg","primaryName":"Arkady Romanovich ROTENBERG","programmes":["UKR"],"birthDates":["1951-12-15"],"citizenships":[],"regulationDate":"2023-09-14","dobMatch":null,"countryMatch":null}],"listsScreened":[{"list":"EU","publicationDate":"2026-11-20T16:51:00.798+01:00","entries":6303},{"list":"UN","publicationDate":"2026-11-22T00:00:00.942Z","entries":1007}],"disclaimer":"Screening aid only, not legal advice."}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"description":"Person or organisation name to screen (3-200 chars)","example":"Arkady Rotenberg"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["any","person","entity"]},"description":"Restrict to persons or entities (default any)","example":"person"},{"name":"lists","in":"query","required":false,"schema":{"type":"string"},"description":"Comma list of eu, un (default eu,un)","example":"eu,un"},{"name":"minScore","in":"query","required":false,"schema":{"type":"number"},"description":"Similarity threshold 0.6-1 (default 0.85)","example":0.85},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Max matches 1-25 (default 10)","example":5},{"name":"birthYear","in":"query","required":false,"schema":{"type":"integer"},"description":"Optional birth year of the screened person; adds dobMatch (+/-1 year) and ranks contradicting hits last"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Optional ISO 3166-1 alpha-2 nationality; adds countryMatch"}]}},"/v1/eu/einvoice/validate":{"post":{"summary":"Validate a German/EU e-invoice (E-Rechnung) with the OFFICIAL rule sets","description":"Validate a German/EU e-invoice (E-Rechnung) with the OFFICIAL rule sets: CEN EN 16931 schematron (UBL + CII, validation-1.3.17) and KoSIT XRechnung 3.0 CIUS schematron. Accepts XRechnung UBL/CII XML or a ZUGFeRD / Factur-X PDF (embedded XML is extracted). Checks well-formedness, detects syntax and profile (XRechnung, Factur-X MINIMUM/BASIC WL/BASIC/EN16931/EXTENDED, Peppol BIS), returns valid/invalid with every error and warning (rule ID such as BR-CO-16 or BR-DE-15, message, XPath location) plus a short invoice summary. Send JSON {xml}|{base64}|{url} or the raw XML/PDF body (application/xml, application/pdf; max 3.5 MB). Optional rules=auto|en16931|xrechnung. Price: $0.02 USDC per call via x402.","operationId":"eu_einvoice_validate","tags":["invoice","xrechnung","zugferd","factur-x","en16931"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.02","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"xml","wellFormed":true,"syntax":"CII","profile":{"id":"urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0","name":"XRechnung 3.0","family":"xrechnung","en16931":true},"valid":false,"status":"invalid","rulesApplied":[{"ruleSet":"EN 16931 CII (CEN/TC 434 validation-1.3.17)","errors":1,"warnings":0},{"ruleSet":"XRechnung CIUS CII (KoSIT xrechnung-3.0.2-schematron-2.6.0)","errors":1,"warnings":0}],"errorCount":2,"warningCount":0,"errors":[{"id":"BR-CO-16","severity":"error","message":"[BR-CO-16]-Amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) -Paid amount (BT-113) +Rounding amount (BT-114).","location":"/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/SpecifiedTradeSettlementHeaderMonetarySummation"},{"id":"BR-DE-15","severity":"error","message":"[BR-DE-15] Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.","location":"/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeAgreement"}],"warnings":[],"invoice":{"id":"RE-2026-0042","issueDate":"2026-11-22","seller":"Muster Software GmbH","payable":1000,"lineCount":2}}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XRechnung / EN 16931 invoice XML (UBL 2.1 Invoice/CreditNote or UN/CEFACT CII)"},"base64":{"type":"string","description":"base64 of the XML or of a ZUGFeRD / Factur-X PDF"},"url":{"type":"string","description":"public http(s) URL of the XML or PDF"},"rules":{"type":"string","enum":["auto","en16931","xrechnung"],"description":"auto (default): XRechnung rules for XRechnung documents, EN 16931 for others"}}},"example":{"xml":"<rsm:CrossIndustryInvoice xmlns:rsm=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\" ...>...</rsm:CrossIndustryInvoice>","rules":"auto"}}}}}},"/v1/eu/einvoice/generate":{"post":{"summary":"Generate a valid XRechnung 3.0 (or plain EN 16931 / Factur-X EN16931 XML) e-invoice from a simple JS","description":"Generate a valid XRechnung 3.0 (or plain EN 16931 / Factur-X EN16931 XML) e-invoice from a simple JSON payload, as UN/CEFACT CII or UBL 2.1 (invoice, credit note 381, partial/corrected invoices). Computes line totals, VAT breakdown per category/rate (S, Z, E incl. § 19 UStG Kleinunternehmer, AE reverse charge, K, G, O) and totals, then self-validates with the official CEN EN 16931 + KoSIT XRechnung schematron. Returns the XML plus validation report. If the result violates a business rule the call returns HTTP 422 with the rule errors and is NOT charged. Price: $0.03 USDC per call via x402.","operationId":"eu_einvoice_generate","tags":["invoice","xrechnung","zugferd","factur-x","en16931"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.03","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"syntax":"CII","profile":"XRechnung 3.0","customizationId":"urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0","documentType":"commercial invoice","filename":"xrechnung-cii-RE-2026-0042.xml","totals":{"currency":"EUR","lineTotal":1009,"taxBasis":1009,"tax":185.83,"grand":1194.83,"prepaid":0,"due":1194.83},"vatBreakdown":[{"category":"S","rate":19,"basis":960,"tax":182.4},{"category":"S","rate":7,"basis":49,"tax":3.43}],"validation":{"valid":true,"status":"valid","errors":[],"warnings":[]},"xml":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><rsm:CrossIndustryInvoice ...>"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"syntax":{"type":"string","enum":["cii","ubl"],"description":"Output syntax (default cii; ZUGFeRD/Factur-X use CII)"},"profile":{"type":"string","enum":["xrechnung","en16931"],"description":"xrechnung (default, XRechnung 3.0 CIUS) or en16931 (plain EN 16931, e.g. for a Factur-X/ZUGFeRD EN16931 PDF)"},"invoice":{"type":"object","description":"Invoice data","properties":{"number":{"type":"string"},"issueDate":{"type":"string","description":"YYYY-MM-DD"},"dueDate":{"type":"string"},"deliveryDate":{"type":"string","description":"date of supply (§ 14 UStG)"},"servicePeriod":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"}}},"typeCode":{"type":"integer","description":"380 invoice (default), 381 credit note, 384 corrected, 326 partial, 389 self-billed"},"currency":{"type":"string","description":"ISO 4217, default EUR"},"buyerReference":{"type":"string","description":"BT-10, Leitweg-ID for German public buyers (required by XRechnung)"},"orderReference":{"type":"string"},"precedingInvoice":{"type":"string","description":"referenced invoice for credit notes/corrections"},"note":{"type":"string"},"paymentTerms":{"type":"string"},"vatExemptionReason":{"type":"string","description":"for categories E/AE/K/G/O, e.g. 'Kein Ausweis von Umsatzsteuer, da Kleinunternehmer gemäß § 19 UStG'"},"prepaidAmount":{"type":"number"},"seller":{"type":"object","description":"name, street, postalCode, city, country, vatId and/or taxNumber, registrationId (e.g. HRB), id, email, phone, contactName, electronicAddress (+scheme; defaults to email/EM)"},"buyer":{"type":"object","description":"name, street, postalCode, city, country, vatId, id, email or electronicAddress (required by XRechnung)"},"payment":{"type":"object","description":"meansCode (58 SEPA transfer default with iban, 30, 59, 10...), iban, bic, accountName, reference"},"lines":{"type":"array","description":"max 500","items":{"type":"object","properties":{"name":{"type":"string"},"quantity":{"type":"number"},"unitCode":{"type":"string","description":"UN/ECE Rec 20, e.g. C62 piece (default), HUR hour, DAY, KGM, LS lump sum"},"unitPrice":{"type":"number","description":"net unit price"},"vatRate":{"type":"number","description":"percent, default 19"},"vatCategory":{"type":"string","enum":["S","Z","E","AE","K","G","O"]},"description":{"type":"string"},"sellerItemId":{"type":"string"}},"required":["name","quantity","unitPrice"]}}},"required":["number","issueDate","seller","buyer","lines"]}},"required":["invoice"]},"example":{"syntax":"cii","profile":"xrechnung","invoice":{"number":"RE-2026-0042","issueDate":"2026-11-22","dueDate":"2026-12-06","deliveryDate":"2026-11-20","buyerReference":"04011000-12345-03","seller":{"name":"Muster Software GmbH","street":"Hauptstr. 1","postalCode":"10115","city":"Berlin","country":"DE","vatId":"DE123456789","email":"rechnung@muster.example","phone":"+49 30 123456","contactName":"Erika Muster"},"buyer":{"name":"Stadt Beispielhausen","street":"Rathausplatz 2","postalCode":"60311","city":"Frankfurt am Main","country":"DE","email":"eingang@beispielhausen.example"},"payment":{"iban":"DE89370400440532013000","bic":"COBADEFFXXX","reference":"RE-2026-0042"},"lines":[{"name":"Beratung","quantity":8,"unitCode":"HUR","unitPrice":120,"vatRate":19},{"name":"Fachbuch","quantity":2,"unitPrice":24.5,"vatRate":7}]}}}}}}},"/v1/eu/einvoice/from-scan":{"post":{"summary":"Invoice OCR","description":"Invoice OCR: turn a scanned or photographed invoice (JPEG, PNG, WebP, TIFF) or a non-structured PDF (text layer or embedded scan images, max 3 pages, 4 MB) into structured JSON with per-field confidence: invoice number, dates, seller/buyer name and address, VAT ID, tax number, HRB, IBAN (checksum-validated, bank/BIC from the Bundesbank directory), BIC, payment terms and due date, net/VAT/gross totals, VAT breakdown, § 19 / reverse-charge hints and line items. Cross-checks the arithmetic (line sum = net, basis × rate = VAT, net + VAT = gross) and flags inconsistencies. Nothing is guessed: unreadable fields are null with confidence 0. Optional xrechnung=cii|ubl builds an XRechnung 3.0 / EN 16931 XML via the official schematron and returns validation errors or the list of missing business terms instead of inventing data. German and English invoices. Send the file as raw body (Content-Type image/jpeg, image/png, image/webp, image/tiff or application/pdf) or JSON {base64} / {url}. No charge (HTTP 4xx/422) if no text can be read. Price: $0.04 USDC per call via x402.","operationId":"eu_einvoice_from_scan","tags":["invoice","ocr","scan","receipt","pdf"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.04","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"source":"jpeg","engine":"tesseract-ocr","pages":1,"ocrConfidence":0.89,"fields":{"invoiceNumber":{"value":"RE-2026-0042","confidence":0.83},"invoiceDate":{"value":"2026-11-22","confidence":0.85},"seller":{"name":{"value":"Muster Software GmbH","confidence":0.82},"vatId":{"value":"DE123456789","confidence":0.86}},"buyer":{"name":{"value":"Stadt Beispielhausen","confidence":0.71}},"payment":{"iban":{"value":"DE89370400440532013000","confidence":0.87},"bic":{"value":"COBADEFFXXX","confidence":0.97},"bankName":{"value":"Commerzbank","confidence":0.9},"dueDate":{"value":"2026-12-06","confidence":0.81}},"totals":{"net":{"value":1009,"confidence":0.85},"vat":{"value":185.83,"confidence":0.79},"gross":{"value":1194.83,"confidence":0.86}},"vatBreakdown":[{"rate":19,"basis":960,"tax":182.4},{"rate":7,"basis":49,"tax":3.43}],"lineItems":[{"position":1,"description":"Beratung Projekt X","quantity":8,"unitCode":"HUR","unitPrice":120,"vatRate":19,"lineTotal":960}]},"checks":[{"check":"net_plus_vat_equals_gross","ok":true,"expected":1194.83,"found":1194.83}],"consistent":true,"einvoice":{"generated":true,"status":"valid","syntax":"CII","profile":"XRechnung 3.0","xml":"<?xml ...>"},"text":"Muster Software GmbH\n..."}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base64":{"type":"string","description":"base64 of a JPEG/PNG/WebP/TIFF image or PDF (alternatively POST the raw file with its Content-Type)"},"url":{"type":"string","description":"public http(s) URL of the image or PDF"},"xrechnung":{"type":"string","enum":["cii","ubl"],"description":"also generate and validate an XRechnung/EN 16931 XML from the extracted data (query parameter when posting a raw file)"},"profile":{"type":"string","enum":["xrechnung","en16931"],"description":"profile for the generated XML (default xrechnung)"},"buyerEmail":{"type":"string","description":"buyer electronic address (BT-49), usually not printed on the invoice"},"leitwegId":{"type":"string","description":"buyer reference / Leitweg-ID (BT-10) if not printed"}}},"example":{"base64":"<base64 of invoice.jpg>","xrechnung":"cii","buyerEmail":"eingang@beispielhausen.example","leitwegId":"04011000-12345-03"}}}}}},"/v1/de/late-payment-interest":{"get":{"summary":"German statutory default interest (Verzugszinsen, § 288 BGB)","description":"German statutory default interest (Verzugszinsen, § 288 BGB): base rate (Basiszinssatz § 247 BGB, live from Deutsche Bundesbank with full history since 2002) + 5 points (consumer involved) or + 9 points (B2B), split into periods at every base-rate change and year end, actual/365, plus the 40 EUR B2B lump sum (§ 288 Abs. 5 BGB) and the total claim. Price: $0.005 USDC per call via x402.","operationId":"de_late_payment_interest","tags":["verzugszinsen","interest","bgb","288","basiszinssatz"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"amount":10000,"from":"2025-03-01","to":"2026-11-22","days":632,"b2b":true,"marginPoints":9,"currentBasisRate":{"since":"2026-07-01","percent":1.52},"periods":[{"from":"2025-03-01","to":"2025-06-30","days":122,"basisRate":2.27,"ratePercent":11.27,"interest":376.7},{"from":"2025-07-01","to":"2026-06-30","days":365,"basisRate":1.27,"ratePercent":10.27,"interest":1027},{"from":"2026-07-01","to":"2026-11-22","days":145,"basisRate":1.52,"ratePercent":10.52,"interest":417.92}],"interest":1821.61,"lumpSum":40,"totalClaim":11861.61}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"amount","in":"query","required":true,"schema":{"type":"number"},"description":"principal in EUR","example":10000},{"name":"from","in":"query","required":true,"schema":{"type":"string"},"description":"first day of default (YYYY-MM-DD, inclusive)","example":"2025-03-01"},{"name":"to","in":"query","required":false,"schema":{"type":"string"},"description":"last day (inclusive), default today","example":"2026-11-22"},{"name":"b2b","in":"query","required":false,"schema":{"type":"boolean"},"description":"true if no consumer is involved (base rate + 9 points and 40 EUR lump sum); default false (+5 points)","example":true},{"name":"margin","in":"query","required":false,"schema":{"type":"number"},"description":"override the points above base rate (e.g. contractual)"}]}},"/v1/de/real-estate-transfer-tax":{"get":{"summary":"German real-estate transfer tax (Grunderwerbsteuer) for a purchase price in any of the 16 states, wi","description":"German real-estate transfer tax (Grunderwerbsteuer) for a purchase price in any of the 16 states, with the rate valid on the acquisition date (rate history since 2016, e.g. Bremen 5.5 % from 01.07.2025), rounding down to full euros, the 2,500 EUR exemption and a comparison of all states. Price: $0.003 USDC per call via x402.","operationId":"de_real_estate_transfer_tax","tags":["grunderwerbsteuer","real-estate","property","tax","germany"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"price":450000,"date":"2026-11-22","state":"NW","stateName":"Nordrhein-Westfalen","ratePercent":6.5,"rateSince":"2015-01-01","tax":29250,"exemptSmallAmount":false,"comparison":[{"state":"BY","ratePercent":3.5,"tax":15750},{"state":"NW","ratePercent":6.5,"tax":29250}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"price","in":"query","required":true,"schema":{"type":"number"},"description":"purchase price / consideration in EUR","example":450000},{"name":"state","in":"query","required":false,"schema":{"type":"string"},"description":"state code (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) or name; omit to compare all","example":"NW"},{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"acquisition date YYYY-MM-DD (default today, min 2016-01-01)","example":"2026-11-22"}]}},"/v1/de/gross-net":{"get":{"summary":"German gross-to-net salary 2026 (Brutto-Netto)","description":"German gross-to-net salary 2026 (Brutto-Netto): wage tax, solidarity surcharge and church-tax base computed with the official BMF Programmablaufplan 2026 (verified against 29 BMF reference cases), church tax 8/9 %, and employee social insurance with the 2026 values (health incl. additional contribution, care with childless surcharge/child discounts/Saxony, pension, unemployment, assessment ceilings, Übergangsbereich 603.01-2,000 EUR). Tax classes 1-6, factor method, monthly or yearly. Price: $0.01 USDC per call via x402.","operationId":"de_gross_net","tags":["brutto-netto","salary","payroll","lohnsteuer","income-tax"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.01","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"year":2026,"period":"month","gross":4000,"taxClass":1,"taxes":{"incomeTax":524.5,"solidaritySurcharge":0,"churchTax":0,"total":524.5},"socialInsurance":{"health":350,"care":96,"pension":372,"unemployment":52,"total":870},"net":2605.5}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"gross","in":"query","required":true,"schema":{"type":"number"},"description":"gross salary in EUR for the period","example":4000},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["month","year"]},"example":"month"},{"name":"taxClass","in":"query","required":false,"schema":{"type":"integer"},"description":"Steuerklasse 1-6 (default 1)","example":1},{"name":"state","in":"query","required":false,"schema":{"type":"string"},"description":"state code/name (church-tax rate 8 % BY/BW else 9 %; Saxony care rate), default NW","example":"NW"},{"name":"church","in":"query","required":false,"schema":{"type":"boolean"},"example":false},{"name":"children","in":"query","required":false,"schema":{"type":"integer"},"description":"number of children (care-insurance childless surcharge/discounts)","example":0},{"name":"childrenUnder25","in":"query","required":false,"schema":{"type":"integer"}},{"name":"childAllowances","in":"query","required":false,"schema":{"type":"number"},"description":"Kinderfreibetragszähler from ELStAM (affects soli/church tax), default 0"},{"name":"age","in":"query","required":false,"schema":{"type":"integer"},"description":"age (childless surcharge from 23; Altersentlastungsbetrag)","example":30},{"name":"kvZusatz","in":"query","required":false,"schema":{"type":"number"},"description":"health fund additional contribution % (default 2.9)"},{"name":"factor","in":"query","required":false,"schema":{"type":"number"},"description":"factor for tax class IV with factor"}]}},"/v1/de/address":{"get":{"summary":"German address / postcode normalisation and validation","description":"German address / postcode normalisation and validation: parses a free-text address or postalCode/city/street, checks that the postcode exists, that city and postcode match and that the street exists in that postcode area (fuzzy matching, e.g. 'Hauptstrasse' vs 'Hauptstraße'), and returns the normalised address, state and official municipality key (AGS) plus ranked candidates. Data: OpenStreetMap via OpenPLZ (ODbL), ~8,100 postcodes, 1.2 million street entries. House numbers are not verified. Price: $0.003 USDC per call via x402.","operationId":"de_address","tags":["address","plz","postcode","zip","validation"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.003","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"valid":true,"normalized":{"street":"Pariser Platz","houseNumber":"1","postalCode":"10117","city":"Berlin","state":"BE","country":"DE","line1":"Pariser Platz 1","line2":"10117 Berlin"},"regionalKey":"11000000","warnings":[],"attribution":"© OpenStreetMap contributors (ODbL), via OpenPLZ API data"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"free-text address, e.g. 'Grabbeallee 12, 13156 Berlin'","example":"Pariser Platz 1, Berlin"},{"name":"postalCode","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"street","in":"query","required":false,"schema":{"type":"string"}},{"name":"houseNumber","in":"query","required":false,"schema":{"type":"string"}}]}},"/v1/de/power/green-hours":{"get":{"summary":"Greenest hours to use electricity in Germany for the next 36 hours","description":"Greenest hours to use electricity in Germany for the next 36 hours: hourly forecast wind + solar generation vs forecast grid load from the Bundesnetzagentur (SMARD, CC BY 4.0), renewable share per hour, the best contiguous window of N hours (e.g. EV charging, heat pump, batch jobs) and the dirtiest hours. Prices are deliberately not included. Price: $0.005 USDC per call via x402.","operationId":"de_power_green_hours","tags":["electricity","power","renewables","smard","green-hours"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"region":"DE","hoursCovered":28,"bestWindow":{"hours":3,"fromLocal":"2026-11-23 11:00","toLocal":"2026-11-23 14:00","avgRenewableSharePercent":41.79},"greenest":[{"startLocal":"2026-11-23 12:00","windSolarMWh":29828.33,"loadMWh":69373.21,"renewableSharePercent":43}],"attribution":"Bundesnetzagentur | SMARD.de, CC BY 4.0"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer"},"description":"length of the window to find (1-12, default 3)","example":3},{"name":"horizon","in":"query","required":false,"schema":{"type":"integer"},"description":"hours ahead to consider (1-48, default 36)"}]}},"/v1/us/filings/financials":{"get":{"summary":"SEC EDGAR XBRL financials for a US-listed company (ticker or CIK)","description":"SEC EDGAR XBRL financials for a US-listed company (ticker or CIK): revenue, net income, diluted EPS, operating cash flow, total assets/liabilities and shares for the latest 3 fiscal years and 4 quarters, with year-on-year changes. Q4 is derived as FY minus Q1–Q3 when no explicit quarter is tagged; cash-flow quarters are split out of year-to-date figures when needed. Source: official companyfacts (public domain). 503 and no charge if EDGAR is down. Price: $0.01 USDC per call via x402.","operationId":"us_filings_financials","tags":["filings","sec","earnings","xbrl","fundamentals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.01","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cik":"0000320193","ticker":"AAPL","name":"Apple Inc.","currency":"USD","annual":[{"fiscalYear":2026,"fiscalPeriod":"FY","start":"2025-09-28","end":"2026-09-26","form":"10-K","filed":"2026-11-03","revenue":{"value":478834000000,"yoyChangePercent":15.06},"netIncome":{"value":132175000000,"yoyChangePercent":18},"eps":{"value":8.98},"operatingCashFlow":{"value":145097000000},"totalAssets":{"value":404548000000},"totalLiabilities":{"value":292455000000},"sharesOutstanding":{"value":14532259000}}],"quarters":[{"fiscalYear":2026,"fiscalPeriod":"Q4","start":"2026-06-28","end":"2026-09-26","derived":true,"revenue":{"value":114477000000}}],"source":"SEC EDGAR (data.sec.gov)"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string"},"description":"SEC ticker, e.g. AAPL or BRK-B (dot or hyphen)","example":"AAPL"},{"name":"cik","in":"query","required":false,"schema":{"type":"string"},"description":"SEC Central Index Key, 1-10 digits; used instead of or together with ticker"}]}},"/v1/us/filings/recent":{"get":{"summary":"Latest SEC EDGAR filings for a US-listed company (ticker or CIK), with form type, filing and report ","description":"Latest SEC EDGAR filings for a US-listed company (ticker or CIK), with form type, filing and report dates, 8-K item codes and names (e.g. 2.02 Results of Operations), the primary document and an index link. Default forms: 8-K, 10-Q, 10-K (amendments included). 503 and no charge if EDGAR is down. Price: $0.005 USDC per call via x402.","operationId":"us_filings_recent","tags":["filings","sec","8-k","10-k","edgar"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.005","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cik":"0000320193","ticker":"AAPL","name":"Apple Inc.","exchange":"Nasdaq","fiscalYearEnd":"0925","forms":["8-K","10-Q","10-K"],"returned":2,"filings":[{"form":"8-K","filed":"2026-11-09","reportDate":"2026-11-05","accession":"0001140361-26-042798","items":[{"code":"8.01","name":"Other Events"},{"code":"9.01","name":"Financial Statements and Exhibits"}],"documentUrl":"https://www.sec.gov/Archives/edgar/data/320193/000114036126042798/ef20085077_8k.htm","indexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000114036126042798/0001140361-26-042798-index.html","isXBRL":true}]}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string"},"example":"AAPL"},{"name":"cik","in":"query","required":false,"schema":{"type":"string"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string"},"description":"comma-separated form types (default 8-K,10-Q,10-K); amendments are included unless you ask only for /A","example":"8-K,10-Q,10-K"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"1-50, default 20","example":20}]}},"/v1/eu/filings/esef":{"get":{"summary":"Key IFRS metrics from the latest ESEF (or UKSEF) annual report for a company identified by LEI","description":"Key IFRS metrics from the latest ESEF (or UKSEF) annual report for a company identified by LEI: revenue, net income, diluted EPS, operating cash flow, total assets/liabilities and shares outstanding, including comparative years in that report with year-on-year changes. Source: filings.xbrl.org (no restrictions on use, 22.11.2026). Coverage is incomplete (Germany and Ireland are typically missing). 503 and no charge if the index or the xBRL-JSON extract is down. Price: $0.01 USDC per call via x402.","operationId":"eu_filings_esef","tags":["filings","esef","xbrl","ifrs","europe"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.01","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"lei":"724500Y6DUVHQD6OXN27","name":"ASML Holding N.V.","country":"NL","periodEnd":"2025-12-31","currency":"EUR","annual":[{"fiscalYear":2025,"fiscalPeriod":"FY","start":"2025-01-01","end":"2025-12-31","revenue":{"value":32667300000,"yoyChangePercent":15.58},"netIncome":{"value":10213000000},"eps":{"value":26.26},"operatingCashFlow":{"value":13826500000},"totalAssets":{"value":55576800000},"totalLiabilities":{"value":31391800000,"derived":true},"sharesOutstanding":{"value":385400000}}],"links":{"viewer":"https://filings.xbrl.org/724500Y6DUVHQD6OXN27/2025-12-31/ESEF/NL/0/asml-2025-12-31-1-en/reports/ixbrlviewer.html"},"source":"filings.xbrl.org (XBRL International)"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"lei","in":"query","required":true,"schema":{"type":"string"},"description":"20-character ISO 17442 LEI","example":"724500Y6DUVHQD6OXN27"}]}},"/v1/eu/tenders/search":{"get":{"summary":"Search current EU public-procurement notices (TED / Official Journal S)","description":"Search current EU public-procurement notices (TED / Official Journal S): filter by CPV prefix, ISO country or NUTS region, keywords, estimated-value range (EUR) and a minimum tender deadline (default: still open). Returns title, buyer, CPV, value, deadline, procedure, official link and a short summary of the lot description. Source: official TED Search API; commercial reuse allowed (Commission Decision 2011/833/EU). 503 and no charge if TED is down. Price: $0.01 USDC per call via x402.","operationId":"eu_tenders_search","tags":["tenders","procurement","ted","eu","ausschreibung"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"price":"$0.01","asset":"USDC","networks":["eip155:8453","eip155:84532"],"payTo":"0xA0C780B988c6Df213B39346eeB6878970DC0fdf1","scheme":"exact"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"total":200,"returned":1,"tenders":[{"id":"668378-2026","title":"Germany – Software supply services – Open-House-Zulassungsverfahren zur Zulassung von Distributoren für das openDesk-Ökosystem","buyer":"Zentrum für Digitale Souveränität der Öffentlichen Verwaltung (ZenDiS) GmbH","buyerCountry":"DEU","cpv":["72268000","72260000"],"deadline":"2027-01-31","procedure":"open","summary":"Gegenstand der Bekanntmachung ist die Zulassung von Unternehmen als Distributoren für das openDesk-Ökosystem...","link":"https://ted.europa.eu/en/notice/-/detail/668378-2026"}],"source":"TED – Tenders Electronic Daily"}}}},"400":{"description":"Invalid input (not settled)"},"402":{"description":"Payment Required (x402). Pay and retry with PAYMENT-SIGNATURE header."}},"parameters":[{"name":"cpv","in":"query","required":false,"schema":{"type":"string"},"description":"CPV code or prefix (2-8 digits), comma-separated, e.g. 72 or 72000000,45233100","example":"72"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 3166 country (DE or DEU) matching buyer or place of performance","example":"DE"},{"name":"nuts","in":"query","required":false,"schema":{"type":"string"},"description":"NUTS region of the place of performance, e.g. DE1 or DE111"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"alias of nuts"},{"name":"keywords","in":"query","required":false,"schema":{"type":"string"},"description":"full-text keywords","example":"software"},{"name":"minValue","in":"query","required":false,"schema":{"type":"number"},"description":"minimum total value in EUR"},{"name":"maxValue","in":"query","required":false,"schema":{"type":"number"},"description":"maximum total value in EUR"},{"name":"deadlineAfter","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD; default today (only still-open notices). Pass open=false to include closed ones."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"1-25, default 10","example":10},{"name":"procedure","in":"query","required":false,"schema":{"type":"string"},"description":"e.g. open, restricted"}]}},"/health":{"get":{"operationId":"health","summary":"Free: /health","security":[],"responses":{"200":{"description":"OK"}}}},"/api/info":{"get":{"operationId":"apiinfo","summary":"Free: /api/info","security":[],"responses":{"200":{"description":"OK"}}}}}}