Know what changed before your integration breaks.
Compare two OpenAPI contracts. Get every breaking change, the evidence and a recommended fix. Built for coding agents.
POST https://x402.bankr.bot/0xb98f0de777eea8c481b64e33d3e0066cea38fa91/breakra-analyze
Real example
{
"before": {
"openapi": "3.0.3",
"paths": { "/orders": { "get": {
"parameters": [ { "name": "limit", … } ]
} }, … }
},
"after": {
"openapi": "3.0.3",
"paths": { "/orders": { "get": {
"parameters": [ { "name": "limit", … },
{ "name": "customer_id", "in": "query",
"required": true, … } ]
} }, … }
}
}
{
"compatibility": "breaking",
"summary": { "total_changes": 15, "breaking": 1,
"potentially_breaking": 10, … },
"changes": [ …, {
"id": "change-002",
"compatibility": "potentially_breaking",
"operation": { "method": "GET", "path": "/orders" },
"location": { "in": "query", "name": "customer_id" },
"reason": "A new required query parameter `customer_id` was added to GET /orders. Callers that do not send it may be rejected.",
"recommended_action": "Update callers of GET /orders to send `customer_id`."
}, … ]
}
Breaking
Potentially breaking
Compatible
Same inputs → same analysis_id. Full output ↗
curl -i -X POST -H 'content-type: application/json' --data @examples/request.json https://x402.bankr.bot/0xb98f0de777eea8c481b64e33d3e0066cea38fa91/breakra-analyze
Without payment this returns 402 with the x402 terms. Pay with any x402 client, or the one in examples/client.ts.
How it works
- 01
Send two contracts
The old and new OpenAPI 3.0 JSON, inline, in one
POST. - 02
Pay $0.02 via x402
Check the terms, sign once. Errors are never charged.
- 03
Fix what may break
Every change with its rule, location, evidence and a recommended fix.
Details
- Input
- OpenAPI 3.0.0–3.0.4 JSON, inline, ≤ 1 MB
- Price
- $0.02 USDC on Base, only on a
200 - Output
breaking·potentially_breaking·unknown·compatible·non_contract- Results
- Deterministic: the same inputs always give the same findings
- Privacy
- Specs are never stored or logged; external
$refs are never fetched - Agents
- Point your agent at breakra.dev/skill.md: when to call, how to pay safely, how to read results. Contract: /openapi.json