- API
- Portfolio risk
- Hedge recommendations
Portfolio risk API, POST /hedge-recommendations
How many SPY puts or shares neutralise my delta?
Stock and option hedges that bring your net delta to a target. Computes net portfolio delta in shares of the hedge ticker, beta-weighted, and returns a share hedge and an option alternative on the hedge ticker sized to reach the target delta, with cost estimates and projected Greeks after the hedge.
The answer, in one call
Units first,
then the request.
Deltas in shares of hedge_ticker (delta_units); share_delta is the unweighted share delta; est_cost in dollars.
Beta-weighted: each name's delta in dollars, scaled by its 1-year beta over the hedge ticker's (dollar weighted when a beta is missing; see weighting). Option hedge uses the live chain on hedge_ticker.
curl -X POST "https://apexvol.com/api/mcp/data/hedge-recommendations" \
-H "Authorization: Bearer avmcp_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"positions": [{"ticker": "SPY", "position_type": "STOCK", "quantity": 100, "current_price": 764.41}, {"ticker": "SPY", "position_type": "PUT", "quantity": -1, "strike": 753.0, "expiration": "2026-10-23", "current_price": 6.3543, "delta": -0.3001, "theta": -0.2324, "vega": 0.7404, "iv": 0.1415}], "hedge_ticker": "SPY", "target_delta": 0}'import requests
headers = {"Authorization": "Bearer avmcp_YOUR_TOKEN"}
body = {"positions": [{"ticker": "SPY", "position_type": "STOCK", "quantity": 100, "current_price": 764.41}, {"ticker": "SPY", "position_type": "PUT", "quantity": -1, "strike": 753.0, "expiration": "2026-10-23", "current_price": 6.3543, "delta": -0.3001, "theta": -0.2324, "vega": 0.7404, "iv": 0.1415}], "hedge_ticker": "SPY", "target_delta": 0}
r = requests.post("https://apexvol.com/api/mcp/data/hedge-recommendations", headers=headers, json=body)
r.raise_for_status()
data = r.json()["data"]
print(data["current_delta"])How do I delta-hedge my book with SPY puts?
The assistant calls get_hedge_recommendations and answers from the JSON below.{
"success": true,
"data": {
"current_delta": 130.01,
"delta_gap": -130.01,
"delta_units": "SPY shares",
"hedge_ticker": "SPY",
"hedges": [
{
"action": "BUY",
"contracts": 3,
"delta_per_contract": -50.2,
"description": "BUY 3 SPY 2026-10-16 767 puts",
"details": "~-50 delta per contract at 9.66 mid (est. cost $2,897).",
"est_cost": 2897.28,
"expiration": "2026-10-16",
"option_type": "put",
"strike": 767.0,
"ticker": "SPY",
"type": "option"
}
],
"note": "Hedges close a -130 share delta gap in SPY, the same underlying as the book.",
"portfolio_greeks": {
"daily_decay_pct": 0.0307,
"delta_exposure_pct": 130.6481,
"risk_level": "LOW",
"total_cost_basis": 0,
"total_delta": 130.01,
"total_pnl": 75805.57,
"total_pnl_pct": 0,
"total_positions": 2,
"total_theta": 23.24,
"total_value": 75805.57,
"total_vega": -74.04,
"vega_risk_pct": 0.0977
},
"projected_greeks": {
"changes": {
"delta": {
"change": -130.0,
"change_pct": -99.9923,
"current": 130.01,
"projected": 0.01
},
"gamma": {
"change": 0.0,
"change_pct": 0.0,
"current": -1.3185,
"projected": -1.3185
},
"theta": {
"change": 0.0,
"change_pct": 0.0,
"current": 23.24,
"projected": 23.24
},
"vega": {
"change": 0.0,
"change_pct": 0.0,
"current": -74.04,
"projected": -74.04
}
},
"current_greeks": {
"charm": 30.337,
"delta": 130.01,
"gamma": -1.3185,
"rho": 27.849,
"theta": 23.24,
"vanna": 22.9064,
"vega": -74.04,
"vomma": -5.9186
},
"current_risk_level": "LOW",
"hedge_cost": 0,
"hedge_trades": [
{
"position_type": "STOCK",
"quantity": -130,
"ticker": "SPY"
}
],
"projected_greeks": {
"charm": 30.337,
"delta": 0.01,
"gamma": -1.3185,
"rho": 27.849,
"theta": 23.24,
"vanna": 22.9064,
"vega": -74.04,
"vomma": -5.9186
},
"projected_risk_level": "LOW",
"success": true,
"timestamp": "2026-09-24T14:43:10.209430"
},
"share_delta": 130.01,
"target_delta": 0.0,
"weighting": "same_underlying",
"weighting_basis": {}
}
}Every response is wrapped as {"success": true, "data": {...}}. Lists in the sample are cut to a few rows so it fits on a page; the shape is exactly what your code receives.
Parameters
Bounded,
and the bounds are stated.
Out-of-range numbers are clamped to the documented range, never silently changed to something else. A missing required field returns 400 with the reason.
| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
positions required | body | as /portfolio-greeks | The book. | |
hedge_ticker | body | SPY | symbol | What to hedge with. |
target_delta | body | 0 | shares of hedge_ticker | Where to land. |
Field by field
What each
number means.
current_delta, delta_gap, target_delta- The gap to close, in shares of hedge_ticker (delta_units).
share_delta- The book's raw share delta before weighting.
weighting, weighting_basis- beta when each name's delta is converted to dollars and scaled by its 1-year beta to SPY over the hedge's; dollar when a beta is missing; same_underlying when the book is the hedge ticker; shares when no price was available. weighting_basis lists each name's spot and beta.
hedges[].type, action, contracts, strike, expiration, est_cost, description- Each hedge.
projected_greeks or projected_delta- Greeks after the hedge when the book is the hedge ticker; otherwise the projected delta in hedge-ticker shares.
Access, limits, errors
Before the
first call.
- Plan
- Pro Pro and above. Tokens are issued to paid and trial accounts from $55 a month; each endpoint follows the tier of its web feature. An endpoint above your plan answers 402 and names the plan it needs.
- Auth
- Bearer token, prefix
avmcp_, created under Account, then API Access. Shown once, hashed at rest, rotates in one click. Always callhttps://apexvol.com, never www. - Limits
- 60 requests a minute and 1,000 an hour per token, plus a monthly allowance by plan. Every response carries the remaining counts in
X-RateLimit-*headers; a 429 carriesRetry-Afterin seconds. - Errors
401no or revoked token;429Retry-After seconds;403Pro plan required;400missing or malformed body. The full list with payload shapes is on the errors page.- Since
- API 1.0. Units, bases and timestamps follow the conventions shared by every endpoint; changes are logged in the API changelog.
- Machine-readable
- This page as Markdown, the family as one file, the whole API as llms-full.txt or OpenAPI 3.1.
The same data, in plain English
Ask for it
in an MCP client.
Connect the ApexVol MCP server and the assistant calls get_hedge_recommendations by name. One URL, a sign-in, no token to paste.
How do I delta-hedge my book with SPY puts?
YouHow many SPY shares neutralise these positions?
YouGet me to flat delta using QQQ options.
More in the prompt library. Set the server up in Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, Windsurf or Gemini CLI.
Included with
every paid plan.
From $55 a month, tier-matched: your token queries the data your plan includes and Pro unlocks the full surface.
Real market data, not a sandbox. See it live on AAPL.