# Vextorium Semver Compare

> Vextorium Semver Compare is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Sorts a list of Semantic Versioning 2.0 version strings, identifies the highest and lowest, computes bump type between two versions, and filters versions matching an npm-style range with the best match.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/semver-compare?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-semver-compare-4c6eda7f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aaNkGr2OUYeZtg4Bq285R

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-semver-compare-4c6eda7f -d '<json body>'
```

Example prompt: Sort these semver versions and tell me the highest, lowest, stable ones, and which ones satisfy the ^1.2.0 range: 1.2.3-beta.2, 1.2.3, 1.10.0, 2.0.0.

## When to prefer this

Use this endpoint when you need server-side semver sorting, filtering, or range matching without bundling a semver library — especially useful in agent pipelines that need to determine the latest compatible release from a list of versions, or validate which versions satisfy a given dependency constraint. Ideal for CI/CD automation, dependency resolution, and release management workflows.

## Known failure modes

- Empty or missing versions array returns an error
- Invalid semver strings (e.g. 'v1.a.b') may be rejected or cause unexpected ordering
- Malformed npm range syntax returns an error or no matches
- Providing more than 500 versions exceeds the limit
- Pre-release ordering edge cases may differ from client-side semver libraries

## How this service works

232 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.

## Output

Returns a JSON object with: sorted array of all versions (ascending), the largest version string, the smallest version string, an array of stable (non-pre-release) versions, and if a range was provided, the range string, the array of versions that satisfy it, and the single best matching version.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "range": {
   "type": "string",
   "description": "npm-style range (optional)"
  },
  "versions": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Versions (1-500)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "range": {
   "best": "1.10.0",
   "pass": [
    "1.2.3",
    "1.10.0"
   ],
   "range": "^1.2.0"
  },
  "sorted": [
   "1.2.3-beta.2",
   "1.2.3"
  ],
  "largest": "2.0.0",
  "smallest": "1.2.3-beta.2",
  "stablecoins": [
   "1.2.3",
   "1.10.0"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-semver-compare-4c6eda7f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)