Option roll credit / debit API

Compute the net per-share and total across contracts of rolling a short option (new premium received minus cost to close), classifying it as a credit, debit, or even roll. Deterministic roll math. Answers 'is this roll a credit or debit','how much do I net rolling out','should I roll this option'.

Price$0.03per request

MethodPOST

Route/v1/calc/opt-roll-credit

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

optionsrollcalccreditdebitincomederivativestrading

API URLhttps://x402.hexl.dev/v1/calc/opt-roll-credit

Integration docs

Example request

{
  "closeCost": 1.2,
  "newPremium": 2
}

Example response

{
  "closeCost": 1.2,
  "newPremium": 2,
  "contracts": 1,
  "multiplier": 100,
  "netPerShare": 0.8,
  "netTotal": 80,
  "result": "credit",
  "rollAdvice": "Roll keeps you in for a credit (improves cost basis)."
}

Input schema

{
  "type": "object",
  "required": [
    "closeCost",
    "newPremium"
  ],
  "properties": {
    "closeCost": {
      "type": "number",
      "description": "cost to buy back the current short",
      "examples": [
        1.2
      ]
    },
    "newPremium": {
      "type": "number",
      "description": "credit from the new short",
      "examples": [
        2
      ]
    },
    "contracts": {
      "type": "number",
      "default": 1
    },
    "multiplier": {
      "type": "number",
      "default": 100
    }
  }
}

Output schema

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