{"uid":"cap_cdkgvq_qaqumDrOxcgXDn","slug":"bicycle-climb-gradient-vam-calculator-1ceaf0dc","name":"Bicycle Climb Gradient & VAM Calculator","description":"Gradient percent and angle from rise and distance, plus climbing rate (VAM) and the time to climb at a given rate.","url":"https://bike-calc.x402tookit.com/climb-gradient?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":["riseMeters","distanceMeters"],"properties":{"vam":{"type":"number","description":"Climbing rate in metres per hour, to get the time (default 1000)"},"riseMeters":{"type":"number","description":"Vertical gain in metres"},"timeMinutes":{"type":"number","description":"Time taken in minutes, to get the VAM instead"},"distanceMeters":{"type":"number","description":"Distance along the road in metres (horizontal run is derived)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"category":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"riseMeters":{"type":["null","number"]},"feetClimbed":{"type":["null","number"]},"angleDegrees":{"type":["null","number"]},"gradePercent":{"type":["null","number"]},"minutesToClimb":{"type":["null","number"]},"averageSpeedKmh":{"type":["null","number"]},"vamMetersPerHour":{"type":["null","number"]},"roadDistanceMeters":{"type":["null","number"]},"horizontalRunMeters":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XDj-GWqP9FgzsO7y_AxmD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates gradient percent and angle from rise and distance, plus climbing rate (VAM) and time to climb at a given rate.","exampleAgentPrompt":"What's the gradient percent and angle for a climb with 350 metres of vertical gain over 4500 metres of road distance, and how long would it take to ride at a VAM of 900?","exampleUseCases":[{"title":"Pre-ride climb difficulty check","prompt":"I'm planning to ride Alpe d'Huez — it rises about 1120 metres over 14 kilometres of road. What's the gradient percent and angle, and how long would it take me to climb it if I can hold a VAM of 1000?"},{"title":"Segment steepness from GPS data","prompt":"My GPS recorded a segment with 80 metres of rise over 600 metres of road distance. Can you tell me the grade percent and angle in degrees so I know how steep that section was?"},{"title":"Training VAM back-calculation","prompt":"I climbed 500 metres of elevation over 8000 metres of road and it took me 45 minutes. What VAM did I average, and what was the gradient percent and angle of the climb?"}],"resultDescription":"Returns grade percent, angle in degrees, feet climbed, horizontal run in metres, road distance in metres, VAM in metres per hour, average speed in km/h, and minutes to climb — along with metadata fields like summary, verdict, category, and disclaimer.","failureModes":["Missing required riseMeters or distanceMeters parameters returns an error","Non-numeric values for numeric parameters cause validation failure","Extremely large or zero/negative distance values may produce undefined or error responses","VAM of zero would cause division-by-zero for time calculation"],"whenToPreferThis":"Choose this endpoint when you need to compute cycling climb metrics — gradient, angle, VAM, or climb time — from raw rise and distance figures. It is purpose-built for cycling fitness and route analysis, combining geometric gradient calculation with sport-specific metrics like VAM in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:30:43.814Z","isFirstParty":false,"canonicalSlug":"bicycle-climb-gradient-vam-calculator-1ceaf0dc"}