{"uid":"cap_kTbOYri1Ht0Rjldy7-UAj","slug":"goal402-x402-percha-workers-dev-0916ba6a","name":"Goal402 League Matches","description":"League matches with filtering","url":"https://goal402-x402.percha.workers.dev/leagues/hc/matches","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"League ID"},"limit":{"type":"number","description":"Max results (up to 100)"},"offset":{"type":"number","description":"Pagination offset"},"status":{"type":"string","description":"live | finished | upcoming"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"matches":{"type":"array"},"league_id":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IO3_s3ZbuJaw5-cQeuKLB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves matches for a specific football/soccer league with optional filtering by status and pagination","exampleAgentPrompt":"Show me the upcoming matches for Premier League (league ID 'hc'), up to 20 results.","exampleUseCases":[{"title":"Check live matches across major league","prompt":"What soccer games are happening right now in La Liga? Just show me the ones that are actively playing."},{"title":"Find finished matches for league recap","prompt":"Pull up the last 15 completed matches from the Premier League so I can see the recent results."},{"title":"Upcoming match schedule for planning","prompt":"Get me all the upcoming fixtures for Serie A over the next week, and give me maybe 25 matches to look through."}],"resultDescription":"Returns a JSON object containing the league ID and an array of matches for that league, filterable by status (live, finished, upcoming) with pagination support up to 100 results per call.","failureModes":["Missing required league ID returns validation error","Invalid status value (not live/finished/upcoming) may return empty or error","Limit exceeding 100 may be capped or rejected","Unknown league ID returns empty matches array or 404","Payment not included or insufficient triggers 402 response"],"whenToPreferThis":"Use this endpoint when you need match data scoped to a specific league and want filtering by match status (live, finished, upcoming) or pagination. Prefer this over the 'all live matches' endpoint when you only care about one league, or over team match history when you want a league-wide view.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:37:35.411Z","isFirstParty":false}