{"service":"Small utility APIs for agents (pay per call with x402)","products":[{"id":"iban-validate","endpoint":"POST /v1/iban/validate","method":"POST","alsoSupported":["GET /v1/iban/validate"],"price":"$0.003","network":"eip155:8453","description":"Use when an agent must check an IBAN before paying or saving it. Offline: characters, length, country account pattern, check digits (89 country codes, list at GET /; territories like AX, GP, GG unsupported). valid:false with status \"unsupported\" = not checkable, not necessarily invalid. Prefer POST {\"iban\"}: URLs may reach infra logs; the app does not store the IBAN. No charge: 400 bad input, 405 other methods, 429; no input and no payment gets a 402 quote. 502 if payment is down. No re-sends.","input":{"iban":"string - The IBAN to check (15-34 characters after removing spaces; shorter or longer is rejected with 400 before payment, no charge). Spaces and lowercase are accepted (e.g. GB82 WEST 1234 5698 7654 32). Send it as JSON body {\"iban\": \"...\"} with POST (recommended) or as ?iban= with GET."},"inputFormat":["POST: JSON body","GET: query string"],"output":{"valid":"boolean - true only when country, length, account-part pattern and check digits are all OK","status":"string - valid = all checks passed; invalid = a definite error; unsupported = every country-independent check passed (characters, length range, check digits) but the country is not in the supported list, so validity could not be determined","supported":"boolean - The country is in the supported IBAN country list","country":"string|null - 2-letter country code from the IBAN prefix","lengthOk":"boolean - Length matches the country's IBAN length","expectedLength":"integer|null - Expected total length for the country","formatOk":"boolean - Account part (BBAN) letters/digits pattern matches the country format","checksumOk":"boolean - Check digits are 02-98 and equal 98 minus the mod 97 remainder","formatted":"string|null - Normalized IBAN in groups of 4 characters","bban":"string|null - Basic Bank Account Number (IBAN without country code and check digits)","errors":"array - Human-readable reasons when valid is false"},"example":{"iban":"GB82WEST12345698765432"},"coverage":{"supportedCountryCount":89,"supportedCountries":["AD","AE","AL","AT","AZ","BA","BE","BG","BH","BI","BR","BY","CH","CR","CY","CZ","DE","DJ","DK","DO","EE","EG","ES","FI","FK","FO","FR","GB","GE","GI","GL","GR","GT","HN","HR","HU","IE","IL","IQ","IS","IT","JO","KW","KZ","LB","LC","LI","LT","LU","LV","LY","MC","MD","ME","MK","MN","MR","MT","MU","NI","NL","NO","OM","PK","PL","PS","PT","QA","RO","RS","RU","SA","SC","SD","SE","SI","SK","SM","SO","ST","SV","TL","TN","TR","UA","VA","VG","XK","YE"],"excludedCountries":["AX","GF","GP","MQ","RE","PF","TF","YT","NC","BL","MF","PM","WF","IM","JE","GG"],"notes":["Only the listed country codes are checked against a per-country length and account-part pattern.","The excluded codes (overseas territories and crown dependencies) are not supported as separate IBAN country codes: they return status \"unsupported\" (or \"invalid\" if a country-independent check fails).","valid:false does not by itself mean the IBAN is wrong: check status. \"unsupported\" means the format could not be judged for that country; \"invalid\" means a definite error.","No account lookup: this does not confirm the account exists or who owns it."]},"dataRetention":"The application does not store the IBAN or the result and does not write them to application logs. A URL (GET query) can still appear in infrastructure logs (e.g. Cloudflare) and in client-side logs, so send real account numbers with POST and a JSON body. Usage records (request type, status, country, client category, product id, and for paid calls a keyed-hash buyer ID used only to count repeat purchases) are kept for up to about 91 days. No IP addresses."},{"id":"fx-ecb","endpoint":"POST /v1/fx/ecb","method":"POST","alsoSupported":["GET /v1/fx/ecb"],"price":"$0.003","network":"eip155:8453","description":"Use when an agent needs the ECB euro reference rate for a currency pair on a date (default latest), optionally converting an amount (max 1e9, 6 decimals). 29 currencies + EUR from 1999-01-04. Inverse/cross rates via EUR are calculated here and rounded (rate 10 significant digits, converted 6 decimals). Information only; original data free at ecb.europa.eu. No charge: 400, 404 no rate, 405, 429; 502/503 (incl. stale data).","input":{"from":"string - Source currency code (EUR or an ECB-published currency, e.g. USD). See GET / for the list.","to":"string - Target currency code.","date":"string - Optional YYYY-MM-DD, from 1999-01-04 up to today (UTC). Weekends, TARGET holidays and times before publication use the previous publication day (fallback:true). Omit for the latest.","amount":"string|number - Optional amount to convert from 'from' to 'to': greater than 0, at most 1000000000, at most 6 decimals (a number or a decimal string)."},"inputFormat":["POST: JSON body","GET: query string"],"output":{"from":"string - Source currency code (normalized to upper case)","to":"string - Target currency code","rate":"number - Units of 'to' per 1 unit of 'from', rounded to 10 significant digits","amount":"number|null - The amount that was converted, if given","converted":"number|null - amount x rate rounded half-up to 6 decimals, if amount was given (an IEEE double; see convertedText for the exact decimal)","convertedText":"string|null - converted as an exact decimal string with 6 decimals","date":"string - ECB publication date actually used (YYYY-MM-DD)","requestedDate":"string|null - The date asked for, or null for the latest","fallback":"boolean - true only if the requested date was a weekend, TARGET holiday or not yet published, so the previous publication day was used","source":"string - Data source name","sourceUrl":"string - ECB reference rates page","attribution":"string - Source credit; the original data is free from the ECB","note":"string - Information-only notice and the processing done by this API (inversion, cross rates, rounding)"},"example":{"from":"USD","to":"JPY","date":"2026-11-05","amount":"100"},"coverage":{"source":"ECB euro foreign exchange reference rates","sourceUrl":"https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html","termsUrl":"https://www.ecb.europa.eu/services/using-our-site/disclaimer/html/index.en.html","termsCheckedOn":"2026-11-06","attributionRequired":"The ECB must be cited as the source; changes (inversion, cross rates, rounding, conversion) are stated; the original data is free from the ECB website.","processing":"Processing by this API (not published by the ECB): rates are the ECB euro reference rates, inverted (X to EUR = 1 / rate) and combined through EUR for cross rates, and the result is rounded to 10 significant digits; converted = amount x rate (the rounded rate), rounded half-up to 6 decimals.","baseCurrency":"EUR","currencies":["EUR","USD","JPY","CZK","DKK","GBP","HUF","PLN","RON","SEK","CHF","ISK","NOK","TRY","AUD","BRL","CAD","CNY","HKD","IDR","ILS","INR","KRW","MXN","MYR","NZD","PHP","SGD","THB","ZAR"],"currencyCount":30,"discontinuedCurrencies":{"BGN":{"lastPublished":"2025-12-31","note":"Bulgarian lev: removed from the ECB list with the 2026-01-02 publication (euro adoption); last publication date inferred as 2025-12-31 (the last TARGET day before)"},"HRK":{"lastPublished":"2022-12-30","note":"Croatian kuna: euro adopted on 2023-01-01; last publication 2022-12-30 (confirmed in the ECB API)"},"RUB":{"lastPublished":"2022-03-01","note":"Russian rouble: suspended by the ECB, last published 2022-03-01"}},"notSupported":"Pre-euro legacy currencies (e.g. CYP, EEK, LTL, LVL, MTL, SIT, SKK, ROL, TRL) are not supported.","firstDate":"1999-01-04","limits":{"amountMax":1000000000,"amountDecimals":6,"rateSignificantDigits":10},"rounding":"rate: 10 significant digits. converted: amount x (rounded) rate, rounded half-up to 6 decimals; convertedText is the exact decimal string.","publication":"The ECB publishes on TARGET business days (not weekends, Jan 1, Good Friday, Easter Monday, May 1, Dec 25, Dec 26) at about 16:00 CET. This API treats a day as published after 16:30 Europe/Berlin time.","freshness":"The returned date must be the expected publication date (the latest TARGET business day on or before the requested date that is already published). If upstream data is older than that, the call fails with 503 and is not charged. fallback:true only when the requested date was a weekend, TARGET holiday or not yet published.","notes":["Information only: the ECB strongly discourages using the reference rates for transactions.","404 means no rate is published for the currency on that date (for example a discontinued currency after its last publication date, or a date before the currency started). It is not charged.","Discontinued currencies (BGN, HRK, RUB) work for dates up to their last publication date; later dates and 'latest' return 404.","Upstream data is cached (edge cache about 1 hour for recent dates, 1 day for older dates; in-memory cache up to 10 minutes). Cached data always passes the freshness check."]},"dataRetention":"Requests and results are not stored by the application. The upstream request contains only currency codes and a date, never the amount. Usage records (request type, status, country, client category, product id, and for paid calls a keyed-hash buyer ID used only to count repeat purchases) are kept for up to about 91 days. No IP addresses."},{"id":"market-status","endpoint":"POST /v1/market/status","method":"POST","alsoSupported":["GET /v1/market/status"],"price":"$0.003","network":"eip155:8453","description":"Use when an agent must know if a stock market is open at a time: NYSE (XNYS), Nasdaq (XNAS), Tokyo Stock Exchange (XJPX). Regular trading hours only (no pre/after-hours): open, session (regular/lunch/closed), reason (weekend, holiday, early close), local time, next open/close. Built-in official calendars: XNYS 2026-28, XNAS 2026, XJPX 2026-27; other years get 400. No charge: 400, 405 other methods, 429; 502/503 not charged.","input":{"market":"string - XNYS = NYSE, XNAS = Nasdaq, XJPX = Tokyo Stock Exchange (case-insensitive).","at":"string - Optional ISO 8601 date-time with a time zone (e.g. 2026-11-27T13:00:00-05:00 or ...Z). Omit for now."},"inputFormat":["POST: JSON body","GET: query string"],"output":{"market":"string - Market identifier (MIC)","marketName":"string","open":"boolean - true only during the regular trading session (not lunch; pre-market and after-hours are not reported)","session":"string - regular = regular trading hours; lunch = Tokyo lunch break only; closed = any other time (including pre-market and after-hours)","reason":"string|null - weekend, holiday:<name>, early_close (an early-close day), lunch_break, outside_hours, or null during a normal regular session","at":"string - The instant evaluated (UTC)","localTime":"string - The instant in the market's local time with offset","timezone":"string - IANA time zone of the market","nextOpen":"string|null - Next start of a regular session after 'at' (local time); null if beyond the calendar","nextClose":"string|null - Next end of a regular session after 'at' (local time); null if beyond the calendar","source":"string - Calendar source and check date","calendarCheckedOn":"string - Date the calendar was checked against official pages","note":"string - Scope of the result: regular trading hours only"},"example":{"market":"XNYS","at":"2026-11-27T13:00:00-05:00"},"coverage":{"markets":[{"id":"XNYS","name":"New York Stock Exchange","timezone":"America/New_York","supportedYears":[2026,2027,2028],"source":"NYSE Holidays & Trading Hours (https://www.nyse.com/trade/hours-calendars), checked 2026-11-06","checkedOn":"2026-11-06","note":"Regular trading hours only (09:30-16:00 ET; 13:00 close on early-close days). Pre-market and after-hours sessions are not reported: they differ by venue and security, so session is only regular or closed."},{"id":"XNAS","name":"Nasdaq","timezone":"America/New_York","supportedYears":[2026],"source":"Nasdaq Trader Trading Calendar (https://www.nasdaqtrader.com/Trader.aspx?id=Calendar), checked 2026-11-06","checkedOn":"2026-11-06","note":"Only 2026 is covered: Nasdaq's official calendar did not list 2027. Regular trading hours only (09:30-16:00 ET; 13:00 ET close on the early-close days listed by Nasdaq). Pre-market and after-hours sessions are not reported."},{"id":"XJPX","name":"Tokyo Stock Exchange","timezone":"Asia/Tokyo","supportedYears":[2026,2027],"source":"JPX Business hours and market holidays (https://www.jpx.co.jp/corporate/about-jpx/calendar/index.html) and JPX trading hours (https://www.jpx.co.jp/equities/trading/domestic/01.html), checked 2026-11-06","checkedOn":"2026-11-06","note":"Regular trading hours only: 09:00-11:30 and 12:30-15:30 JST with a lunch break (session: regular or lunch); closed on weekends, holidays and Dec 31 / Jan 1-3. Closure dates match the JPX official list (all 2026 and 2027 dates); the Cabinet Office list was used as a cross-check."}],"notes":["Calendars are tables copied from official announcements, not guesses. A year that is not in the table returns 400 (unsupported), never a guess.","Regular trading hours only: session is regular, lunch (Tokyo only) or closed. Pre-market and after-hours sessions are NOT reported (they differ by venue and security), so closed does not mean no trading anywhere.","Early-close end times are the values in the official calendars (13:00 ET on the listed US days). Unscheduled closures (outages, emergencies, schedule changes after the check date) are not reflected.","No external requests are made: results come from built-in tables."]},"dataRetention":"Requests and results are not stored by the application. Usage records (request type, status, country, client category, product id, and for paid calls a keyed-hash buyer ID used only to count repeat purchases) are kept for up to about 91 days. No IP addresses."}],"notice":"Results are returned only in the paid response and cannot be re-delivered later. In rare cases outside our control (for example, the payment processor's reply is lost after the payment has settled), the payment may complete without a result reaching you. We cannot detect this automatically and do not re-send results. Validation is deterministic, so you can check the outcome on-chain and decide whether to retry."}