Dynamic surge multiplier API

Maps a demand/utilization ratio to a stepped surge multiplier (with an optional cap) and returns the surged price and surcharge. Answers 'What surge multiplier applies at 1.6x demand?', 'What is the surged price and surcharge?'.

Price$0.02per request

MethodPOST

Route/v1/commerce/surge-pricing

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

commercepricingsurgedynamicdemandmultiplierride-sharepeak

API URLhttps://x402.hexl.dev/v1/commerce/surge-pricing

Integration docs

Example request

{
  "basePrice": 20,
  "demandRatio": 1.6
}

Example response

{
  "basePrice": 20,
  "demandRatio": 1.6,
  "multiplier": 2,
  "multiplierCapped": false,
  "bandAtOrAbove": 1.5,
  "surgedPrice": 40,
  "surcharge": 20,
  "interpretation": "Demand ratio 1.6 -> 2× surge; price $20 -> $40."
}

Input schema

{
  "type": "object",
  "required": [
    "basePrice",
    "demandRatio"
  ],
  "properties": {
    "basePrice": {
      "type": "number",
      "examples": [
        20
      ]
    },
    "demandRatio": {
      "type": "number",
      "examples": [
        1.6
      ]
    },
    "maxMultiplier": {
      "type": "number",
      "examples": [
        3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}