{"openapi":"3.1.0","info":{"title":"un-comtrade-preview","version":"0.1.0","description":"listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.","x-guidance":"POST /v1/un-comtrade-preview with application/json per requestBody schema. Unauthenticated probes receive HTTP 402 (x402 exact USDC on Base / eip155:8453). After payment settles, empty or invalid bodies return 400 with charged:false. Free health: GET /healthz and GET /readyz. Contact nicsins@gmail.com.","contact":{"email":"nicsins@gmail.com"}},"paths":{"/v1/un-comtrade-preview":{"post":{"operationId":"un_comtrade_preview","summary":"UN Comtrade public preview trade data (keyless). POST {reporterCode,period,partnerCode,cmdCode,flowCode} (+ optional typeCode/freqCode/clCode/maxRecords). Unpaid empty → 402; after settle empty/invalid → 400 charged:false. New trade vertical; no catalog adjacency.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020150"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"reporterCode":{"type":["string","integer"]},"period":{"type":["string","integer"]},"partnerCode":{"type":["string","integer"]},"cmdCode":{"type":"string","maxLength":32},"flowCode":{"type":"string","maxLength":8},"typeCode":{"type":"string","maxLength":8},"freqCode":{"type":"string","maxLength":8},"clCode":{"type":"string","maxLength":8},"maxRecords":{"type":["integer","string"]},"request_id":{"type":"string"}},"required":["reporterCode","period","partnerCode","cmdCode","flowCode"]}}}},"responses":{"200":{"description":"ok envelope","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"skill":{"type":"string"},"charged":{"type":"boolean"},"summary":{"type":"string"},"data":{},"request_id":{"type":"string"}},"required":["ok"]}}}},"400":{"description":"empty/invalid after settle — charged:false"},"402":{"description":"payment required"},"503":{"description":"service disabled (kill-switch)"}}}},"/healthz":{"get":{"operationId":"healthz","security":[],"summary":"Liveness","responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/readyz":{"get":{"operationId":"readyz","security":[],"summary":"Readiness","responses":{"200":{"description":"ready","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"503":{"description":"not ready"}}}}}}