{"tool":"deps-compare","title":"DependencyPulse Release Compare","what":"What changes between two releases of a package, from registry metadata: dependencies added, removed and re-ranged, licence change, deprecation, publish dates and the releases in between, and which OSV advisories the upgrade fixes, introduces or leaves open. Registry metadata only: a source-code diff is not claimed.","endpoint":"https://yruz.one/api/deps/compare","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.008"},"params":[{"name":"name","required":true,"description":"package name","example":"lodash"},{"name":"from","required":true,"description":"current version, e.g. 4.17.15","example":"4.17.15"},{"name":"to","required":false,"description":"target version (default: latest)","example":"4.17.21"},{"name":"ecosystem","required":false,"description":"npm (default), pypi or composer","example":"npm"}],"valid_request":{"get":"https://yruz.one/api/deps/compare?ecosystem=npm&name=lodash&from=4.17.15&to=4.17.21","post":{"url":"https://yruz.one/api/deps/compare","body":{"ecosystem":"npm","name":"lodash","from":"4.17.15","to":"4.17.21"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"product":"string","task":"string","task_version":"number","api_version":"string","data":{"package":{"ecosystem":"string","name":"string","latest":"string"},"from":{"version":"string","published_at":"string","deprecated_or_yanked":"null","licence_declared":"string"},"to":{"version":"string","published_at":"string","deprecated_or_yanked":"null","licence_declared":"string"},"direction":"string","releases_between":"number","days_between":"number","licence_changed":"boolean","dependencies":{"added":[],"removed":[],"range_changed":[],"unchanged":"number"},"advisories":{"fixed_by_change":[{"…":"…"}],"introduced_by_change":[],"affecting_both":[{"…":"…"}],"from_status":"string","to_status":"string","note":"string"},"source_diff":{"available":"boolean","note":"string","repository_compare":{"url":"string","status":"string","note":"string"}}},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":["string"],"retrieved_at":"string","retrieved_until":"string","served_from_cache":"boolean","licence":"string","attribution":"string"}],"data_as_of":"string","freshness_status":"string","coverage":"null","partial":"boolean","warnings":[],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"}},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"deps-check","url":"https://yruz.one/api/deps/check","why":"advisories of one package version","usd":"0.005","how":"https://yruz.one/api/instructions?tool=deps-check"},{"tool":"deps-batch","url":"https://yruz.one/api/deps/batch","why":"many package versions at 0.002 each","usd":"0.01","how":"https://yruz.one/api/instructions?tool=deps-batch"},{"tool":"deps-audit","url":"https://yruz.one/api/deps/audit","why":"a whole lockfile","usd":"0.025","how":"https://yruz.one/api/instructions?tool=deps-audit"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}