{"openapi":"3.1.0","info":{"title":"TELAGO Global Agent Commerce & Trade Intelligence x402 API","version":"1.2.0","description":"Pay-per-call global trade and agent intelligence: business identity, vendor pre-payment risk, sanctions, restricted-party/export-control screening, plus Korea execution intelligence.","contact":{"name":"TELAGO","email":"moneybug@favpulse.media"}},"servers":[{"url":"https://favpulse.media/telago/api"}],"externalDocs":{"description":"Settlement-verified PayAPI Market listing","url":"https://payapi.market/api/callmate-korea-last-meter-intelligence"},"x-discovery":{"ownershipProofs":["0x078293f144c61d1e02b49d4cd3f33c283eb7dc73"],"marketplaceProofs":[{"provider":"PayAPI Market","listing":"https://payapi.market/api/callmate-korea-last-meter-intelligence","settlementVerified":true}]},"paths":{"/business-identity":{"get":{"operationId":"businessIdentityLei","summary":"Business Identity / LEI","description":"Global legal-entity identity from GLEIF. Search by company name or exact LEI. $0.002 USDC.","tags":["business-identity","company-identity","lei","gleif","kyb"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"lei","in":"query","required":false,"schema":{"type":"string","minLength":20,"maxLength":20}}],"responses":{"200":{"description":"GLEIF legal-entity identity evidence"},"402":{"description":"x402 payment required"}}}},"/company-identity-lei":{"get":{"operationId":"companyIdentityLei","summary":"Company Identity / LEI lookup","description":"Company identity and LEI lookup from authoritative GLEIF data. $0.002 USDC.","tags":["company-identity","lei","kyb"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"lei","in":"query","required":false,"schema":{"type":"string","minLength":20,"maxLength":20}}],"responses":{"200":{"description":"Company identity result"},"402":{"description":"x402 payment required"}}}},"/counterparty-screening":{"get":{"operationId":"counterpartyScreening","summary":"Counterparty Screening","description":"Company/vendor counterparty screening before payment, trade or onboarding using legal identity, global sanctions, U.S. export-control and optional payment-risk evidence. $0.005 USDC.","tags":["counterparty-screening","counterparty","kyb","sanctions","export-control","procurement"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"email","in":"query","required":false,"schema":{"type":"string"}},{"name":"iban","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Counterparty screening decision and evidence"},"402":{"description":"x402 payment required"}}}},"/vendor-risk-before-payment":{"get":{"operationId":"vendorRiskBeforePayment","summary":"Vendor risk before payment","description":"Verify supplier identity, sanctions, U.S. export controls, domain, email and IBAN before funds move. GO / REVIEW / STOP. $0.005 USDC.","tags":["vendor-risk","supplier-risk","procurement","payment-risk"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"email","in":"query","required":false,"schema":{"type":"string"}},{"name":"iban","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Vendor payment decision"},"402":{"description":"x402 payment required"}}}},"/restricted-party-screening":{"get":{"operationId":"restrictedPartyScreening","summary":"Restricted Party Screening","description":"Screen a company or person against the U.S. Consolidated Screening List. $0.003 USDC.","tags":["restricted-party-screening","export-control","csl","trade-compliance"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Restricted-party screening result"},"402":{"description":"x402 payment required"}}}},"/export-control-screening":{"get":{"operationId":"exportControlScreening","summary":"Export Control Screening","description":"U.S. export-control screening against the Consolidated Screening List. $0.003 USDC.","tags":["export-control-screening","restricted-party","csl","trade-compliance"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Export-control screening result"},"402":{"description":"x402 payment required"}}}},"/sanctions-check":{"get":{"operationId":"sanctionsCheck","summary":"Sanctions Check — OFAC + UK + UN","description":"Sanctions screening across official U.S. OFAC SDN, UK FCDO/OFSI and UN Security Council lists. $0.002 USDC.","tags":["sanctions-check","ofac","uk-sanctions","un-sanctions","compliance"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sanctions screening result"},"402":{"description":"x402 payment required"}}}},"/domain-age":{"get":{"operationId":"domain-age","summary":"Domain age checker: registration date, age in days and years, expiry, registrar and RDAP trust signal","description":"Fast domain age / RDAP / WHOIS trust signal for autonomous agents vetting a link, sender, vendor or counterparty. Returns creation date, age, expiry, registrar, nameservers, DNSSEC, trust signal and machine-readable next paid actions. Keyless x402 pay-per-call. $0.001 USDC.","tags":["domain-age","rdap","whois","domain-trust","vendor-risk","counterparty","due-diligence"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":253},"description":"Public DNS domain name, e.g. example.com"}],"responses":{"200":{"description":"Domain age, registration and trust signal with next paid actions"},"400":{"description":"Invalid domain"},"402":{"description":"x402 payment required"},"502":{"description":"RDAP registry unavailable"}}}},"/korea-reality/gap-scan-lite":{"get":{"summary":"Korea Reality Gap Scan Lite — catch wrong stop-time assumptions before dispatch","description":"Compare a routing or TMS service-time assumption with TELAGO Korea building reality. Returns current seconds, TELAGO seconds, hidden gap and risk. Defaults to a verified representative Korea stop when query parameters are omitted. $0.01 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string"}},{"name":"deliveryMode","in":"query","required":false,"schema":{"type":"string","enum":["WALKING","BICYCLE","MOTORCYCLE","CAR"]}},{"name":"targetFloor","in":"query","required":false,"schema":{"type":"integer","minimum":-10,"maximum":200}},{"name":"packageClass","in":"query","required":false,"schema":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},{"name":"engineName","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentEngineSeconds","in":"query","required":false,"schema":{"type":"integer","minimum":30,"maximum":3600}}],"responses":{"200":{"description":"Current-engine vs TELAGO reality-gap signal"},"402":{"description":"x402 payment required"}}},"post":{"summary":"Korea Reality Gap Scan Lite for routing, delivery and TMS agents","description":"Low-cost one-stop Korea service-time reality check. Supply your engine prediction and receive TELAGO prediction, hidden gap and risk. $0.01 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"deliveryMode":{"type":"string","enum":["WALKING","BICYCLE","MOTORCYCLE","CAR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]},"engineName":{"type":"string","minLength":1,"maxLength":80},"currentEngineSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["normalizedAddress","deliveryMode","currentEngineSeconds"]}}}},"responses":{"200":{"description":"Current-engine vs TELAGO reality-gap signal"},"402":{"description":"x402 payment required"}}}},"/korea-reality/gap-scan":{"get":{"summary":"Korea Reality Gap Scan Full — evidence-backed service-time correction","description":"Full Korea reality scan with building/access evidence and integration-ready Google, HERE, Onfleet and Timefold correction values. $0.05 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Full evidence-backed reality-gap report"},"402":{"description":"x402 payment required"}}},"post":{"summary":"Korea Reality Gap Scan Full for routing and TMS systems","description":"Full evidence-backed Korea service-time gap scan. $0.05 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Full evidence-backed reality-gap report"},"402":{"description":"x402 payment required"}}}},"/preflight":{"get":{"summary":"x402 endpoint preflight before payment — verify 402 challenge, payTo, amount and network","description":"Buyer-side x402 endpoint protocol preflight before payment. Verify a live unpaid 402 challenge, payTo recipient, USDC amount, Base network and EIP-712 token-domain metadata before an AI agent signs or spends. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":false,"description":"Public HTTPS x402 endpoint to inspect. A representative public x402 endpoint is used when omitted so unpaid discovery probes can still receive the payment challenge.","schema":{"type":"string","format":"uri","minLength":12,"maxLength":1200}}],"responses":{"200":{"description":"x402 pre-payment protocol assessment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"verdict":{"type":"string","enum":["PAYABLE","CAUTION","AVOID"]},"targetUrl":{"type":"string"},"latencyMs":{"type":"integer"},"httpStatus":{"type":["integer","null"]},"x402Version":{"type":["integer","null"]},"selectedAccept":{"type":["object","null"]},"checks":{"type":"object"},"reasons":{"type":"array","items":{"type":"string"}},"scope":{"type":"object"}},"required":["ok","verdict","checks","reasons"]}}}},"402":{"description":"x402 payment required"}}}},"/market/funding-rates":{"get":{"summary":"Funding rates data feed for crypto derivatives","description":"Current perpetual funding-rate feed from Bybit public market data for up to 5 symbols. $0.002 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"symbols","in":"query","required":false,"description":"Comma-separated Bybit linear perpetual symbols, max 5.","schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"Funding rate snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"product":{"type":"string"},"source":{"type":"string"},"asOf":{"type":"string"},"requestedSymbols":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"data":{"type":"array","items":{"type":"object"}},"scope":{"type":"object"}},"required":["ok","product","source","asOf","data"]}}}},"402":{"description":"x402 payment required"}}}},"/x402/preflight":{"get":{"summary":"Check an x402 endpoint before paying it","description":"Pre-payment x402 endpoint check for AI agents. Verifies the unpaid 402 challenge, payTo, amount, network and EIP-712 metadata without paying the target endpoint. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"url","in":"query","required":false,"description":"Public HTTPS x402 endpoint to inspect. A representative public x402 endpoint is used when omitted so unpaid discovery probes can still receive the payment challenge.","schema":{"type":"string","format":"uri","minLength":12,"maxLength":1200}}],"responses":{"200":{"description":"x402 pre-payment protocol assessment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"verdict":{"type":"string","enum":["PAYABLE","CAUTION","AVOID"]},"targetUrl":{"type":"string"},"latencyMs":{"type":"integer"},"httpStatus":{"type":["integer","null"]},"x402Version":{"type":["integer","null"]},"selectedAccept":{"type":["object","null"]},"checks":{"type":"object"},"reasons":{"type":"array","items":{"type":"string"}},"scope":{"type":"object"}},"required":["ok","verdict","checks","reasons"]}}}},"402":{"description":"x402 payment required"}}}},"/korea-lastmeter/stop-intelligence":{"post":{"summary":"Korea Seoul last-mile stop intelligence for delivery routing","description":"Seoul/Korea building-level delivery stop intelligence for routing and ETA: floors, elevator evidence, nearby official parking and access difficulty. $0.01 USDC per successful x402 call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"deliveryMode":{"type":"string","enum":["WALKING","BICYCLE","MOTORCYCLE","CAR"]},"radiusMeters":{"type":"integer","minimum":50,"maximum":2000}},"required":["normalizedAddress","deliveryMode"]}}}},"responses":{"200":{"description":"Stop intelligence"},"402":{"description":"x402 payment required"}}}},"/korea-lastmeter/service-time":{"get":{"operationId":"korea-delivery-service-time","summary":"Korea delivery service-time estimate — GET-compatible","description":"Cold-start delivery stop service-time estimate from Korea building reality. Query parameters are optional for probe compatibility; omitted inputs use a verified representative stop after payment. $0.01 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"query","required":false,"schema":{"type":"string","minLength":3,"maxLength":300}},{"name":"deliveryMode","in":"query","required":false,"schema":{"type":"string","enum":["WALKING","BICYCLE","MOTORCYCLE","CAR"]}},{"name":"targetFloor","in":"query","required":false,"schema":{"type":"integer","minimum":-10,"maximum":200}},{"name":"packageClass","in":"query","required":false,"schema":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}}],"responses":{"200":{"description":"Service-time estimate"},"402":{"description":"x402 payment required"}}},"post":{"summary":"Korea cold-start delivery service-time estimate","description":"Seoul/Korea cold-start delivery service-time estimate for first-visit or low-history stops using building floors, elevator, parking and access evidence. Useful for routing, dispatch and ETA. x402 launch price: $0.01 USDC per successful call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"deliveryMode":{"type":"string","enum":["WALKING","BICYCLE","MOTORCYCLE","CAR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","deliveryMode"]}}}},"responses":{"200":{"description":"Service-time estimate"},"402":{"description":"x402 payment required"}}}},"/korea-building/opportunity-intelligence":{"get":{"summary":"Korea building opportunity pulse","description":"Zero-input current Korea building-upgrade opportunity pulse for autonomous agents. Returns up to 5 open projects ranked by deadline urgency and sales-action context. $0.01 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Current opportunity pulse"},"402":{"description":"x402 payment required"}}},"post":{"summary":"Korea building opportunity intelligence","description":"Current Korea building-upgrade opportunity signals with category, deadline urgency, sales-action context and field checks. First-payer launch price: $0.01 USDC per successful query.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","maxLength":30},"category":{"type":"string","enum":["ACCESS_CONTROL","BIOMETRIC_ACCESS","PARKING_CONTROL","ENTRANCE_SYSTEM","ELEVATOR","BUILDING_SYSTEM"]},"limit":{"type":"integer","minimum":1,"maximum":20},"maxDeadlineDays":{"type":"integer","minimum":1,"maximum":60}}}}}},"responses":{"200":{"description":"Opportunity intelligence"},"402":{"description":"x402 payment required"}}}},"/korea-address/reverse-geocode":{"get":{"summary":"Reverse Geocode Korea","description":"Reverse-geocode Korean latitude/longitude coordinates to the nearest canonical address and building facts. Returns building name, distance, floors, elevator evidence and nearby parking when available. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}}],"responses":{"200":{"description":"Nearest Korean address and building facts","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"normalizedAddress":{"type":["string","null"]},"buildingName":{"type":["string","null"]},"distanceMeters":{"type":["number","null"]},"floorsAbove":{"type":["integer","null"]},"elevator":{"type":["boolean","null"]}},"required":["ok"]}}}},"402":{"description":"x402 payment required"}}}},"/korea-address/geocode":{"post":{"summary":"Geocode Address Korea","description":"Forward-geocode a Korean address to latitude/longitude and canonical address, with building name, floors, elevator evidence and nearby parking when available. Built for AI agents and repeated location enrichment. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300}},"required":["address"]}}}},"responses":{"200":{"description":"Korean address geocode and building facts","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"normalizedAddress":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"buildingName":{"type":["string","null"]},"floorsAbove":{"type":["integer","null"]},"floorsBelow":{"type":["integer","null"]},"elevator":{"type":["boolean","null"]}},"required":["ok"]}}}},"402":{"description":"x402 payment required"}}}},"/geocode_address":{"post":{"summary":"Geocode Address — Korea address to coordinates + building facts","description":"Geocode address in Korea to latitude/longitude, canonical address and building facts. Optimized for AI agents, mapping, delivery and field service. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300}},"required":["address"]}}}},"responses":{"200":{"description":"Korean address geocode and building facts"},"402":{"description":"x402 payment required"}}}},"/geocode":{"post":{"summary":"Geocode","description":"Geocode a Korean address to latitude/longitude, canonical address and building facts. Exact short route for AI-agent discovery. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300}},"required":["address"]}}}},"responses":{"200":{"description":"Korean address geocode and building facts"},"402":{"description":"x402 payment required"}}}},"/geocode-address":{"post":{"summary":"Geocode Address","description":"Geocode Address in Korea to latitude/longitude, canonical address and building facts. Exact short route for AI-agent discovery. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300}},"required":["address"]}}}},"responses":{"200":{"description":"Korean address geocode and building facts"},"402":{"description":"x402 payment required"}}}},"/korea-building/geocode-address":{"post":{"summary":"Korea Building Geocode Address — coordinates, floors, elevator","description":"Convert a Korean address to latitude/longitude and canonical address plus building name, floors above/below and elevator evidence when available. Narrow Korea building-enrichment route for mapping, delivery, field-service and property agents. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300}},"required":["address"]}}}},"responses":{"200":{"description":"Korean address coordinates and building facts","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"normalizedAddress":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"buildingName":{"type":["string","null"]},"floorsAbove":{"type":["integer","null"]},"floorsBelow":{"type":["integer","null"]},"elevator":{"type":["boolean","null"]}},"required":["ok"]}}}},"402":{"description":"x402 payment required"}}}},"/korea-address/normalize":{"post":{"summary":"Korea address normalize and building lookup","description":"Resolve a Korean address into canonical address, building name, coordinates, floors, elevator evidence and nearby parking. Deterministic x402 utility for mapping, delivery, property and field-service agents. Price: $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":3,"maxLength":300},"normalizedAddress":{"type":"string","minLength":3,"maxLength":300}},"anyOf":[{"required":["address"]},{"required":["normalizedAddress"]}]}}}},"responses":{"200":{"description":"Normalized Korean address and building facts"},"402":{"description":"x402 payment required"}}}},"/korea-site/report":{"get":{"summary":"Korea Site & Building Report — address enrichment for AI agents","description":"One-call South Korea site and building enrichment for delivery, field service, robotics, mapping and property workflows. Returns canonical address, coordinates, building name/type, floors, elevator evidence, nearby parking, access signals and field-readiness context. Price: $0.01 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":300},"example":"서울특별시 관악구 미성3길 50"}],"responses":{"200":{"description":"Korea site and building report","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"product":{"type":"string"},"query":{"type":"string"},"matchStatus":{"type":["string","null"]},"normalizedAddress":{"type":["string","null"]},"coordinates":{"type":"object","properties":{"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}},"building":{"type":"object","properties":{"name":{"type":["string","null"]},"type":{"type":["string","null"]},"floorsAbove":{"type":["integer","null"]},"floorsBelow":{"type":["integer","null"]}}},"access":{"type":"object","properties":{"elevator":{"type":["boolean","null"]},"nearbyParking":{},"steepHill":{}}},"fieldReadiness":{"type":"object"},"confidence":{},"evidence":{"type":"array"},"scope":{"type":"object"}},"required":["ok","product","query","coordinates","building","access","fieldReadiness","evidence","scope"]}}}},"402":{"description":"x402 payment required"}}}},"/korea-building/access-profile":{"post":{"summary":"Korea address to building facts — floors, elevator, parking, access","description":"Low-friction entry route for AI agents resolving a Korean address into building access facts: building type, floors, footprint, elevator evidence, nearby parking and steep-hill signal. Seller-proving price: $0.001 USDC per successful call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300}},"required":["normalizedAddress"]}}}},"responses":{"200":{"description":"Building access profile"},"402":{"description":"x402 payment required"}}}},"/korea-physical/execution-pack":{"post":{"summary":"Korea Field Ops Preflight Pack (up to 10 stops)","description":"Autonomous-agent friendly Korea/Seoul pre-dispatch readiness for up to 10 delivery, field-service or robotics stops. Returns per-stop GO/HOLD/MEASURE/BLOCK and risk ranking. x402 price: $0.49 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.49"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["HUMAN_COURIER","FIELD_TECHNICIAN","DELIVERY_ROBOT","SERVICE_ROBOT"]},"action":{"type":"string","enum":["DELIVER_TO_ENTRANCE","DELIVER_TO_FLOOR","SITE_VISIT","ROBOT_ENTER","ROBOT_MOVE_TO_FLOOR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}},"required":["items"]}}}},"responses":{"200":{"description":"10-stop field ops preflight pack"},"402":{"description":"x402 payment required"}}}},"/korea-physical/execution-batch":{"post":{"summary":"Korea Field Ops Preflight Batch (up to 25 stops)","description":"Batch pre-dispatch execution readiness for Korea/Seoul delivery, field-service and robotics stops. Returns per-stop GO/HOLD/MEASURE/BLOCK plus highest-risk stops. x402 price: $2.90 USDC per successful batch.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"2.90"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["HUMAN_COURIER","FIELD_TECHNICIAN","DELIVERY_ROBOT","SERVICE_ROBOT"]},"action":{"type":"string","enum":["DELIVER_TO_ENTRANCE","DELIVER_TO_FLOOR","SITE_VISIT","ROBOT_ENTER","ROBOT_MOVE_TO_FLOOR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}},"required":["items"]}}}},"responses":{"200":{"description":"Batch physical execution readiness"},"402":{"description":"x402 payment required"}}}},"/logistics/mae-sot-myawaddy-status":{"get":{"summary":"Mae Sot–Myawaddy corridor status","description":"Zero-input Thailand-Myanmar Mae Sot/Myawaddy operational corridor status for freight and trade agents. Returns current state, as-of time, confidence and evidence. $0.001 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Current corridor status"},"402":{"description":"x402 payment required"}}}},"/logistics/corridor-decision":{"post":{"summary":"Thailand-Myanmar shipment corridor decision","description":"Mae Sot/Myawaddy shipment execution preflight. Returns GO, HOLD, VERIFY_LICENSE or BLOCK. First-organic-buyer bootstrap price: $0.005 USDC per successful x402 call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"corridorKey":{"type":"string","enum":["TH_MM_MAE_SOT_MYAWADDY"]},"cargoDescription":{"type":"string","minLength":2,"maxLength":300},"importLicenseStatus":{"type":"string","enum":["APPROVED","NOT_REQUIRED","PENDING","UNKNOWN"]},"importerExporterRegistrationStatus":{"type":"string","enum":["VALID","INVALID","UNKNOWN"]},"localRouteConfirmation":{"type":"string","enum":["CONFIRMED","NOT_CONFIRMED","BLOCKED"]}},"required":["cargoDescription"]}}}},"responses":{"200":{"description":"Shipment corridor execution decision","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"product":{"type":"string"},"launchPriceUsd":{"type":"number"},"modeledProvenPriceUsd":{"type":"number"},"decision":{"type":"string","enum":["GO","HOLD","VERIFY_LICENSE","BLOCK"]},"corridorKey":{"type":"string"},"cargoDescription":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"requiredChecks":{"type":"array","items":{"type":"string"}},"corridor":{"type":"object","properties":{"originCountry":{"type":"string"},"destinationCountry":{"type":"string"},"gateway":{"type":"string"},"operationalState":{"type":"string"},"asOf":{"type":"string"},"confidence":{"type":"number"}}},"scope":{"type":"object","properties":{"coverage":{"type":"string"},"decisionMeaning":{"type":"string"}}}},"required":["ok","product","decision","corridorKey","reasons","requiredChecks","corridor","scope"]}}}},"402":{"description":"x402 payment required"}}}},"/korea-field-service/pre-dispatch":{"post":{"summary":"Korea field-service pre-dispatch check — 1 stop","description":"Low-cost trust-entry route for an AI agent deciding whether a Korean field-service visit is ready before dispatch. Same evidence-bounded engine as physical execution context. x402 price: $0.005 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["FIELD_TECHNICIAN"]},"action":{"type":"string","enum":["SITE_VISIT"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}}},"responses":{"200":{"description":"Field-service pre-dispatch readiness decision"},"402":{"description":"x402 payment required"}}}},"/korea-delivery/pre-dispatch":{"post":{"summary":"Korea delivery pre-dispatch check — 1 stop","description":"Low-cost trust-entry route for courier, dispatch and delivery agents checking one Korean stop before arrival. Same evidence-bounded engine as physical execution context. x402 price: $0.005 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["HUMAN_COURIER"]},"action":{"type":"string","enum":["DELIVER_TO_ENTRANCE","DELIVER_TO_FLOOR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}}},"responses":{"200":{"description":"Delivery pre-dispatch readiness decision"},"402":{"description":"x402 payment required"}}}},"/logistics/delivery-stop-readiness":{"post":{"summary":"Korea delivery stop readiness — 1 stop","description":"One-stop delivery and dispatch readiness check for Korea using building floors, elevator, nearby parking and access evidence. Returns GO, HOLD, MEASURE or BLOCK. x402 price: $0.005 USDC.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["HUMAN_COURIER"]},"action":{"type":"string","enum":["DELIVER_TO_ENTRANCE","DELIVER_TO_FLOOR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}}},"responses":{"200":{"description":"Delivery stop readiness decision"},"402":{"description":"x402 payment required"}}}},"/korea-physical/execution-context":{"post":{"summary":"Korea field-service pre-dispatch & delivery execution readiness — 1 stop","description":"Korea/Seoul field-service pre-dispatch, courier delivery-site and robotics execution readiness for one stop. Returns GO, HOLD, MEASURE or BLOCK from building, elevator, access and service-time evidence. Use before dispatch or arrival. First-organic-buyer bootstrap price: $0.005 USDC per successful x402 call.","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"normalizedAddress":{"type":"string","minLength":3,"maxLength":300},"actorType":{"type":"string","enum":["HUMAN_COURIER","FIELD_TECHNICIAN","DELIVERY_ROBOT","SERVICE_ROBOT"]},"action":{"type":"string","enum":["DELIVER_TO_ENTRANCE","DELIVER_TO_FLOOR","SITE_VISIT","ROBOT_ENTER","ROBOT_MOVE_TO_FLOOR"]},"targetFloor":{"type":"integer","minimum":-10,"maximum":200},"packageClass":{"type":"string","enum":["SMALL","MEDIUM","LARGE"]}},"required":["normalizedAddress","actorType","action"]}}}},"responses":{"200":{"description":"Physical execution readiness decision","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"decision":{"type":"string","enum":["GO","HOLD","MEASURE","BLOCK"]},"actorType":{"type":"string"},"action":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"unknowns":{"type":"array","items":{"type":"string"}},"requiredChecks":{"type":"array","items":{"type":"string"}},"building":{"type":["object","null"]},"match":{"type":["object","null"]},"access":{"type":["object","null"]},"serviceTime":{},"confidence":{"type":"object"},"evidence":{"type":"object"},"scope":{"type":"object","properties":{"country":{"type":"string"},"coverage":{"type":"string"},"decisionMeaning":{"type":"string"}}},"nextPaidActions":{"type":"array","items":{"type":"object"}}},"required":["ok","decision","actorType","action","reasons","unknowns","requiredChecks","scope"]}}}},"402":{"description":"x402 payment required"}}}}}}