{"openapi":"3.0.3","info":{"title":"ForgeMesh Fare Intelligence","version":"1.0.0","description":"Agent-payable travel fare intelligence API. Requires x402 micro-payment ($0.10 USDC per query) or X-Payment-Validated header set by a trusted facilitator.","contact":{"url":"https://forgemesh.io"},"x-x402-price":"$0.10","x-x402-network":"base","x-x402-payto":"0x6B1aC7935DAD576b921af0E6EDC27319bc27AAdD"},"servers":[{"url":"https://travel.forgemesh.io","description":"Production"}],"paths":{"/api/fare-intelligence":{"get":{"summary":"Get fare intelligence for a flight route","description":"Returns price observations, historical medians, and buy/wait recommendations. Requires x402 payment or validated payment header.","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string","example":"JFK"},"description":"3-letter IATA airport code"},{"name":"destination","in":"query","required":true,"schema":{"type":"string","example":"LAX"},"description":"3-letter IATA airport code"},{"name":"departure_at","in":"query","required":false,"schema":{"type":"string","example":"2025-09"},"description":"YYYY-MM or YYYY-MM-DD"},{"name":"return_at","in":"query","required":false,"schema":{"type":"string","example":"2025-09-14"},"description":"Round-trip return date"},{"name":"currency","in":"query","required":false,"schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code"},{"name":"market","in":"query","required":false,"schema":{"type":"string","default":"us"},"description":"ISO 3166-1 market code"}],"responses":{"200":{"description":"Fare intelligence data","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"origin":{"type":"string"},"destination":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string"},"found_at":{"type":"string","format":"date-time"},"historical_median":{"type":"number"},"recommendation":{"type":"string","enum":["buy_now","wait","flexible"]},"confidence":{"type":"number"}}}},"count":{"type":"integer"},"provider":{"type":"string"}}}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"Payment required — x402 challenge body"},"404":{"description":"No fare data found for route"},"429":{"description":"Rate limit exceeded"},"502":{"description":"Upstream provider error"},"504":{"description":"Upstream provider timeout"}},"x-x402":{"scheme":"exact","network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxAmountRequired":"100000","currency":"USDC","payTo":"0x6B1aC7935DAD576b921af0E6EDC27319bc27AAdD"}}}}}