CayøLargo
← Back to siteAPI ReferencePricingChangelog
v1.0Swagger ↗

Greeks

Greek ratios

Returns 35 cross-Greek ratios per option across 8 analytical tiers: emergency detection, convexity dynamics, vol regime, cross-derivative intelligence, time decay, surface dynamics, efficiency, and cross-order. These ratios turn raw Greeks into regime-change and convexity signals. All ratios are bounded to prevent overflow and calibrated through 6 rounds of empirical threshold tuning.

GET/v1/greeks/ratioscoreproalpha

Query Parameters

coinstringrequired

Underlying asset. Required.

e.g.BTCETHSOL
instrument_idintegeroptional

Filter by instrument_id (integer PK).

e.g.4812
option_typestringoptional

Filter: call or put.

e.g.callput
fromstringoptional

Start of time range, UTC. ISO 8601. Default: latest snapshot.

e.g.2026-03-08T00:00:00Z
tostringoptional

End of time range, UTC. ISO 8601. Default: now.

e.g.2026-03-09T00:00:00Z
limitintegeroptional

Max rows returned. Default 500. The effective ceiling is your tier row limit, see Tiers and Limits.

e.g.1000

Response Schema

Fields marked pro require a Pro subscription. Fields marked alpha require Alpha.

FieldTypeTierDescription
timestampdatetimecoreSnapshot time in UTC. Aligned to 10-minute boundary.
coinstringcoreUnderlying asset.
instrument_idintegercoreInternal instrument PK.
instrument_namestringcoreDeribit canonical name, e.g. BTC-28MAR26-80000-C.
option_typestringcoreCall or put.
underlying_pricefloatcoreSpot price at snapshot time.
strikefloatcoreStrike price.
days_to_expiryintegercoreCalendar days to expiration.
ivfloatcoreImplied volatility used for ratio computation.
reliability_scoreintegercoreSource data reliability (0-100).
calculation_quality_scoreintegercoreRatio computation quality (0-100). Based on null count and bound saturation.
null_ratio_countintegercoreHow many of the 35 ratios could not be computed (denominator too small).
instability_vanna_ratiofloatalphaIs the gamma-volatility coupling breaking down?
See detail ↓
vannaccel_vanna_ratiofloatalphaHow fast is the price-vol coupling accelerating?
See detail ↓
quatrospeeda_speed_ratiofloatalphaIs the pricing surface becoming hypersensitive to small spot moves?
See detail ↓
echo_vanna_ratiofloatalphaHow sensitive is delta to volatility stress?
See detail ↓
speed_gamma_ratiofloatproHow fast is gamma accelerating relative to its current level?
See detail ↓
gamma_delta_ratiofloatproHow much convexity per unit of directional exposure?
See detail ↓
color_gamma_ratiofloatproHow fast is gamma decaying over time?
See detail ↓
vanna_gamma_ratiofloatproHow strong is the price-vol coupling relative to convexity?
See detail ↓
vomma_vega_ratiofloatproIs vol exposure accelerating or decelerating?
See detail ↓
ultima_vomma_ratiofloatproIs the vol regime approaching an extreme?
See detail ↓
chronomma_vomma_ratiofloatalphaIs time-vol coupling stable?
See detail ↓
volaspeeda_speed_ratiofloatalphaIs convexity stable across vol regimes?
See detail ↓
quatromma_vomma_ratiofloatalphaIs fourth-order vol behavior diverging from second-order?
See detail ↓
zomma_vanna_ratiofloatalphaHow does gamma-vol sensitivity compare to delta-vol sensitivity?
See detail ↓
zomanna_vomma_ratiofloatalphaHow does the vanna-vol relationship compare to vega-vol?
See detail ↓
gammega_vomma_ratiofloatalphaIs convexity stable under vol stress?
See detail ↓
vannacay_vanna_ratiofloatalphaHow fast is vanna decaying relative to its current level?
See detail ↓
charm_delta_ratiofloatalphaHow fast is directional exposure eroding?
See detail ↓
thetanna_theta_ratiofloatalphaIs time decay accelerating or decelerating?
See detail ↓
chronospeeda_speed_ratiofloatalphaHow fast is gamma acceleration decaying over time?
See detail ↓
charisma_charm_ratiofloatalphaIs charm itself accelerating?
See detail ↓
surface_vanna_ratiofloatalphaHow does vol sensitivity move across strikes rather than with spot?
See detail ↓
surface_charm_ratiofloatalphaIs time decay behaving differently across strikes?
See detail ↓
droplet_surface_ratiofloatalphaHow fast is the strike-volatility relationship itself evolving?
See detail ↓
flare_surface_ratiofloatalphaHow does strike-level convexity respond to a vol change?
See detail ↓
halo_vanna_ratiofloatalphaHow does price-vol coupling vary from strike to strike?
See detail ↓
aurora_halo_ratiofloatalphaIs the whole spot-vol-strike structure changing with time?
See detail ↓
alpha_efficiency_ratiofloatalphaHow efficient is gamma scalping on this option?
See detail ↓
alpha_precomputed_ratiofloatalphaDoes our alpha Greek match the efficiency ratio?
See detail ↓
elasticity_delta_ratiofloatalphaHow much leverage per unit of delta?
See detail ↓
rho_vega_ratiofloatalphaHow do interest rate and vol sensitivities compare?
See detail ↓
veta_vega_ratiofloatalphaHow fast is vega decaying relative to its current level?
See detail ↓
second_to_first_order_ratiofloatalphaHow much of the risk has left the linear terms?
See detail ↓
third_to_second_order_ratiofloatalphaIs convexity itself unstable?
See detail ↓
fourth_to_third_order_ratiofloatalphaHas the expansion stopped converging?
See detail ↓

Derived Fields

FieldTypeTiercollapse all
instability_vanna_ratiofloatalphacollapse

Is the gamma-volatility coupling breaking down?

Instability measures how the gamma-vol relationship itself moves with time. Normalising it by vanna asks whether that decay is large relative to the price-vol coupling it is decaying from. A rising ratio means hedges derived from current vanna are losing validity faster than vanna suggests.

Instability / Vanna

instabilityvanna,instability=4VS2σt\frac{\text{instability}}{\text{vanna}}, \quad \text{instability} = \frac{\partial^4 V}{\partial S^2 \partial \sigma \partial t}
RangeBounded to +/-1,000.
vannaccel_vanna_ratiofloatalphacollapse

How fast is the price-vol coupling accelerating?

Vannaccel is the second time derivative of vanna. Against vanna itself it gives the acceleration as a fraction of the current level, which is what tells you whether a coupling shift is settling or still building.

Vannaccel / Vanna

vannaccelvanna,vannaccel=4VSσt2\frac{\text{vannaccel}}{\text{vanna}}, \quad \text{vannaccel} = \frac{\partial^4 V}{\partial S \partial \sigma \partial t^2}
RangeBounded to +/-10,000.
quatrospeeda_speed_ratiofloatalphacollapse

Is the pricing surface becoming hypersensitive to small spot moves?

Fourth-order price sensitivity over third-order. When the ratio grows, each successive order of the spot expansion is contributing more than the last, which is the signature of a surface where a small move no longer produces a small revaluation.

Quatrospeeda / Speed

quatrospeedaspeed,quatrospeeda=4VS4\frac{\text{quatrospeeda}}{\text{speed}}, \quad \text{quatrospeeda} = \frac{\partial^4 V}{\partial S^4}
RangeBounded to +/-100.
echo_vanna_ratiofloatalphacollapse

How sensitive is delta to volatility stress?

Echo carries a second vol derivative where vanna carries one, so the ratio isolates the convex part of the delta response to volatility. High values mean a vol move of twice the size does considerably more than twice the damage to your delta.

Echo / Vanna

echovanna,echo=4VSσ2t\frac{\text{echo}}{\text{vanna}}, \quad \text{echo} = \frac{\partial^4 V}{\partial S \partial \sigma^2 \partial t}
RangeBounded to +/-1,000.
speed_gamma_ratiofloatprocollapse

How fast is gamma accelerating relative to its current level?

Convexity acceleration. High values mean gamma is changing rapidly with spot, requiring more frequent hedge rebalancing. Speed/gamma above 0.08 indicates convexity intensification.

Speed / Gamma

speedγ\frac{\text{speed}}{\gamma}
RangeBounded to +/-10,000.
gamma_delta_ratiofloatprocollapse

How much convexity per unit of directional exposure?

Directional convexity coupling. Tells you whether the position is more "directional" (low ratio) or more "convex" (high ratio). High ratio = gamma-dominant, small spot moves cause large delta swings.

Gamma / Delta

γΔ\frac{\gamma}{\Delta}
RangeBounded to +/-10,000. Can be large for near-ATM options.
color_gamma_ratiofloatprocollapse

How fast is gamma decaying over time?

Time-convexity evolution. Color measures gamma decay rate. This ratio normalizes it to current gamma level. High values near expiry signal rapidly evaporating convexity.

Color / Gamma

colorγ\frac{\text{color}}{\gamma}
RangeBounded to +/-1,000.
vanna_gamma_ratiofloatprocollapse

How strong is the price-vol coupling relative to convexity?

Measures the relative importance of vol-spot correlation vs pure convexity. Can be astronomically large near expiry (BTC values regularly exceed 10,000). Wide bounds for a reason.

Vanna / Gamma

vannaγ\frac{\text{vanna}}{\gamma}
RangeBounded to +/-500,000.
vomma_vega_ratiofloatprocollapse

Is vol exposure accelerating or decelerating?

Volatility sustainability. High ratio = vega accelerates as vol rises (desirable for long vol). Low or negative = vega decelerates (vol exposure is self-limiting).

Vomma / Vega

vommaν\frac{\text{vomma}}{\nu}
RangeBounded to +/-1,000.
ultima_vomma_ratiofloatprocollapse

Is the vol regime approaching an extreme?

Extreme vol detector. When ultima/vomma spikes, vol-of-vol is accelerating beyond what vomma alone can capture. Signals tail-risk hedge preparation.

Ultima / Vomma

ultimavomma\frac{\text{ultima}}{\text{vomma}}
RangeBounded to +/-1,000.
chronomma_vomma_ratiofloatalphacollapse

Is time-vol coupling stable?

Time-volatility regime indicator. Measures whether the vomma structure is stable over time or deteriorating.

Chronomma / Vomma

chronommavomma\frac{\text{chronomma}}{\text{vomma}}
RangeBounded to +/-10,000.
volaspeeda_speed_ratiofloatalphacollapse

Is convexity stable across vol regimes?

Vol-convexity regime stability. Measures whether gamma acceleration (speed) holds up as vol changes. Stable ratio = resilient convexity.

Volaspeeda / Speed

volaspeedaspeed\frac{\text{volaspeeda}}{\text{speed}}
RangeBounded to +/-1,000.
quatromma_vomma_ratiofloatalphacollapse

Is fourth-order vol behavior diverging from second-order?

Fourth-order vol analysis. When quatromma/vomma diverges from ultima/vomma, the vol surface is entering uncharted mathematical territory.

Quatromma / Vomma

quatrommavomma\frac{\text{quatromma}}{\text{vomma}}
RangeBounded to +/-1,000.
zomma_vanna_ratiofloatalphacollapse

How does gamma-vol sensitivity compare to delta-vol sensitivity?

Gamma-vol vs delta-vol coupling. Zomma/vanna above 2.1 indicates regime persistence; below 1.3 signals imminent transition.

Zomma / Vanna

zommavanna\frac{\text{zomma}}{\text{vanna}}
RangeBounded to +/-1,000.
zomanna_vomma_ratiofloatalphacollapse

How does the vanna-vol relationship compare to vega-vol?

Cross-volatility relationship. Measures whether price-vol and pure-vol sensitivities are evolving in sync.

Zomanna / Vomma

zomannavomma\frac{\text{zomanna}}{\text{vomma}}
RangeBounded to +/-1,000.
gammega_vomma_ratiofloatalphacollapse

Is convexity stable under vol stress?

Convexity stability across vol regimes. When gammega/vomma exceeds 0.003 while quatromma/vomma stays below 0.001, convexity holds despite vol stress.

Gammega / Vomma

gammegavomma\frac{\text{gammega}}{\text{vomma}}
RangeBounded to +/-1,000.
vannacay_vanna_ratiofloatalphacollapse

How fast is vanna decaying relative to its current level?

Vanna temporal evolution. Tracks the persistence of the price-vol coupling. If decaying fast, hedges based on current vanna become stale quickly.

Vannacay / Vanna

vannacayvanna\frac{\text{vannacay}}{\text{vanna}}
RangeBounded to +/-1,000.
charm_delta_ratiofloatalphacollapse

How fast is directional exposure eroding?

Time-directional coupling. Charm/delta tells you what fraction of your delta you lose per unit time. Critical for overnight hold decisions.

Charm / Delta

charmΔ\frac{\text{charm}}{\Delta}
RangeBounded to +/-1,000.
thetanna_theta_ratiofloatalphacollapse

Is time decay accelerating or decelerating?

Time decay acceleration. Positive = theta is decelerating (good for short options). Negative = theta is accelerating (danger zone for sellers near expiry).

Thetanna / Theta

thetannaθ\frac{\text{thetanna}}{\theta}
RangeBounded to +/-1,000.
chronospeeda_speed_ratiofloatalphacollapse

How fast is gamma acceleration decaying over time?

Time-convexity evolution. Measures how quickly the speed signal deteriorates, informing gamma scalping exit timing.

Chronospeeda / Speed

chronospeedaspeed\frac{\text{chronospeeda}}{\text{speed}}
RangeBounded to +/-1,000.
charisma_charm_ratiofloatalphacollapse

Is charm itself accelerating?

Charm acceleration. When this spikes, delta is about to change direction or magnitude suddenly. Second-order time-directional warning.

Charisma / Charm

charismacharm\frac{\text{charisma}}{\text{charm}}
RangeBounded to +/-1,000.
surface_vanna_ratiofloatalphacollapse

How does vol sensitivity move across strikes rather than with spot?

Surface vanna differentiates by strike where ordinary vanna differentiates by spot. The ratio says how much of the vol response belongs to strike position rather than to where spot happens to be, which is what separates a surface repricing from a directional move.

Surface Vanna / Vanna

surface vannavanna,surface vanna=2VKσ\frac{\text{surface vanna}}{\text{vanna}}, \quad \text{surface vanna} = \frac{\partial^2 V}{\partial K \partial \sigma}
RangeBounded to +/-5,000.
surface_charm_ratiofloatalphacollapse

Is time decay behaving differently across strikes?

The strike-space counterpart of charm, normalised by charm itself. When it moves, the decay profile is tilting across the strike ladder rather than uniformly, so a hedge calibrated at one strike stops holding at its neighbours.

Surface Charm / Charm

surface charmcharm,surface charm=2VKt\frac{\text{surface charm}}{\text{charm}}, \quad \text{surface charm} = \frac{\partial^2 V}{\partial K \partial t}
RangeBounded to +/-5,000.
droplet_surface_ratiofloatalphacollapse

How fast is the strike-volatility relationship itself evolving?

Droplet adds a time derivative to surface vanna, so this ratio is the decay rate of strike-vol sensitivity expressed as a fraction of its current level. It tells you how long a strike-selection decision stays valid.

Droplet / Surface Vanna

dropletsurface vanna,droplet=3VKσt\frac{\text{droplet}}{\text{surface vanna}}, \quad \text{droplet} = \frac{\partial^3 V}{\partial K \partial \sigma \partial t}
RangeBounded to +/-1,000.
flare_surface_ratiofloatalphacollapse

How does strike-level convexity respond to a vol change?

Flare is the vol sensitivity of dual gamma, the curvature of value across strikes. Measured against surface vanna it separates strikes whose curvature holds through a vol regime shift from those whose curvature does not.

Flare / Surface Vanna

flaresurface vanna,flare=3VK2σ\frac{\text{flare}}{\text{surface vanna}}, \quad \text{flare} = \frac{\partial^3 V}{\partial K^2 \partial \sigma}
RangeBounded to +/-1,000.
halo_vanna_ratiofloatalphacollapse

How does price-vol coupling vary from strike to strike?

Halo is vanna differentiated once more by strike, so this ratio measures the dispersion of the price-vol coupling across the ladder. Near zero the coupling is flat and one vanna hedge covers the book. Away from zero it does not.

Halo / Vanna

halovanna,halo=3VSσK\frac{\text{halo}}{\text{vanna}}, \quad \text{halo} = \frac{\partial^3 V}{\partial S \partial \sigma \partial K}
RangeBounded to +/-5,000.
aurora_halo_ratiofloatalphacollapse

Is the whole spot-vol-strike structure changing with time?

Aurora is the fourth-order cross derivative in spot, vol, strike and time, the highest-order object in the set. Against halo it gives the time evolution of cross-strike coupling as a fraction of the coupling itself. Read it as a structural indicator, not a trade trigger.

Aurora / Halo

aurorahalo,aurora=4VSσKt\frac{\text{aurora}}{\text{halo}}, \quad \text{aurora} = \frac{\partial^4 V}{\partial S \partial \sigma \partial K \partial t}
RangeBounds adapt to days to expiry: +/-100 under 7d, +/-1,500 from 7 to 30d, +/-5,000 beyond 30d.
alpha_efficiency_ratiofloatalphacollapse

How efficient is gamma scalping on this option?

Gamma trading efficiency: |theta| / gamma. Lower values = cheaper gamma (less daily theta bleed per unit of convexity). The primary metric for constructing gamma books. Requires gamma >= 0.001, otherwise NULL.

|Theta| / Gamma

θγ\frac{|\theta|}{\gamma}
RangeUnbounded (gamma threshold: 0.001). Lower = better gamma value.
alpha_precomputed_ratiofloatalphacollapse

Does our alpha Greek match the efficiency ratio?

Verification: the alpha Greek from /v1/greeks/snapshot should equal alpha_efficiency_ratio. Discrepancies indicate computation issues. Diagnostic field.

Direct alpha verification

α (from Greeks table)\alpha \text{ (from Greeks table)}
RangeShould equal alpha_efficiency_ratio.
elasticity_delta_ratiofloatalphacollapse

How much leverage per unit of delta?

Leverage efficiency. Elasticity/delta simplifies to S/V (spot/option price). A measure of how much "bang for your buck" you get. Extremely high for deep OTM.

Elasticity / Delta

ΛΔ=SV\frac{\Lambda}{\Delta} = \frac{S}{V}
RangeBounded to +/-100,000. Can be very large for cheap OTM options.
rho_vega_ratiofloatalphacollapse

How do interest rate and vol sensitivities compare?

Interest-vol sensitivity balance. In crypto, this connects DeFi rates to vol exposure. When rho/vega shifts, the implied risk-free rate is moving relative to vol expectations.

Rho / Vega

ρν\frac{\rho}{\nu}
RangeBounded to +/-1,000.
veta_vega_ratiofloatalphacollapse

How fast is vega decaying relative to its current level?

Vega time decay efficiency. Tells you what fraction of your vega you lose per unit time. Important for timing vol trades.

Veta / Vega

vetaν\frac{\text{veta}}{\nu}
RangeBounded to +/-1,000.
second_to_first_order_ratiofloatalphacollapse

How much of the risk has left the linear terms?

Summed second-order Greeks over summed first-order Greeks. Low values mean delta and vega still describe the position. As it rises, convexity is carrying risk that a first-order hedge does not see.

Second / first order

2nd order1st order\frac{\sum |\text{2nd order}|}{\sum |\text{1st order}|}
RangeZero to 10,000.
third_to_second_order_ratiofloatalphacollapse

Is convexity itself unstable?

The same comparison one order up. When both this and the second-to-first ratio rise together, the expansion is not converging and each additional order matters more than the last.

Third / second order

3rd order2nd order\frac{\sum |\text{3rd order}|}{\sum |\text{2nd order}|}
RangeZero to 10,000.
fourth_to_third_order_ratiofloatalphacollapse

Has the expansion stopped converging?

The highest-order comparison available. Sustained values above the low end mean the fourth-order layer is no longer a correction term, and position risk should be measured by revaluation rather than by Greeks.

Fourth / third order

4th order3rd order\frac{\sum |\text{4th order}|}{\sum |\text{3rd order}|}
RangeZero to 100,000.

Suggested Calculations

Not included in the API response. Compute these client-side from the fields above. Formulas and context provided.

FieldTypeInputsexpand all
cohort_aggregated_ratiosobjectclient-sideWhat do these ratios look like aggregated across a cohort of options?expand

What do these ratios look like aggregated across a cohort of options?

Liquidity-weighted averages, medians, and standard deviations for 15 of these ratios, aggregated per cohort (28 cohorts per coin). Shows whether a signal is concentrated in one moneyness or expiry zone, or broad-based.

Or use the pre-computed endpointalpha

Pre-aggregated per cohort at /v1/greeks/cohort with weighted averages, medians, and std for key ratios.