# 1gateway

> 1gateway — Pay-per-call API gateway for AI agents (x402, USDC on Base or Solana). Data APIs normalized to English JSON; every data endpoint is paid per request with USDC via the x402 protocol (network eip155:8453 or solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). Pay with USDC on Base or Solana mainnet, same price; the 402 lists both. No account or API key needed: request → HTTP 402 → pay → retry.

Current coverage: Korean data (real estate trades from MOLIT, Korea Customs export/import statistics, Bank of Korea ECOS statistics, KMA weather forecasts, KASI holidays) and agent utilities: document → Markdown (web pages, PDF, DOCX, Korean HWP/HWPX), URL metadata, domain lookup, ECB FX rates, time-zone conversion. More APIs and countries are coming.

## Paid endpoints

- [Korean company due-diligence report in English: profile, registration, procurement, sanctions, recent DART filings and risk in one brief](https://1gateway.dev/v1/kr/company/report?q=삼성전자&business_number=1248100998&stock_code=005930&dart_corp_code=00126380&format=json&news=true): $0.50 per call. Use when an agent needs a finished English due-diligence brief on a South Korean company. Input: one of business_number, dart_corp_code, stock_code or q (exact name); format=json|markdown; news=true|false. Output: JSON with executiveSummary, businessOverview, financialHighlights (each figure source-checked), procurementActivity, recentEvents (DART, 90 days), riskAssessment, sanctionsResult, dataGaps, sources. AI-written; not advice. Example: ?stock_code=005930
  - `q`: Company name (Korean or English), matched exactly after removing legal-form words
  - `business_number`: Business registration number (사업자등록번호), 10 digits
  - `stock_code`: KRX stock code
  - `dart_corp_code`: OpenDART corp_code (8 digits)
  - `format`: markdown adds a readable English Markdown rendering of the same report
  - `news`: Include up to 5 recent third-party news headlines (default true)
- [Korea apartment sale transactions (MOLIT) — English JSON with KRW & USD](https://1gateway.dev/v1/realestate/apartment-trades?region=11680&month=202609): $0.0045 per call. Use when you need actual apartment sale prices in a South Korean district for a month (property research, valuation, comps). Data: MOLIT (Korea land ministry) reported deals since 2006, updated daily. Input: region (5-digit LAWD_CD, e.g. 11680 Gangnam-gu), month (YYYYMM). Output: JSON trades with contract date, complex (Korean + romanized), area m2, floor, build year, price in KRW and USD, price per m2, deal type, cancelled flag. Example: ?region=11680&month=202609
  - `region` (required): 5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu, 11110 = Jongno-gu, 41135 = Seongnam Bundang-gu. Unknown codes → 400 (not charged).
  - `month` (required): Contract month YYYYMM, 200601 to the current month (KST)
- [Korea apartment price summary for a district-month (count, median/avg price and price per m²)](https://1gateway.dev/v1/realestate/apartment-trades/summary?region=11680&month=202609): $0.0045 per call. Use when you need a quick housing-market snapshot for a South Korean district-month instead of raw trades. Data: MOLIT reported apartment sales, cancelled deals excluded. Input: region (5-digit LAWD_CD, e.g. 11680), month (YYYYMM). Output: JSON count, median/average/min/max price and price per m2 and per pyeong in KRW and USD, breakdown by size class, top complexes by volume. Example: ?region=11680&month=202609
  - `region` (required): 5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu. Unknown codes → 400 (not charged).
  - `month` (required): Contract month YYYYMM, 200601 to the current month (KST)
- [Bank of Korea ECOS statistics (BOK-authored series only) with attribution](https://1gateway.dev/v1/macro/ecos?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000): $0.0045 per call. Use when you need official Bank of Korea statistics (base rate, money supply, key indicators) as a time series. Input: stat (ECOS table code, e.g. 722Y001), cycle (A/S/Q/M/SM/D), start, end (period format of cycle), optional item (e.g. 0101000). Output: JSON series with English labels, units, observations [{period,value}] (max 1,000 rows) and source attribution. Only BOK-authored tables are served. Example: ?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000
  - `stat` (required): ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged).
  - `cycle` (required): A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily
  - `start` (required): Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)
  - `end` (required): End period, same format as start
  - `item`: Item code 1 (e.g. 0101000). Optional item2..item4 also accepted.
- [Korea short-term weather forecast (KMA) by latitude/longitude](https://1gateway.dev/v1/weather/forecast?lat=37.5665&lon=126.978): $0.0045 per call. Use when you need the official weather forecast for a point in South Korea for the next ~3-5 days. Data: KMA (Korea Meteorological Administration) village forecast on a 5 km grid, issued 8 times a day. Input: lat, lon (WGS84 decimal; Korea only). Output: JSON hourly then 3-hourly temperature C, sky, precipitation type and probability %, rain and snow amounts, humidity %, wind; plus daily min/max. Example: ?lat=37.5665&lon=126.978
  - `lat` (required): Latitude, WGS84 decimal degrees (KMA domain ≈ 32–44; outside → 400, not charged)
  - `lon` (required): Longitude, WGS84 decimal degrees (KMA domain ≈ 123–133)
- [Korean public holidays for a year (KASI): South Korea holiday calendar with English names](https://1gateway.dev/v1/calendar/holidays?year=2026): $0.0027 per call. Use when you need South Korea's official public holidays for a year (business-day calculation, scheduling, settlement and payroll calendars). Data: KASI (Korea Astronomy and Space Science Institute) special-day register, incl. substitute and temporary holidays once promulgated. Input: year (YYYY, 2004-2100). Output: JSON list with date, weekday, Korean and English name, isPublicHoliday, kind. Example: ?year=2026
  - `year` (required): Year YYYY (2004–2100)
- [Korea 10-day export flash (Korea Customs): totals, YoY, top items and markets](https://1gateway.dev/v1/trade/exports/10day?month=202609&period=full): $0.0045 per call. Use when you need South Korea's earliest export read: the Korea Customs 10-day provisional release (days 1-10, 1-20, full month; out on the 11th, 21st and 1st). Input: optional month (YYYYMM) and period (10, 20, full); default latest. Output: JSON exports in USD with YoY %, latest 10-day increment, 10 key items (semiconductors, cars, ships...) and 10 markets (China, US, EU, Vietnam...) with YoY and share, next release date. Example: ?month=202609
  - `month`: Release month YYYYMM (default: latest release; data from 2024-09)
  - `period`: 10 (days 1-10), 20 (days 1-20) or full; requires month. Default: latest available for the month
- [Korea monthly exports/imports by HS code (Korea Customs), English HS descriptions, YoY](https://1gateway.dev/v1/trade/hs?hs=8542&month=202608&limit=20&sort=exports): $0.0045 per call. Use when you need South Korea's monthly trade for a product by HS code (e.g. 8542 chips, 870323 cars, 2710 petroleum). Data: Korea Customs Service, finalized monthly. Input: hs (2-10 digit prefix), optional month (YYYYMM, default latest), limit (1-100), sort (exports, imports, balance, total). Output: JSON totals (exports FOB, imports CIF, balance in USD, kg) with YoY % and 10-digit HSK lines with English HS descriptions and YoY. Example: ?hs=8542&month=202608
  - `hs` (required): HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)
  - `month`: Month YYYYMM (default: latest finalized month)
  - `limit`: Max 10-digit lines returned (1-100, default 20)
  - `sort`: Line order (default exports)
- [Korea Trade Pulse: latest export flash, 12-month trend and semiconductor detail in one call](https://1gateway.dev/v1/trade/pulse?): $0.0045 per call. Use when you need a one-call read on South Korea's export cycle for macro, FX or chip-sector analysis. Data: Korea Customs 10-day and monthly releases. Input: none. Output: JSON headline (latest exports and YoY, semiconductor share, strongest/weakest item and market, 3-month average YoY, momentum), latest release by item and market, 12 monthly export totals with YoY, and HS 8542 integrated-circuit trade for the latest month. Example: /v1/trade/pulse
- [Korean company resolver: name, business number or stock code to one stable company_id](https://1gateway.dev/v1/kr/company/resolve?q=삼성전자&business_number=1248100998&stock_code=005930&dart_corp_code=00126380): $0.002 per call. Use when an agent must identify a South Korean company before looking up its profile or public-procurement record. Input: one of business_number (10 digits), dart_corp_code, stock_code (KRX, e.g. 005930) or q (company name, exact match ignoring 주식회사/(주)/spacing); first wins. Output: JSON companies with stable companyId, Korean and English names, stock code, DART code, match type, ambiguous flag. Data: OpenDART, KONEPS. Example: ?stock_code=005930
  - `q`: Company name (Korean or English), matched exactly after removing legal-form words
  - `business_number`: Business registration number (사업자등록번호), 10 digits
  - `stock_code`: KRX stock code
  - `dart_corp_code`: OpenDART corp_code (8 digits)
- [Korean company profile: DART registry data joined with its public-procurement vendor record](https://1gateway.dev/v1/kr/company?id=kr-dart-00126380): $0.0045 per call. Use when an agent needs a normalized profile of a South Korean company for KYB, research or sales. Input: id (companyId from /v1/kr/company/resolve). Output: JSON profile: names, business/corporate/DART/stock ids, market, KSIC code, founding date, fiscal year end, address, homepage, KONEPS supplier registration. No CEO names. DART data is a weekly snapshot of KRX-listed companies (asOf in response). Data: OpenDART, KONEPS. Example: ?id=kr-dart-00126380
  - `id` (required): companyId from /v1/kr/company/resolve
- [Korean company public-procurement awards: every KONEPS contract it won, with totals and top agencies](https://1gateway.dev/v1/kr/company/procurement?id=kr-dart-00126380&business_number=1248100998&from=2026-01-01&to=2026-10-19&category=goods,services&min_amount=10000000&limit=50&offset=0): $0.009 per call. Use when an agent needs a South Korean company's government contract wins for sales, credit or competitor research. Input: id (companyId) or business_number; optional from/to (YYYY-MM-DD, max 366 days, default last 12 months), category (goods,works,services,foreign), min_amount, limit, offset. Output: JSON summary (award count, total and largest KRW, top agencies) and awards with title, agency, amount, date. Data: KONEPS. Example: ?id=kr-dart-00126380
  - `id`: companyId from /v1/kr/company/resolve; give id or business_number
  - `business_number`: Business registration number; give id or business_number
  - `from`: Bid opening date from (default: 365 days before to)
  - `to`: Bid opening date to (default: today)
  - `category`: Comma list of goods, works, services, foreign (default all)
  - `min_amount`: Only awards of at least this many KRW
  - `limit`: Awards per page (default 50)
  - `offset`: Paging offset (from page.nextOffset)
- [Korean business registration status (NTS): active, suspended or closed, VAT type, closure date](https://1gateway.dev/v1/kr/business/status?b_no=1248100998): $0.002 per call. Use when an agent must check that a South Korean business is still operating before paying, contracting or onboarding it (KYB, invoice checks). Input: b_no (1-20 business registration numbers, comma-separated, hyphens ok). Output: JSON per number: status (active, suspended, closed, unregistered), VAT taxpayer type, closure date, tax-type change and e-invoice dates, companyId. Data: National Tax Service, synced every 30 min. Example: ?b_no=1248100998
  - `b_no` (required): Business registration numbers (사업자등록번호), 10 digits each, comma-separated (max 20); invalid check digit → 400, not charged
- [Korean address lookup: official road-name address, English address and postal code](https://1gateway.dev/v1/kr/address?q=테헤란로 152&limit=3): $0.002 per call. Use when an agent must normalize or translate a South Korean address (shipping, checkout, KYC forms). Input: q (Korean address or part of one, e.g. road name + number or neighborhood + lot number), optional limit (1-5). Output: JSON matches with official road-name and lot-number addresses in Korean and English, postal code, building name, admin and road codes. Data: Ministry of the Interior road-name address API. Example: ?q=테헤란로 152
  - `q` (required): Korean address or part of it (2+ chars; at most 40 Korean characters; no SQL words or % = > < [ ]); bad input → 400, not charged
  - `limit`: Matches returned (default 3)
- [Korean DART filings: recent major disclosures for a company or a day, with English type labels](https://1gateway.dev/v1/kr/filings?corp=005930&q=삼성전자&date=2026-10-23&days=90&limit=20): $0.0045 per call. Use when an agent needs recent material disclosures of a South Korean listed company (rights offerings, CBs, buybacks, M&A, litigation, earnings, periodic reports). Input: corp (DART corp_code, KRX stock code or kr-dart- id) or q (exact name), optional days (1-365, default 30); or date (YYYY-MM-DD, KST). Output: JSON list with rceptNo, date, Korean title, English type label, DART link. Summaries: /v1/kr/filings/summary. Example: ?corp=005930&days=90
  - `corp`: DART corp_code (8 digits), KRX stock code (6 characters) or kr-dart-<corp_code>
  - `q`: Company name (Korean or English), matched exactly after removing legal-form words
  - `date`: Receipt date (KST); with corp, only that day
  - `days`: Look-back window for corp/q (default 30)
  - `limit`: Max filings returned (default 20)
- [English summary of a Korean DART filing: what happened, key figures, parties, dates](https://1gateway.dev/v1/kr/filings/summary?rcept_no=20261023000123): $0.02 per call. Use when an agent needs a Korean corporate disclosure in English. Input: rcept_no (14-digit DART receipt number from /v1/kr/filings). Output: JSON with headline, what_happened, key_figures (amounts, ratios, share counts with units), parties, key_dates, why_it_matters, confidence, original Korean title and DART link. Machine-generated paraphrase, not the official text. Unknown rcept_no or model outage is refused before payment. Example: ?rcept_no=20261023000123
  - `rcept_no` (required): DART receipt number (14 digits)
- [Korea company KYB / Korean supplier check: identity, NTS business status, DART profile, public-procurement record and sanctions in one call](https://1gateway.dev/v1/kr/supplier/check?q=삼성전자&business_number=1248100998&stock_code=005930&dart_corp_code=00126380): $0.015 per call. Use when an agent must vet a South Korean supplier or counterparty before paying, contracting or onboarding it. Input: one of business_number, dart_corp_code, stock_code or q (exact company name). Output: JSON summary (riskLevel, riskFlags such as closed/suspended or sanctions match, per-section status) plus NTS status, DART profile, 12-month KONEPS award summary and OFAC/EU/UK screening of the English name. Not a legal determination. Example: ?stock_code=005930
  - `q`: Company name (Korean or English), matched exactly after removing legal-form words
  - `business_number`: Business registration number (사업자등록번호), 10 digits
  - `stock_code`: KRX stock code
  - `dart_corp_code`: OpenDART corp_code (8 digits)
- [URL metadata / link preview: title, description, Open Graph, Twitter card, icons, feeds, JSON-LD](https://1gateway.dev/v1/web/metadata?url=https://developer.mozilla.org/en-US/): $0.002 per call. Use when an agent needs to know what a URL is before reading it, or to build a link preview or citation. Input: url (public http/https). Output: JSON with final URL after redirects, HTTP status, content type, title, description, site name, language, canonical, preview image, favicon, Open Graph and Twitter tags, RSS/Atom feeds, hreflang alternates, JSON-LD types, robots, first H1. No JavaScript is run. Example: ?url=https://developer.mozilla.org/en-US/
  - `url` (required): Public http(s) URL; private/internal addresses → 400 (not charged)
- [Domain lookup: DNS records, mail provider, SPF/DMARC, RDAP registrar, creation/expiry dates](https://1gateway.dev/v1/domain/lookup?domain=google.com): $0.0045 per call. Use when an agent must check a domain: does it resolve, who hosts its DNS and mail, is email authenticated, how old is it, when does it expire. Input: domain (e.g. example.com; URLs accepted). Output: JSON DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA, SOA), mail provider, parsed SPF and DMARC, DNS provider, and RDAP registration (registrar, created, expires, age in days, status, DNSSEC). No contact data. Example: ?domain=google.com
  - `domain` (required): Public domain or hostname (punycode for IDNs, e.g. xn--...); a URL is reduced to its hostname. Internal/reserved names → 400 (not charged)
- [FX reference rates (ECB): 30 currencies incl. KRW, any base, conversion, last 90 days](https://1gateway.dev/v1/fx/rates?base=USD&symbols=KRW,JPY,EUR&date=2026-10-09&amount=100): $0.002 per call. Use when you need an official daily FX rate or currency conversion (USD, EUR, KRW, JPY, CNY, GBP + 24 more). Input: base (default EUR), optional symbols (comma list), date (YYYY-MM-DD, last ~90 days; weekends use the prior fixing), amount. Output: JSON rates for the fixing date, % change vs prior fixing, converted amounts, raw ECB EUR rates. Source: ECB statistics, updated each TARGET day ~16:00 CET; reference only. Example: ?base=USD&symbols=KRW,JPY&amount=100
  - `base`: Base currency, ISO 4217 (one of the 30 ECB reference currencies; default EUR)
  - `symbols`: Comma-separated target currencies (default: all). Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR
  - `date`: Fixing date YYYY-MM-DD within the last ~90 days (default latest)
  - `amount`: Amount in base currency to convert
- [Currency conversion (ECB): amount from one currency into up to 10, any date since 1999](https://1gateway.dev/v1/fx/convert?from=USD&to=KRW,JPY&amount=250&date=2025-06-30): $0.002 per call. Use when you need to convert an amount between currencies (USD↔KRW, EUR→JPY, ...) at the official ECB reference rate, today or on a past date. Input: from, to (1–10 comma-separated), amount (default 1), optional date (YYYY-MM-DD since 1999-01-04; weekends use the prior fixing). Output: JSON per target rate, inverse rate and converted result, the fixing date used. Source: ECB statistics; reference only. Example: ?from=USD&to=KRW,JPY&amount=250
  - `from` (required): Source currency, ISO 4217 (one of the 30 ECB reference currencies)
  - `to` (required): 1–10 comma-separated target currencies. Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR
  - `amount`: Amount in the source currency (default 1)
  - `date`: Fixing date YYYY-MM-DD from 1999-01-04 (default latest)
- [FX history (ECB): daily rate series for up to 10 currencies, any base, up to 366 days, with stats](https://1gateway.dev/v1/fx/history?symbols=KRW,JPY&base=USD&start=2026-07-01&end=2026-09-30): $0.002 per call. Use when you need a historical exchange-rate series or a period summary (e.g. USD/KRW over the last quarter). Input: symbols (1–10), base (default EUR), start and end (YYYY-MM-DD since 1999-01-04; default last 30 days; max 366 days). Output: JSON daily series of ECB fixings, and per currency first/last, % change, min/max with dates, average and daily volatility. Source: ECB statistics; reference only. Example: ?base=USD&symbols=KRW,JPY&start=2026-07-01&end=2026-09-30
  - `symbols` (required): 1–10 comma-separated currencies. Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR
  - `base`: Base currency (default EUR)
  - `start`: Start date YYYY-MM-DD (default end minus 30 days; earliest 1999-01-04)
  - `end`: End date YYYY-MM-DD (default today; range ≤ 366 days)
- [Time-zone conversion: one instant in many zones, DST-aware, offsets, business hours](https://1gateway.dev/v1/time/convert?to=America/New_York,Europe/London&from=Asia/Seoul&time=2026-10-12T09:00): $0.002 per call. Use when scheduling across time zones or turning a local time into UTC without guessing DST. Input: to (IANA zones or KST, PST, CET...), optional from (zone of a local time, default UTC), time (ISO 8601, Unix seconds, or now). Output: JSON UTC instant, Unix time, and per zone: local ISO time with offset, weekday, abbreviation, DST and business-hours flags, day difference. Example: ?time=2026-10-12T09:00&from=Asia/Seoul&to=America/New_York,Europe/London
  - `to` (required): 1–25 target zones, comma-separated (IANA names like Asia/Seoul, UTC, or abbreviations like KST, PST, CET)
  - `from`: Zone of the input local time (default UTC; ignored when time has an offset)
  - `time`: ISO 8601 date-time (2026-10-12T09:00, 2026-10-12T09:00:00+09:00), Unix seconds/ms, or now
- [Meeting time finder: working-hour overlap across time zones, ranked slots, DST-aware](https://1gateway.dev/v1/time/overlap?zones=America/New_York,Europe/London,Asia/Seoul&date=2026-11-03&work_start=09:00&work_end=18:00&include_weekends=false): $0.002 per call. Use when scheduling a meeting across time zones. Input: zones (2-10, IANA or KST/PST/CET), date, work_start/work_end (default 09:00-18:00), include_weekends. Output: JSON overlap windows in UTC and every zone's local time, top 3 one-hour slots ranked by distance from each zone's day edges, partial windows when no full overlap, next DST change per zone. Example: ?zones=America/New_York,Europe/London,Asia/Seoul&date=2026-11-03
  - `zones` (required): 2–10 time zones, comma-separated; the first is the anchor whose local date is scanned
  - `date`: Meeting date YYYY-MM-DD in the anchor zone (default today UTC)
  - `work_start`: Local start of working hours, HH:MM
  - `work_end`: Local end of working hours, HH:MM
  - `include_weekends`: Count Saturday/Sunday as working days
- [Business-day calculator: add or count working days, skipping weekends and public holidays (KR, US, GB, DE, FR, JP)](https://1gateway.dev/v1/time/business-days?start=2026-12-22&days=5&end=2027-01-15&country=US): $0.003 per call. Use when computing due dates, SLAs, settlement or delivery dates. Input: start date, then days (add -260..260 business days) or end (count business days between), optional country KR, US, GB, DE, FR or JP for public holidays (omit = weekends only). Output: JSON result date or business/calendar day counts, holidays skipped on the way, holiday scope. Example: ?start=2026-12-22&days=5&country=US
  - `start` (required): Start date YYYY-MM-DD (2004–2099)
  - `days`: Business days to add (negative = go back); give days or end (days wins if both)
  - `end`: Count business days from start (excluded) to end (included), at most 2 years apart; ignored when days is given
  - `country`: Public holiday calendar (omit for weekends only)
- [Site profile: page metadata + security headers + robots/llms.txt + DNS, mail auth and domain age in one call](https://1gateway.dev/v1/web/site-profile?url=stripe.com): $0.009 per call. Use when an agent must vet or research a website in one call (lead research, security or SEO check, is this site legit). Input: url or bare domain. Output: JSON page metadata, HTTP status, HTTPS and HTTP-to-HTTPS redirect, server and hosting hints, 7 security headers, robots.txt (sitemaps, AI-crawler rules), llms.txt presence, plus domain DNS, mail provider, SPF/DMARC and RDAP registrar, age and expiry. Example: ?url=stripe.com
  - `url` (required): Site URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)
- [Base gas and fee estimate: base fee, priority tiers, cost per action in ETH and USD](https://1gateway.dev/v1/onchain/base/gas?): $0.002 per call. Use when an agent must price or time a Base transaction. Input: none. Output: JSON current and next base fee, priority fee tiers (slow/standard/fast from the last 20 blocks), suggested maxFeePerGas, block fullness, and typical cost of an ETH transfer, ERC-20 transfer/approve, DEX swap, NFT mint and contract deploy (L2 fee + L1 data fee) in ETH and USD. Example: /v1/onchain/base/gas
- [DeFi lending yields and market TVL on Base: Aave v3, Compound v3, Morpho, Moonwell](https://1gateway.dev/v1/defi/yields?protocol=aave-v3,morpho&asset=USDC): $0.0045 per call. Use when an agent must compare lending yields on Base. Input: optional protocol (aave-v3,compound-v3,morpho,moonwell) and asset (USDC,WETH,cbBTC,wstETH,cbETH,EURC). Output: JSON per market supply/borrow APY, utilization, supplied/borrowed amount and TVL in USD, sorted by supply APY, with block. Computed from contract state; base rates, rewards excluded; not advice. Example: ?asset=USDC
  - `protocol`: Comma list of aave-v3, compound-v3, morpho, moonwell (default all). Bad value → 400 before payment (not charged)
  - `asset`: Comma list of USDC, WETH (or ETH), cbBTC, wstETH, cbETH, EURC (default all). Bad value → 400 before payment (not charged)
- [Worldwide weather forecast: current, hourly (72 h) and 10-day daily for any coordinates](https://1gateway.dev/v1/weather/global?lat=51.5072&lon=-0.1276&hours=24&tz=Europe/London): $0.002 per call. Use when an agent needs the weather anywhere in the world. Input: lat, lon, optional hours (0-72 hourly steps, default 24), tz (IANA zone for daily summaries, default UTC). Output: JSON current temperature, symbol, wind, humidity, cloud, pressure; hourly series; daily min/max, precipitation, max wind, symbol for ~10 days. Data: MET Norway. Example: ?lat=51.5072&lon=-0.1276&tz=Europe/London
  - `lat` (required): Latitude, WGS84 decimal degrees (rounded to 0.01)
  - `lon` (required): Longitude, WGS84 decimal degrees (rounded to 0.01)
  - `hours`: Hourly steps to return (default 24)
  - `tz`: IANA time zone for daily summaries and local hours (default UTC)
- [Open-source package vulnerabilities: package@version to CVEs, severity, fixed versions](https://1gateway.dev/v1/dev/vulnerabilities?package=lodash&ecosystem=npm&version=4.17.15): $0.003 per call. Use when an agent must check a dependency before installing or upgrading: is this exact package version vulnerable? Input: package, ecosystem (npm, PyPI, Go, Maven, crates.io, NuGet, RubyGems, Packagist...), version. Output: JSON vulnerable yes/no, counts by severity, advisories (GHSA/CVE id, summary, severity, CVSS, CWE, fixed versions, links). Data: OSV.dev. Example: ?package=lodash&ecosystem=npm&version=4.17.15
  - `package` (required): Package name as in its registry (Go: module path; Maven: group:artifact)
  - `ecosystem` (required): Package ecosystem (case-insensitive; pip/python, cargo/rust, composer, gem also accepted)
  - `version` (required): Exact released version
- [OFAC sanctions name search: people, companies, vessels on the U.S. SDN list](https://1gateway.dev/v1/compliance/sanctions?name=Lazarus Group&type=entity&min_score=0.85&limit=10&lists=ofac): $0.0045 per call. Use when an agent must check a person, company, vessel or aircraft against the U.S. Treasury OFAC SDN list before paying, onboarding or shipping. Input: name (fuzzy, aliases included), optional type, min_score, limit. Output: JSON potential matches with score, SDN entry, programs, countries, aliases, OFAC link, list as-of date, data age. Not a legal determination. Example: ?name=Lazarus+Group
  - `name` (required): Person, company, vessel or aircraft name in Latin script; fuzzy match over SDN names and aliases
  - `type`: Only match this SDN entry type
  - `min_score`: Name match threshold 0.6-1 (default 0.85)
  - `limit`: Max matches (default 10)
  - `lists`: Lists to search: ofac (default), eu, uk, comma-separated, or all
- [KYB check: sanctions (OFAC, EU, UK) + LEI identity + EU VAT validation in one call](https://1gateway.dev/v1/kyb/check?name=Siemens AG&country=DE&lei=W38RGI023J3WT1HWRP32&vat=DE129273398): $0.02 per call. Use when an agent must vet a company or counterparty before paying, onboarding or invoicing. Input: name, optional country (ISO2), lei, vat (EU, with prefix). Output: JSON summary (sanctions hits, LEI found/status, VAT valid), sanctions matches across OFAC SDN, EU and UK lists, GLEIF entity record with parents, VIES VAT result; a down VIES/GLEIF marks only that part. Not a legal determination. Example: ?name=Siemens+AG&lei=W38RGI023J3WT1HWRP32&vat=DE129273398
  - `name` (required): Company or person name in Latin script
  - `country`: ISO 3166-1 alpha-2 country of the legal address (narrows the LEI search)
  - `lei`: Legal Entity Identifier, if known (exact LEI lookup instead of name search)
  - `vat`: EU VAT number with country prefix (Greece = EL), validated in VIES
- [OFAC sanctions wallet check: crypto address against the U.S. SDN list](https://1gateway.dev/v1/compliance/sanctions/address?address=0x098B716B8Aaf21512996dC57EB0615e2383E2f96&chain=base): $0.0045 per call. Use when an agent must check a crypto wallet against the digital currency addresses on the U.S. Treasury OFAC SDN list before paying or accepting funds. Input: address (EVM matched on every EVM chain; BTC, TRX, SOL...), optional chain. Output: JSON listed yes/no, SDN entry, programs, listed currency and network, OFAC link, list as-of date, data age. Not a legal determination. Example: ?address=0x098B716B8Aaf21512996dC57EB0615e2383E2f96
  - `address` (required): Crypto address to check (0x… EVM, BTC, TRX, SOL, …)
  - `chain`: Optional chain (ethereum, base, bitcoin, tron, solana, …): checks the address format and marks listings on that network
- [OFAC wallet screening in bulk: up to 50 crypto addresses (EVM, BTC, TRX, SOL, …) in one call](https://1gateway.dev/v1/compliance/sanctions/address/batch?addresses=0x098B716B8Aaf21512996dC57EB0615e2383E2f96,TNiq9AXBp9EjUqhDhrwrfvAA8U3GUQZH81): $0.01 per call. Use when an agent must screen many wallets at once (payouts, counterparty lists) against OFAC SDN wallet addresses. Input: addresses (1-50, comma-separated, mixed chains) or POST JSON {addresses:[...]}. Output: per address listed yes/no, detected chains, SDN entity, programs; summary counts; list date. Unknown formats refused before payment. Not a legal determination. Example: ?addresses=0x098B716B8Aaf21512996dC57EB0615e2383E2f96,TNiq9AXBp9EjUqhDhrwrfvAA8U3GUQZH81
  - `addresses` (required): 1-50 crypto addresses, comma-separated (0x… EVM, BTC, TRX, SOL, LTC, XMR, …)
- [OFAC transaction screening: every party of a Base (or Solana) transaction against the SDN wallet list](https://1gateway.dev/v1/compliance/sanctions/tx?tx=0xffbd4c3a5ee9a8d1d4c52a5a0e0f6f0b6a9c1a8f3e2d1c0b9a8f7e6d5c4bbe32&network=eip155:8453): $0.009 per call. Use when an agent must check a transaction before accepting or relaying funds: screens its direct parties (sender, recipient, contracts, token Transfer parties on Base; accounts and token owners on Solana) against OFAC SDN wallet addresses. Input: tx, network (eip155:8453 default, or solana). Output: verdict, parties, roles, listed yes/no, SDN entity, programs, tx status, list date. Bad formats refused before payment. Not a legal determination. Example: ?tx=0x…
  - `tx` (required): Transaction hash (0x…, Base) or signature (base58, Solana)
  - `network`: Network (default eip155:8453 = Base)
- [SEC EDGAR filings: 10-K, 10-Q, 8-K and more for any U.S.-listed company by ticker or CIK](https://1gateway.dev/v1/filings/us?ticker=AAPL&cik=320193&form=10-K,8-K&since=2026-01-01&limit=20): $0.0027 per call. Use when an agent needs a U.S. public company's SEC filings: latest 10-K/10-Q, 8-K events, proxies, S-1s. Input: ticker or cik, optional form (comma list, e.g. 10-K,8-K), since (YYYY-MM-DD), limit. Output: JSON company profile (CIK, name, industry, exchange, fiscal year end) and filings with dates, 8-K item codes and titles, XBRL flags, sec.gov links. Insider forms without filer names. Data: SEC EDGAR. Example: ?ticker=AAPL&form=10-K,8-K
  - `ticker`: U.S. ticker (AAPL, BRK.B); give ticker or cik
  - `cik`: SEC Central Index Key (e.g. 320193); give ticker or cik
  - `form`: Only these form types, comma-separated (10-K, 10-Q, 8-K, DEF 14A, S-1, 4, 13F-HR…)
  - `since`: Only filings on or after this date (YYYY-MM-DD)
  - `limit`: Max filings (default 20)
- [Web search for agents: Google results as clean JSON (title, URL, date)](https://1gateway.dev/v1/web/search?q=x402 payment protocol&max=5&time_range=month): $0.006 per call. Use when an agent needs current web results for a query. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results with title, URL and date when known, provider and retrieval time. For page text use /v1/web/search-read. Provider failure is not charged. Example: ?q=x402+payment+protocol&max=5
  - `q` (required): Search query
  - `max`: Number of results (default 5)
  - `time_range`: Only results from the past day, week, month or year
- [Web search + read: top results with page text as Markdown](https://1gateway.dev/v1/web/search-read?q=x402 payment protocol&max=5&time_range=month): $0.02 per call. Use when an agent needs to search and read in one call. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results (title, URL, date) and, for the top 3, the page converted to Markdown (up to 4,000 characters each; a page that fails is marked, the rest still ship). Provider failure is not charged. Example: ?q=EU+AI+Act+timeline&max=5
  - `q` (required): Search query
  - `max`: Number of results (default 5)
  - `time_range`: Only results from the past day, week, month or year
- [Web answer with citations: search, read the top pages, answer in JSON with source quotes](https://1gateway.dev/v1/web/answer?q=x402 payment protocol&time_range=month): $0.012 per call. Use when an agent needs a sourced answer to a question from the live web in one call. Input: q (question), optional time_range (day, week, month, year). Output: JSON answer (English, inline [n] citations), citations [{url, title, quote}], confidence, notes, sources read. Searches, reads the top 4 pages itself and answers only from them. Provider or model failure is not charged. Example: ?q=what+is+the+x402+payment+protocol
  - `q` (required): Search query
  - `time_range`: Only results from the past day, week, month or year
- [News brief: topic news clustered and deduplicated, English summaries with source links (strong on Korea / Asia)](https://1gateway.dev/v1/news/brief?topic=korea semiconductor exports&time_range=week&max=10): $0.007 per call. Use when an agent needs what is happening on a topic right now, in English, including Korean and Asian news. Input: topic, optional time_range (day, week default, month, year), max (1-10 headlines, default 10). Output: JSON overview, clusters [{headline, summary, sources}] with duplicates merged, and sources (title, url, outlet, publishedAt). Headlines and links only. Failures not charged. Example: ?topic=korea+semiconductor+exports
  - `topic` (required): News topic (any language)
  - `time_range`: Window (default week)
  - `max`: Headlines considered (default 10)
- [Web extract: any web page into JSON matching your own JSON Schema](https://1gateway.dev/v1/web/extract?url=https://example.com/&schema={"type":"object","properties":{"title":{"type":"string"},"links":{"type":"array","items":{"type":"string"}}},"required":["title"]}): $0.006 per call. Use when an agent needs specific fields from a web page as JSON. Input: url, schema (URL-encoded JSON Schema, object root, max 30 properties, depth 3, 3,000 chars). Output: JSON data validated against the schema (null when not on the page), title, finalUrl. SSRF-safe; noai pages refused; bad schema refused before payment. Fixed schema: /v1/docs/extract. Example: ?url=https://example.com/&schema={"type":"object","properties":{"title":{"type":"string"}}}
  - `url` (required): Public http(s) web page URL
  - `schema` (required): JSON Schema (object root) describing the fields to extract
- [Website audit: security headers, HTTPS/HSTS, SEO meta, SPF/DMARC and AI-readiness with scores and fixes](https://1gateway.dev/v1/web/audit?url=stripe.com): $0.006 per call. Use when an agent must grade a website and say what to fix. Input: url or bare domain. Output: JSON score 0-100, grade A-F, per-category scores (security, https, seo, mail, ai), findings [{id, severity, category, title, fix}] and top fixes. Rule-based from one live fetch plus DNS; raw data: /v1/web/site-profile. Example: ?url=stripe.com
  - `url` (required): Site URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)
- [Korea policy feed in English: latest government policy and legislative notices with English briefs](https://1gateway.dev/v1/kr/policy/latest?q=AI&date=2026-10-27&limit=5): $0.0045 per call. Use when an agent tracks South Korean government policy, regulation or draft legislation in English. Input: optional q (keyword, Korean or English), date (YYYY-MM-DD KST), limit (1-20, default 5). Output: JSON items with Korean title, official link, published time and English brief {title_en, summary_en, agency_en, category, key_points}. Machine translation; check the official page. Example: ?q=AI&limit=5
  - `q`: Keyword filter (title/summary, Korean or English)
  - `date`: Only items published that KST day
  - `limit`: Max items (default 5)
- [Web read: web page to Markdown, one URL to clean Markdown for LLMs (title, language, optional injection flags)](https://1gateway.dev/v1/web/read?url=https://example.com/&max_chars=20000&flags=1): $0.002 per call. Use when an agent already has a URL and needs the page as clean Markdown (boilerplate removed, tables kept). Input: url, optional max_chars (500-60000), flags=1 for rule-based prompt-injection signals. Output: JSON markdown, title, language, finalUrl, chars, truncated. SSRF-safe; pages opting out with noai are refused. English brief: /v1/web/read/brief. Search+read: /v1/web/search-read. Example: ?url=https://example.com/
  - `url` (required): Public http(s) web page URL
  - `max_chars`: Max Markdown characters returned (default 60000)
  - `flags`: 1 = add rule-based prompt-injection signals found in the page
- [Web read + English brief: page Markdown plus headline, summary, key points, entities, topics](https://1gateway.dev/v1/web/read/brief?url=https://example.com/&max_chars=20000&flags=1): $0.0045 per call. Use when an agent needs a page in any language (Korean, Japanese, etc.) read and briefed in English. Input: url, optional max_chars, flags=1. Output: JSON markdown, title, plus brief {headline, summary, key_points, entities, topics, source_language, content_type}; fixed schema, cached by content. Model outage or daily cap is refused before payment. Example: ?url=https://example.com/
  - `url` (required): Public http(s) web page URL
  - `max_chars`: Max Markdown characters returned (default 60000)
  - `flags`: 1 = add rule-based prompt-injection signals found in the page
- [Web read batch: up to 5 URLs to clean Markdown in one call](https://1gateway.dev/v1/web/read/batch?urls=https://example.com/ https://example.org/&max_chars=8000&flags=1): $0.008 per call. Use when an agent has several URLs (search results, citations) and needs them all as Markdown at once. Input: urls (1-5 public URLs separated by spaces), optional max_chars per URL (500-20000), flags=1. Output: JSON results[] in input order, each status ok (markdown, title, finalUrl) or error (code, message). Charged once if at least one page is read. Example: ?urls=https://example.com/ https://example.org/
  - `urls` (required): 1-5 public http(s) URLs separated by spaces
  - `max_chars`: Max Markdown characters per URL (default 20000)
  - `flags`: 1 = add rule-based prompt-injection signals per page
- [Render to PDF: HTML, Markdown or a web page to a print-ready PDF (Korean fonts included)](https://1gateway.dev/v1/render/pdf?url=https://example.com/&format=A4&landscape=0&margin_mm=12&markdown=&html=): $0.01 per call. Use when an agent must hand over a document as a PDF (report, invoice, summary, receipt). Input: GET ?url= for a public page, or POST JSON {html | markdown | url, format A4|Letter, landscape, margin_mm}. Markdown gets a clean stylesheet with Korean fonts. Output: JSON fileBase64 (decode to the PDF), bytes, page settings. Headless Chrome on Cloudflare. Bad input or daily cap refused before payment. Example: ?url=https://example.com/
  - `url`: Public http(s) page to render (GET). For html/markdown use POST JSON.
  - `format`: Page size (default A4)
  - `landscape`: 1 = landscape
  - `margin_mm`: Page margin in mm (default 12)
  - `markdown`: Markdown to render (MCP argument or POST JSON; alternative to url/html)
  - `html`: HTML to render (MCP argument or POST JSON; alternative to url/markdown)
- [Render to image: HTML, Markdown or a web page to a PNG (cards, charts, previews)](https://1gateway.dev/v1/render/png?url=https://example.com/&width=1024&full_page=1&markdown=&html=): $0.01 per call. Use when an agent must turn its own HTML or Markdown into an image (social card, chart, table snapshot, preview) or capture a page as PNG. Input: GET ?url=, or POST JSON {html | markdown | url, width 320-1920, full_page}. Korean fonts included. Output: JSON fileBase64 (decode to the PNG), bytes, viewport. Bad input or daily cap refused before payment. Example: ?url=https://example.com/
  - `url`: Public http(s) page to render (GET). For html/markdown use POST JSON.
  - `width`: Viewport width in px (default 1024)
  - `full_page`: 1 = whole page (default), 0 = first screen only
  - `markdown`: Markdown to render (MCP argument or POST JSON; alternative to url/html)
  - `html`: HTML to render (MCP argument or POST JSON; alternative to url/markdown)
- [OCR: scanned PDF or image (Korean and English) to Markdown](https://1gateway.dev/v1/convert/ocr?url=https://example.com/scan.png&contentBase64=): $0.015 per call. Use when an agent must read text from a scan, photo or screenshot: scanned PDFs (embedded page images) or PNG/JPEG/WebP up to 5 MB, Korean and English, tables kept as Markdown. Up to 3 pages per call. Input: url via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64). Output: JSON markdown, pages with confidence, warnings. PDFs with selectable text: use /v1/convert/markdown. Example: ?url=https://example.com/scan.png
  - `url`: Public http(s) URL of a PNG/JPEG/WebP image or a scanned PDF (≤ 5 MB). For uploads use POST.
  - `contentBase64`: File bytes as base64 (MCP argument or POST JSON; alternative to url; max 5 MB decoded)
- [x402 payment verify: did this transaction really pay USDC to this address?](https://1gateway.dev/v1/x402/verify?tx=0x8d8f2ef4a94f8b3b58b2b9e4f3a6e8e3f1b6f8d7b9a3c2d1e0f9a8b7c6d5e4f3&pay_to=0x6246eee0355Dd7A93C888fE59e1151388A0b0a2C&network=eip155:8453&amount=0.01): $0.002 per call. Use when an agent or seller must confirm a payment before delivering: checks a Base, Base Sepolia or Solana transaction for a USDC transfer to pay_to of at least amount. Input: tx (hash or signature), pay_to, network (default eip155:8453), optional amount in USDC. Output: JSON paid true/false, verdict, received, payers, block, time, confirmations. Bad formats refused before payment. Example: ?tx=0x…&pay_to=0x…&amount=0.01
  - `tx` (required): Transaction hash (0x…, Base) or signature (base58, Solana)
  - `pay_to` (required): Receiving address (0x… on Base, base58 owner address on Solana)
  - `network`: CAIP-2 network (default eip155:8453 = Base)
  - `amount`: Expected minimum USDC amount, e.g. 0.01
- [Web screenshot: render a page in headless Chrome and return the image](https://1gateway.dev/v1/web/screenshot?url=https://example.com/&width=1280&full_page=0&format=jpeg): $0.01 per call. Use when an agent must see how a page looks (layout, charts, visual QA, previews), not just its text. Input: url, width (320-1920, default 1280), full_page=1 for the whole page, format png or jpeg (default). Output: JSON imageBase64 (decode to the image), contentType, bytes, viewport. Renders JavaScript. Daily cap or bad URL refused before payment. Example: ?url=https://example.com/
  - `url` (required): Public http(s) page URL
  - `width`: Viewport width in px (default 1280; height = 0.625 x width)
  - `full_page`: 1 = capture the whole scrollable page
  - `format`: Image format (default jpeg)
- [Email check: syntax, MX, SPF/DMARC, disposable and role address, deliverability verdict](https://1gateway.dev/v1/email/check?email=info@example.com): $0.002 per call. Use when an agent is about to email or sign up a contact. Input: email. Output: JSON verdict (deliverable, risky, undeliverable) with reasons, MX hosts, null MX, SPF and DMARC policy, disposable domain, role account, free provider. No SMTP probe, so the mailbox itself is not verified. Malformed address refused before payment. Example: ?email=info@example.com
  - `email` (required): Email address to check
- [Document extract: PDF, DOCX, HWP/HWPX or web page to structured JSON with English overview](https://1gateway.dev/v1/docs/extract?url=https://example.com/&type=html): $0.009 per call. Use when an agent needs the key facts of a document, not just its text: Korean HWP/HWPX, PDF, DOCX or web page. Input: url via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Output: fixed-schema JSON title, title_en, document_type, date, org, amounts, tables (parsed rows), english_overview. Bad input or model outage refused before payment. Example: ?url=https://example.com/
  - `url`: Public http(s) URL of a PDF, DOCX, HWP, HWPX or web page. For uploads use POST.
  - `type`: Optional expected type; a mismatch is rejected before payment (415, not charged)
- [U.S. company intelligence: SEC profile, 3-year financials, risk signals and recent news in one call](https://1gateway.dev/v1/company/intelligence?ticker=NVDA&cik=1045810&news=true): $0.035 per call. Use when an agent researches a U.S. public company (due diligence, investing, competitors) and wants one sourced brief instead of many calls. Input: ticker or cik, optional news=false. Output: JSON profile, 3 fiscal years + latest quarter + balance sheet from SEC XBRL, YoY growth, rule-based risk signals (8-K items, late filings, losses) with evidence, recent 8-K events, latest news (title, link, date, publisher summary), sources. Example: ?ticker=NVDA
  - `ticker`: U.S. ticker (NVDA, BRK.B); give ticker or cik
  - `cik`: SEC Central Index Key; give ticker or cik
  - `news`: Include recent news (default true)
- [Satellite image of any place: clearest recent Sentinel-2 scene, true color or NDVI](https://1gateway.dev/v1/geo/satellite?lat=37.5665&lon=126.978&radius_m=3000&mode=true_color&date=2026-10-18&days=30&max_cloud=40&size=1024): $0.009 per call. Use when an agent must see a place from above or check vegetation, water or change. Input: lat, lon, radius_m (200-10000), mode (true_color, false_color, ndvi, ndwi, moisture), date, days back, max_cloud. Picks the clearest Sentinel-2 scene by cloud share inside your area, not the whole tile. Output: JSON PNG URL (+ other modes), scene date, area cloud %, alternatives. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978
  - `lat` (required): Latitude, WGS84 decimal degrees
  - `lon` (required): Longitude, WGS84 decimal degrees
  - `radius_m`: Half-width of the square area in meters (default 2000)
  - `mode`: Rendering (default true_color); URLs for the other modes are returned too
  - `date`: Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)
  - `days`: Look-back window in days before date (default 30)
  - `max_cloud`: Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available
  - `size`: Image width/height in px (default 1024)
- [Satellite before/after: two clearest Sentinel-2 scenes, images and NDVI change for any place](https://1gateway.dev/v1/geo/satellite/compare?lat=37.5665&lon=126.978&radius_m=2000&before=2026-04-15&after=2026-10-08&window_days=15&size=768): $0.018 per call. Use when checking what changed at a place between two dates (construction, deforestation, flooding, crops). Input: lat, lon, radius_m (200-10000), before and after dates (20+ days apart). Output: JSON per date: clearest scene, area cloud %, NDVI mean/median, true color, NDVI and false color PNG URLs; NDVI change and reliability. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978&before=2026-04-15&after=2026-10-08
  - `lat` (required): Latitude, WGS84 decimal degrees
  - `lon` (required): Longitude, WGS84 decimal degrees
  - `radius_m`: Half-width of the square area in meters (default 2000)
  - `before` (required): Earlier date YYYY-MM-DD (2017-01-01 or later)
  - `after` (required): Later date YYYY-MM-DD, at least 20 days after before
  - `window_days`: Search ± days around each date (default 15)
  - `size`: Image width/height in px (default 768)
- [Vegetation trend from space: monthly Sentinel-2 NDVI and cloud % for any place (1-12 months)](https://1gateway.dev/v1/geo/satellite/trend?lat=36.35&lon=127.38&radius_m=2000&months=6&end=2026-10-28): $0.012 per call. Use when tracking crops, greenery or land change month by month. Input: lat, lon, radius_m (200-10000), months (1-12), optional end date. Output: JSON series per month: clearest scene, area cloud %, NDVI mean/median, status (ok, cloudy, no_scene), plus min/max and first-to-last change. Numbers only, no images. No scene at all: 404, not charged. Example: ?lat=36.35&lon=127.38&months=6
  - `lat` (required): Latitude, WGS84 decimal degrees
  - `lon` (required): Longitude, WGS84 decimal degrees
  - `radius_m`: Half-width of the square area in meters (default 2000)
  - `months`: Number of calendar months ending with the end month (default 6)
  - `end`: Last date YYYY-MM-DD (default today)
- [Base Token Risk: Honeypot & Rug-Pull Check (buy/sell simulation, contract risk signals)](https://1gateway.dev/v1/onchain/base/token-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913): $0.009 per call. Base ERC-20 token risk scan: honeypot check, rug pull check, token safety / scam check. Use when vetting a token. Input: address. Output: JSON risk signals w/ block+evidence: honeypot test (buy/sell simulation, taxes), rug-pull signals (owner, mint/pause/blacklist/fee fns, proxy+admin, owner-held supply, Uniswap/Aerodrome pool depth), notChecked. Signals, not a safe verdict. Bad input/EOA: 400, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  - `address` (required): Token contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOAs, bad checksums → 400 before payment (not charged)
- [Base wallet balances: ETH + many ERC-20s in one call, with nonce and contract flag](https://1gateway.dev/v1/onchain/base/balances?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1&tokens=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006): $0.002 per call. Use when an agent needs what a Base address holds in one call instead of one RPC call per token. Input: address; optional tokens (up to 20 ERC-20 addresses, comma-separated; default USDC, EURC, USDbC, WETH, cbBTC, cbETH, wstETH). Output: JSON block+time, ETH balance, per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1
  - `address` (required): Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)
  - `tokens`: Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.
- [Base ERC-20 token info: name, symbol, decimals, total supply, optional holder balance and allowance](https://1gateway.dev/v1/onchain/base/token-info?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&holder=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1&spender=0x000000000022D473030F116dDEE9F6B43aC78BA3): $0.002 per call. Use when an agent needs an ERC-20's basics on Base before quoting, transferring or approving it. Input: address (token contract); optional holder (adds balance and share of supply) and spender (adds allowance, flags unlimited approvals). Output: JSON block+time, name, symbol, decimals, totalSupply raw and decimal, known issuer if curated. Name/symbol are self-reported. EOA or non-ERC-20: 4xx, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  - `address` (required): ERC-20 token contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOA → 400, non-ERC-20 contract → 422 (not charged)
  - `holder`: Optional address whose token balance and share of total supply to include
  - `spender`: Optional spender; with holder, adds allowance(holder, spender). Needs holder.
- [Base transaction status with decoded ERC-20 transfers, fee and confirmations](https://1gateway.dev/v1/onchain/base/tx?hash=0x284f8abed91b5631ee28bdb1ccfe78374e18c480cb2ab25f28e3bfac5210fe0b): $0.0045 per call. Use when an agent must confirm a Base transaction or payment landed: did it succeed, who paid whom, how much of which token. Input: hash. Output: JSON status (success/reverted), block+time, confirmations, from, to, ETH value, fee (L2 gas + L1 data fee), decoded ERC-20 transfers with symbol and decimal amount (first 25). Unknown or unmined hash: 404, not charged. Example: ?hash=0x284f8abed91b5631ee28bdb1ccfe78374e18c480cb2ab25f28e3bfac5210fe0b
  - `hash` (required): Transaction hash on Base mainnet (0x + 64 hex). Unknown or not yet mined → 404 (not charged)
- [Base token flows: top net buyers and sellers, whale transfers, last 60 min](https://1gateway.dev/v1/onchain/base/token-flows?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&minutes=60&limit=10): $0.004 per call. Use when an agent must see who is accumulating or dumping a Base ERC-20 right now. Input: token address, minutes (1-60, default 60), limit (1-25). Output: JSON top net buyers and sellers (net, received, sent, contract or EOA), largest transfers with tx hash, volume, mints/burns, active wallets, covered window. Busy tokens get a shorter window. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed
  - `address` (required): ERC-20 token contract on Base mainnet. EOA → 400, non-ERC-20 → 422 (not charged)
  - `minutes`: Look-back window in minutes (default 60). Very busy tokens are cut short; see window.complete
  - `limit`: Rows per list (default 10)
- [Token prices from onchain DEX pools (Base and Solana), with pool, depth and confidence](https://1gateway.dev/v1/onchain/prices?tokens=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631): $0.003 per call. Use when an agent needs a token's USD price without a third-party price feed. Input: tokens (up to 10, base:0x… or sol:<mint>). Output: per token priceUsd, confidence, the pool used (Uniswap v3 / Aerodrome on Base, Orca Whirlpool on Solana; fee tier, depth in USD), path (direct USDC or via WETH/SOL), warnings; no price below $1,000 depth. Spot, not TWAP. Example: ?tokens=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631
  - `tokens` (required): Comma-separated chain:address list, max 10 (base:0x… ERC-20, sol:<mint> base58). Bad input → 400 before payment (not charged)
- [Batch token prices + trade price impact (Base and Solana DEX pools)](https://1gateway.dev/v1/onchain/prices/batch?tokens=base:0x4200000000000000000000000000000000000006,base:0x940181a94A35A4569E4529A3CDfB74e38FD98631&amount_usd=5000): $0.008 per call. Use when a trading agent needs many token prices at once plus what a buy would really cost. Input: tokens (≤25, base:0x… or sol:<mint>, ≤10 Solana), amount_usd (default 1000). Output: per token priceUsd, confidence, pool, depth and a buy estimate: tokensOut, effectivePriceUsd, priceImpactPct (Uniswap v3 QuoterV2 / Aerodrome on Base, CLMM estimate on Orca). Cached 20 s. Example: ?tokens=base:0x4200000000000000000000000000000000000006&amount_usd=5000
  - `tokens` (required): Comma-separated chain:address list, max 25 (≤10 Solana). Bad input → 400 before payment (not charged)
  - `amount_usd`: Size of the buy to estimate, in USD (default 1000)
- [Token due-diligence report: risk signals, admin controls, liquidity and price impact, perp market, OFAC wallet screen (Base, Solana)](https://1gateway.dev/v1/onchain/token/report?token=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631&format=json): $0.20 per call. Use when an agent needs one English brief on a token before trading or listing it. Input: token (base:0x… or sol:<mint>), format=json|markdown. Output: executiveSummary, riskAssessment (signals, owner/proxy or mint/freeze authority, holders), liquidity (price, depth, $1k/$10k buy impact), perpMarket (Hyperliquid, symbol match), sanctions (OFAC wallets), dataGaps. AI-written from chain facts; not advice. Example: ?token=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631
  - `token` (required): One token: base:0x… (ERC-20 on Base) or sol:<mint>. Unknown token or bad input → 400 before payment (not charged)
  - `format`: markdown adds a readable English rendering of the same report
- [Explain a transaction in plain English (Base / Solana): swap, transfer, approval, contract call](https://1gateway.dev/v1/onchain/tx/explain?tx=0xffbdcb7953401111c60d780212c77c6e01f82295cda8670a9e63a2574a01be32&network=eip155:8453): $0.005 per call. Use when an agent must tell a user what a transaction did. Input: tx (Base hash or Solana signature), network=eip155:8453|solana (optional, inferred). Output: explanation (1-3 sentences; every number checked against the decoded facts, template fallback), facts: status, time, fee, from/to, called function (curated selector table), ERC-20 transfers, approvals, inferred swap (sent/received), Solana programs. Example: ?tx=0x…&network=eip155:8453
  - `tx` (required): Base transaction hash (0x + 64 hex) or Solana signature (base58)
  - `network`: Chain (default: Base for 0x hashes, Solana otherwise)
- [Solana token info: SPL / Token-2022 mint supply, decimals, authorities and extensions](https://1gateway.dev/v1/onchain/solana/token-info?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v): $0.002 per call. Use when an agent needs a Solana token's basics before quoting, transferring or accepting it. Input: mint. Output: JSON slot, program (spl-token or token-2022), decimals, supply raw and decimal, mint and freeze authority, Token-2022 extensions (transfer fee, permanent delegate, transfer hook, default frozen, metadata), known issuer if curated. Not a mint: 422, unknown: 404, not charged. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  - `mint` (required): Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)
- [Solana Token Risk: Rug Pull & Scam Token Check (mint/freeze authority, holder concentration)](https://1gateway.dev/v1/onchain/solana/token-risk?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v): $0.009 per call. Solana token risk scan: rug pull, scam token and token safety check. Use when buying, accepting or listing a token. Input: mint. Output: JSON riskLevel + signals w/ evidence: mint authority, freeze authority (can freeze/blacklist holders), permanent delegate, transfer hook/fee, default-frozen, mutable metadata, top-10 holder share. No sell simulation; not an audit. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  - `mint` (required): Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)
- [Solana wallet balances: SOL plus every SPL and Token-2022 token account in one call](https://1gateway.dev/v1/onchain/solana/balances?address=CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u): $0.002 per call. Use when an agent needs what a Solana address holds in one call. Input: address. Output: JSON slot, SOL balance, every non-zero token (mint, token account, program, decimals, raw and decimal balance, frozen flag; first 50), counts of token and empty accounts. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u
  - `address` (required): Wallet address on Solana mainnet (base58, 32 bytes). Bad input → 400 (not charged)
- [Solana transaction status with SOL and token balance changes, fee and programs](https://1gateway.dev/v1/onchain/solana/tx?signature=5Xg1wCobkM4jAJNHE6t7B1amt4ch5wq5GrxuhQXXgoAkUPUAjVMC9tQFCvp1awUGfrqZY9L9sLdPieJ97DcDjXtC): $0.0045 per call. Use when an agent must confirm a Solana payment or transaction landed: did it succeed, who paid whom, how much of which token. Input: signature. Output: JSON status (success/failed), slot, block time, confirmation status, fee payer, signers, fee, programs, SOL and token balance changes per account (first 25). Unknown signature: 404, not charged. Example: ?signature=5Xg1wCobkM4jAJNHE6t7B1amt4ch5wq5GrxuhQXXgoAkUPUAjVMC9tQFCvp1awUGfrqZY9L9sLdPieJ97DcDjXtC
  - `signature` (required): Transaction signature on Solana mainnet (base58, 64 bytes). Unknown or not yet confirmed → 404 (not charged)
- [LLM model price lookup, token cost calculator and cheapest-model finder](https://1gateway.dev/v1/ai/llm-prices?model=gpt-4o&input_tokens=12000&output_tokens=800&requests=1000&provider=openai&mode=chat&min_context=100000&capabilities=vision&limit=5&include_deprecated=false): $0.004 per call. Use when an agent must price an LLM call or pick the cheapest model. Input: model (up to 5, comma list) plus optional input_tokens, output_tokens, requests; or no model plus mode, provider, min_context, capabilities (vision, function_calling...). Output: JSON USD per 1M input/output tokens, cached/batch prices, context window, provider, capabilities, cost estimate or cheapest ranking, as_of + source commit. Example: ?model=gpt-4o&input_tokens=12000&output_tokens=800
  - `model`: Model name(s), up to 5 comma-separated (gpt-4o, claude-sonnet-4-5, gemini/gemini-2.5-flash). Also lists the same model at other providers. Omit to rank the cheapest models. Unknown → 400 with suggestions (not charged)
  - `input_tokens`: Input (prompt) tokens per request, for the cost estimate and ranking
  - `output_tokens`: Output (completion) tokens per request
  - `requests`: Number of requests to multiply the estimate by (default 1)
  - `provider`: LiteLLM provider id filter: openai, anthropic, gemini, vertex_ai, bedrock, azure, groq, deepseek, mistral...
  - `mode`: Model type for the cheapest search (default chat; chat includes responses-API models). Ignored when model is given
  - `min_context`: Minimum context window (max input tokens)
  - `capabilities`: Comma-separated required capabilities: vision, function_calling, reasoning, prompt_caching, response_schema, pdf_input, audio_input, audio_output, web_search, computer_use, video_input
  - `limit`: Max rows per model or in the ranking (default 10)
  - `include_deprecated`: Include models past their deprecation date in the cheapest search (default false)
- [x402 API finder: ranked paid endpoints for a task, with demand and quality flags](https://1gateway.dev/v1/x402/recommend?q=base token honeypot check&max_price=0.02&network=base&limit=5&include_flagged=true): $0.009 per call. Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), seller buyers (x402scan), wash/quality flags, score, index as_of. Same rules for every seller. Example: ?q=base+token+honeypot+check&max_price=0.02
  - `q` (required): What the API should do, in plain words or keywords (e.g. 'korean apartment prices', 'convert pdf to markdown'). Text only: never fetched as a URL
  - `max_price`: Only endpoints priced at or below this many USD per call
  - `network`: Only endpoints that accept this network: base, solana, polygon, arbitrum, optimism, ethereum, avalanche, worldchain, monad, or a CAIP-2 id (eip155:8453)
  - `limit`: Number of results (default 8)
  - `include_flagged`: false drops routes flagged scanner_like or uniform_payers (suspected probes / wash); default true (flagged routes are kept but ranked lower)
- [x402 seller linter: grade an x402 endpoint's 402 quote, Bazaar metadata and discovery docs](https://1gateway.dev/v1/x402/lint?url=https://1gateway.dev/v1/time/convert&method=GET): $0.008 per call. Use when you sell an API over x402 and want it to pass Bazaar/CDP listing checks. Input: url (https x402 resource), method GET or POST. Output: JSON score 0-100, grade, per-check pass/warn/fail with fix hints (x402 v2 quote, accepts fields, USDC asset, payTo format and OFAC list, description quality, Bazaar schemas, header size, CORS, latency, openapi/llms.txt, ERC-8004) plus our measured uptime. Never pays. Example: ?url=https://1gateway.dev/v1/time/convert
  - `url` (required): https URL of the x402 resource to grade (public host)
  - `method`: HTTP method of the resource (POST sends an empty JSON body)
- [x402 preflight: ALLOW / WARN / DENY before an agent pays an x402 endpoint](https://1gateway.dev/v1/x402/preflight?url=https://1gateway.dev/v1/fx/rates&method=GET&max_price_usd=0.01): $0.002 per call. Use when an agent is about to pay an unknown x402 endpoint and needs a cheap safety gate. Input: url (https x402 resource), method, optional max_price_usd. Output: JSON verdict ALLOW/WARN/DENY with reasons: live quote now, price vs similar routes and your budget, payTo on the OFAC list, price change vs our last measurement, our 7-day uptime/p95, ERC-8004 registration. Never pays; cached 60 s. Example: ?url=https://1gateway.dev/v1/fx/rates&max_price_usd=0.01
  - `url` (required): https URL of the x402 resource you are about to pay
  - `method`: HTTP method of the resource
  - `max_price_usd`: Your budget per call in USD; a higher quote gives DENY
- [Hyperliquid perp funding rate, open interest and basis, with Binance/Bybit predicted funding comparison](https://1gateway.dev/v1/crypto/hyperliquid/perp?coin=BTC): $0.002 per call. Hyperliquid vs Binance vs Bybit predicted funding comparison for one perpetual futures market, plus current funding rate, open interest and basis. Use when an agent monitors a perp position or funding carry. Input: coin (e.g. BTC, ETH, kPEPE). Output: JSON as_of, cache_age_s, 1h + annualized funding, OI coin/USD, mark/oracle/mid, basis %, premium, 24h volume and change, per-venue predicted funding, annualized spread. Unknown coin: 400, not charged. Example: ?coin=BTC
  - `coin` (required): Hyperliquid perp symbol, case-insensitive (BTC, ETH, SOL, HYPE, kPEPE). Not listed or delisted → 400 before payment (not charged)
- [Perp funding rate screener: all Hyperliquid perps ranked by funding, OI, volume, basis and venue spread](https://1gateway.dev/v1/crypto/hyperliquid/screener?sort=funding&order=desc&limit=20&min_oi_usd=1000000&min_volume_usd=1000000&funding=any&min_abs_apr=0): $0.009 per call. Perpetual futures funding rate screener over all Hyperliquid perps, ranked by funding, open interest, volume, basis or Binance/Bybit spread. Use when hunting funding extremes or carry trades. Input: optional sort, order, limit (1-50), min_oi_usd, min_volume_usd, funding (positive/negative), min_abs_apr. Output: JSON as_of, cache_age_s, rows (1h + annualized funding, OI USD, 24h volume, basis, premium, venue spread), top/bottom 5. Example: ?sort=funding&limit=20
  - `sort`: Ranking field (default funding = 1h funding rate)
  - `order`: desc (highest first, default) or asc
  - `limit`: Rows returned (1-50, default 20)
  - `min_oi_usd`: Only markets with open interest >= this many USD
  - `min_volume_usd`: Only markets with 24h notional volume >= this many USD
  - `funding`: Funding sign filter (positive = longs pay shorts)
  - `min_abs_apr`: Only markets whose |annualized Hyperliquid funding| >= this percent
- [Hyperliquid funding rate history: percentiles, z-score, averages and open-interest change](https://1gateway.dev/v1/crypto/hyperliquid/funding-history?coin=BTC&hours=168): $0.004 per call. Use when an agent judges whether a perp's funding is unusually high or low, or tracks open-interest build-up. Input: coin (e.g. BTC), hours (24-720, default 168). Output: current 1h funding and APR, 24h/7d/30d average APR, current percentile and z-score vs 7d and 30d, share of positive hours, downsampled series, open interest now and change 1h/24h/7d (from our 5-minute snapshots). Example: ?coin=BTC&hours=168
  - `coin` (required): Hyperliquid perp symbol (BTC, ETH, SOL, HYPE, kPEPE). Not listed → 400 before payment
  - `hours`: Window of the returned series in hours (24-720, default 168); statistics always cover 7 and 30 days
- [Hyperliquid funding extremes and open-interest movers (z-score vs each coin's own 7 days)](https://1gateway.dev/v1/crypto/hyperliquid/extremes?limit=10&min_oi_usd=1000000): $0.006 per call. Use when hunting crowded perps: which markets have funding far from their own normal and where open interest is jumping. Input: optional limit (1-50, default 10), min_oi_usd (default 1,000,000). Output: as_of, fundingExtremes ranked by |z| (current 1h funding vs the coin's last 7 days), oiMovers24h and oiMovers1h (open-interest % change), each with funding APR and OI USD. Example: ?limit=10
  - `limit`: Rows per list (1-50, default 10)
  - `min_oi_usd`: Skip markets with open interest below this many USD (default 1,000,000)
- [Top up Sepolia test ETH from an agent or CI job: 0.1 SepETH per call](https://1gateway.dev/v1/testnet/sepolia-eth?to=0x000000000000000000000000000000000000dEaD): $0.05 per call. Use when an agent, test suite or CI job needs Sepolia gas now: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 0.1 SepETH (1 SepETH: /v1/testnet/sepolia-eth/1). Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD
  - `to` (required): Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)
- [Top up 1 Sepolia test ETH from an agent or CI job (bulk)](https://1gateway.dev/v1/testnet/sepolia-eth/1?to=0x000000000000000000000000000000000000dEaD): $0.50 per call. Use when a contract deploy, test suite or CI job needs more Sepolia gas than a faucet gives: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 1 SepETH. Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD
  - `to` (required): Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)
- [Top up Base Sepolia test ETH from an agent or CI job: 0.1 ETH per call](https://1gateway.dev/v1/testnet/base-sepolia-eth?to=0x000000000000000000000000000000000000dEaD): $0.05 per call. Use when an agent, x402 test or CI job needs Base Sepolia gas now: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 0.1 ETH (1 ETH: /v1/testnet/base-sepolia-eth/1). Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 ETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD
  - `to` (required): Recipient address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)
- [Top up 1 Base Sepolia test ETH from an agent or CI job (bulk)](https://1gateway.dev/v1/testnet/base-sepolia-eth/1?to=0x000000000000000000000000000000000000dEaD): $0.50 per call. Use when contract deploys, x402 tests or CI jobs need more Base Sepolia gas than a faucet gives: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 1 Base Sepolia ETH. Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 ETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD
  - `to` (required): Recipient address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)

## Document → Markdown

- [Document to Markdown: Korean HWP/HWPX to Markdown, plus web pages, PDF and DOCX](https://1gateway.dev/v1/convert/markdown?url=https://example.com/): $0.0027–$0.009 per call. Use when an agent must read a document as clean Markdown: web page, PDF, DOCX or Korean HWP/HWPX, tables kept. Input: url (http/https) via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Free-plan size cap → 413 before payment: HWP 48 KB, HWPX 100 KB XML. Output: JSON markdown, title, pages, sourceType, warnings. Price by detected type: HTML $0.0027, PDF/DOCX $0.0045, HWP/HWPX $0.009. Example: ?url=https://example.com/
  - `GET /v1/convert/markdown?url=<http(s) URL>[&type=]`
  - `POST /v1/convert/markdown` with multipart field `file`, a raw body (`?filename=report.hwp`), or JSON `{"url"| "contentBase64", "filename", "type"}`
  - Pricing (decided before payment from the detected type): Web page / HTML / plain text $0.0027; PDF, DOCX $0.0045; HWP, HWPX (Hancom) $0.009. For URLs the first 8 KB are fetched to detect the type; if the document changes to a pricier type before conversion you get 409 (not charged).
  - Size caps (Workers Paid): no per-format caps (Workers Paid); 10 MB per document. Over the cap → 413 `too_large_for_plan` before payment (not charged); for URLs without Content-Length that are larger than the 8 KB peek, the cap is checked after the fetch and before conversion (still not charged).
  - Limits: 10 MB per document, 3 redirects, 15 s fetch timeout, first 100 PDF pages, 200 HWP/HWPX sections. Public http(s) URLs only (private/loopback/link-local/metadata addresses are blocked). No OCR: scanned PDFs return 422. Password-protected documents return 422. HWP 3.x and legacy .doc are unsupported (415).
  - Output: `{markdown, title, pages?, sections?, sourceType, priceTier, bytes, chars, sourceUrl?, warnings}`. Tables become GFM tables; merged cells are repeated as empty cells.
  - Documents are processed in memory only; contents are not stored or logged.
  - 본 제품은 한컴의 HWP 문서 파일(.hwp) 공개 문서를 참고하여 개발하였습니다. (HWP support was developed with reference to Hancom's published HWP document file (.hwp) format specification.)

## Useful ECOS tables (BOK-authored)

- 722Y001: BOK Base Rate and Deposit/Lending Rates (cycle M, item 0101000)
- 200Y101: Key Indicators (Annual) (cycle A)
- 101Y003: M2 by Instrument (Average, Seasonally Adjusted) (cycle M)

## Docs

- [OpenAPI](https://1gateway.dev/openapi.json)
- [Service index](https://1gateway.dev/)
- MCP (Streamable HTTP): https://1gateway.dev/mcp — tools/list free, tools/call paid via x402

## Contact

- contact@1gateway.dev (support, issues, API requests)

## Notes

- Attribution to the original Korean agencies is included in every response (`attribution`).
- English names of places/complexes are machine romanizations unless stated otherwise.
- Failed upstream calls return 4xx/5xx and are not settled (you are not charged).
- 본 제품은 한컴의 HWP 문서 파일(.hwp) 공개 문서를 참고하여 개발하였습니다.