{"uid":"cap_cHamizehEJMotQGpTxlEU","slug":"fastx402-semver-match-0b993871","name":"FastX402 Semver Match","description":"146 pay-per-call tools for AI agents, from $0.001 per request in USDC on Base or Solana with x402. No account, no API key.","url":"https://fastx402.tools/semver-match?utm_source=zero.xyz","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":["versions","constraint"],"properties":{"versions":{"type":"string","description":"Comma-separated semantic versions, e.g. 1.2.3,2.0.0-rc.1 (max 200)"},"constraint":{"type":"string","description":"Semver range: ^, ~, >, >=, <, <=, =, x-ranges, hyphen ranges, space for AND, || for OR (max 200 chars)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"checked":{"type":"integer"},"highest":{"type":"string"},"matches":{"type":"array","items":{"type":"string"}},"constraint":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"count":2,"checked":6,"highest":"2.5.1","matches":["2.4.0","2.5.1"],"constraint":"^2.4.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_chbBghkrBkdaXZRGFXaLF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a list of semantic versions and a semver range constraint, returns which versions satisfy the constraint along with the highest matching version and match count.","exampleAgentPrompt":"From these versions — 1.0.0, 1.2.3, 2.0.0, 2.4.0, 2.5.1, 3.0.0 — which ones satisfy the constraint ^2.4.0, and what's the highest match?","exampleUseCases":[{"title":"Dependency version resolution","prompt":"I have these available versions of a library: 1.8.0, 2.0.0-rc.1, 2.0.0, 2.1.3, 2.3.0, 3.0.0. Which ones are compatible with the constraint >=2.0.0 <3.0.0, and what's the highest one I can safely use?"},{"title":"Patch-compatible release filtering","prompt":"We publish new SDK releases and need to know which of these versions — 1.4.0, 1.4.1, 1.4.9, 1.5.0, 2.0.0 — fall within the ~1.4.0 tilde range. Can you check?"},{"title":"Pre-release candidate vetting","prompt":"Our CI pipeline has these candidate builds: 3.0.0-alpha.1, 3.0.0-beta.2, 3.0.0-rc.1, 3.0.0, 3.1.0. Which ones match the constraint >=3.0.0-rc.1 and what is the highest passing version?"}],"resultDescription":"A JSON object containing: the constraint string echoed back, the total number of versions checked, the count of matching versions, an array of the matching version strings, and the highest (latest) version among the matches.","failureModes":["Malformed semver strings in the versions list may cause parsing errors or be skipped","Invalid constraint syntax returns an error response","More than 200 characters in constraint or versions string may be rejected","Pre-release version matching can produce unexpected results if constraint does not explicitly include pre-release tags","No matches found returns an empty matches array with count 0"],"whenToPreferThis":"Use this endpoint when you need to programmatically evaluate which versions from a known set satisfy a semver range — ideal for CI/CD pipelines, dependency resolution logic, release automation, or any agent workflow that needs to pick the best compatible version from a list without spinning up a local Node.js/semver environment. Prefer this over general-purpose code execution when the task is purely semver filtering and you want a fast, cheap, stateless call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:41:00.212Z","isFirstParty":false,"canonicalSlug":"fastx402-semver-match-0b993871"}