{"version":"1.0","service":"ForgeMesh Fare Intelligence","description":"Agent-payable travel fare intelligence. Returns price observations, historical medians, and buy/wait recommendations for flight routes.","contact":"https://forgemesh.io","discovery":"https://travel.forgemesh.io/.well-known/x402.json","capabilities":{"queryParams":[{"name":"origin","type":"string","required":true,"description":"3-letter IATA airport code (uppercase)","example":"JFK"},{"name":"destination","type":"string","required":true,"description":"3-letter IATA airport code (uppercase)","example":"LAX"},{"name":"departure_at","type":"string","required":false,"description":"Departure month (YYYY-MM) or date (YYYY-MM-DD)","example":"2025-09"},{"name":"return_at","type":"string","required":false,"description":"Return date for round-trip (YYYY-MM or YYYY-MM-DD). Must not precede departure_at when both are full dates.","example":"2025-09-14"},{"name":"currency","type":"string","required":false,"default":"USD","description":"ISO 4217 currency code (3-letter uppercase)","example":"EUR"},{"name":"market","type":"string","required":false,"default":"us","description":"ISO 3166-1 market code (2-letter lowercase)","example":"gb"}],"rateLimits":{"unpaidRequestsPerWindow":10,"paidRequestsPerWindow":120,"windowSeconds":60,"headers":["x-ratelimit-limit","x-ratelimit-remaining","x-ratelimit-reset"]}},"pricing":{"perQuery":{"amount":"100000","asset":"USDC","decimals":6,"humanReadable":"$0.10"},"network":"base","payTo":{"evm":"0x6B1aC7935DAD576b921af0E6EDC27319bc27AAdD"}},"endpoints":[{"path":"/api/fare-intelligence","method":"GET","description":"Fare intelligence for a route. Returns price, historical median, and buy/wait recommendation.","payment":{"scheme":"exact","network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxAmountRequired":"100000","currency":"USDC","humanReadablePrice":"$0.10 per query","payTo":"0x6B1aC7935DAD576b921af0E6EDC27319bc27AAdD"},"responses":{"200":"Fare data returned","400":"Invalid query parameters","402":"Payment required — x402 challenge body returned","404":"No fare data found for route","429":"Rate limit exceeded","502":"Upstream provider error","504":"Upstream provider timeout"}}],"examples":{"unpaidFlow":{"description":"Agent sends request without payment — service returns 402 with payment instructions","request":"GET /api/fare-intelligence?origin=JFK&destination=LAX","response":{"status":402,"body":{"error":"Payment Required","x402Version":1,"accepts":[{"scheme":"exact","network":"base","maxAmountRequired":"100000","resource":"/api/fare-intelligence","payTo":"0x6B1aC7935DAD576b921af0E6EDC27319bc27AAdD","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}}},"paidFlow":{"description":"Agent pays via x402 facilitator — facilitator sets X-Payment-Validated: true","request":"GET /api/fare-intelligence?origin=JFK&destination=LAX  X-Payment-Validated: true","response":{"status":200,"body":{"data":[{"origin":"JFK","destination":"LAX","price":189,"currency":"USD","found_at":"2025-09-01T00:00:00.000Z","historical_median":211,"recommendation":"buy_now","confidence":0.75}],"count":1,"provider":"travel_search"}}}},"futureIntegrations":["Additional travel search integrations"]}