{"uid":"cap_5qg6vs6OrlQsXfek6XxA-","slug":"fastx402-lab-semver-match-02bb1461","name":"FastX402 Lab Semver Match","description":"FastX402 Lab: small pay-per-call tools for AI agents, paid per request in USDC on Base over x402. No signup, no API key.","url":"https://lab.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_DVx_WmgjWvczlWNDtfBp8","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":"Filters a list of semantic versions against a semver range constraint, returning all matching versions plus the highest match","exampleAgentPrompt":"From this list of versions — 1.0.0, 1.2.3, 2.0.0, 2.4.0, 2.5.1, 3.0.0 — which ones satisfy the semver range ^2.4.0, and which is the highest match?","exampleUseCases":[{"title":"Package upgrade compatibility check","prompt":"I have these library versions available: 1.8.0, 2.0.0, 2.1.5, 2.3.0, 3.0.0-beta.1 — which ones are compatible with the constraint >=2.0.0 <3.0.0, and what's the highest one I can upgrade to?"},{"title":"Release candidate validation","prompt":"Can you check which of these release candidates — 1.0.0-rc.1, 1.0.0-rc.2, 1.0.0-rc.3, 1.1.0-rc.1 — satisfy the range ~1.0.0-rc, and tell me the highest matching one?"},{"title":"Dependency resolution for CI pipeline","prompt":"My CI pipeline needs to pick a build tool version. From this list: 4.0.0, 4.1.0, 4.2.3, 5.0.0, 5.1.0, I need all versions that satisfy ^4.1.0. Which ones match and what's the highest?"}],"resultDescription":"Returns a JSON object with: the constraint string used, total versions checked, count of matches, an array of all matching version strings, and the highest matching version string.","failureModes":["Invalid semver range syntax returns an error or empty match set","Malformed version strings in the list may be skipped or cause an error","Exceeding 200 characters for versions or constraint may return a validation error","Payment failure via x402 results in a 402 response with no result","Pre-release version matching behavior may differ from expectations if range does not explicitly include pre-release identifiers"],"whenToPreferThis":"Choose this endpoint when you need to programmatically filter a batch of semantic version strings against a semver range at low cost without setting up any authentication or API keys. Ideal for AI agents performing dependency resolution, CI/CD version selection, or release compatibility checks where a quick pay-per-call model fits better than maintaining a subscription. Prefer this over rolling your own semver logic or calling a full package registry API when you just need range-matching results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:39:11.031Z","isFirstParty":false,"canonicalSlug":"fastx402-lab-semver-match-02bb1461"}