Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-BACKTEST |
| Coverage | US underlyings with listed options in our end-of-day history |
| Granularity | One result per backtest request, built on daily option data |
| History | Whatever our end-of-day chain history covers for that underlying |
| Delivery | REST: you post rules, we return results |
| Update speed | Results in the response; history extends each trading day |
This page covers two things. The first is the data a backtest needs: daily option chains with bid, ask and Greeks, which you can pull yourself and run through your own code. Second, a backtest endpoint that does the loop for you. You describe the strategy as rules and get back the summary numbers.
Schema
Schema
The fields below describe a backtest result. They're our proposal, since no seller publishes a full output format.
| Field | Type | Required | Description |
|---|---|---|---|
backtest_id |
string | yes | Unique ID |
underlying_symbol |
string | yes | Underlying ticker |
strategy |
string | yes | e.g. short_put, iron_condor, long_straddle |
start_date |
string | yes | YYYY-MM-DD |
end_date |
string | yes | YYYY-MM-DD |
entry_rules |
object | yes | e.g. {days_to_expiration: 45, delta: -0.30} |
exit_rules |
object | yes | e.g. {profit_target_pct: 0.5, stop_loss_pct: 2.0} |
fill_price |
string | yes | mid or bid_ask |
trade_count |
integer | yes | Trades taken |
win_rate |
number | yes | Decimal |
average_return |
number | yes | Per trade, decimal of capital at risk |
total_return |
number | yes | Decimal |
max_drawdown |
number | yes | Decimal |
Example record:
{
"backtest_id": "bt_7f3a91",
"underlying_symbol": "SPY",
"strategy": "short_put",
"start_date": "2016-01-04",
"end_date": "2026-11-18",
"entry_rules": {"days_to_expiration": 45, "delta": -0.30},
"exit_rules": {"profit_target_pct": 0.5, "stop_loss_pct": 2.0},
"fill_price": "bid_ask",
"trade_count": 214,
"win_rate": 0.82,
"average_return": 0.031,
"total_return": 1.47,
"max_drawdown": -0.29
}
These results are illustrative only. They show the shape of a response, not a finding about short puts.
Sample data
Sample data
No free backtest sample exists yet, because the engine isn't built. If you send us a strategy description, we'll add it to the list we test the engine against and send you the result when it runs.
Use cases
Use cases
Short premium rules. Compare win_rate and max_drawdown for the same short_put at 30, 45 and 60 days to expiry. High win rates are easy to find; the drawdown tells you whether you'd have survived.
Fill assumption check. Run the identical strategy twice, once with fill_price set to mid and once to bid_ask. On wide-spread underlyings the gap between the two total_return values is often larger than the edge itself.
Exit rule tuning. Hold entries fixed and vary profit_target_pct in exit_rules. Closing at 50% versus holding to expiry changes trade_count, average_return and drawdown at once.
Comparing underlyings. Run one iron condor rule set across SPY, QQQ and IWM. Differences in win_rate show which index's realized volatility has historically sat further below its implied.
Code
Code examples
Example: submit a backtest with curl.
curl -X POST "https://api.marketdata.co/v1/options/backtests" \
-H "Authorization: Bearer $MARKETDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"underlying_symbol": "SPY", "strategy": "short_put",
"start_date": "2016-01-04", "end_date": "2026-11-18",
"entry_rules": {"days_to_expiration": 45, "delta": -0.30},
"exit_rules": {"profit_target_pct": 0.5, "stop_loss_pct": 2.0},
"fill_price": "bid_ask"}'
Example: Python, a small grid of profit targets compared in pandas.
import os
import requests
import pandas as pd
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
rows = []
for target in [0.25, 0.5, 0.75]:
resp = requests.post(
"https://api.marketdata.co/v1/options/backtests",
headers=headers,
json={
"underlying_symbol": "SPY", "strategy": "short_put",
"start_date": "2016-01-04", "end_date": "2026-11-18",
"entry_rules": {"days_to_expiration": 45, "delta": -0.30},
"exit_rules": {"profit_target_pct": target, "stop_loss_pct": 2.0},
"fill_price": "bid_ask",
},
)
resp.raise_for_status()
rows.extend(resp.json()["results"])
grid = pd.DataFrame(rows)
grid["target"] = grid["exit_rules"].apply(lambda r: r["profit_target_pct"])
print(grid[["target", "trade_count", "win_rate", "total_return", "max_drawdown"]])
Pricing
Pricing
| Plan | Strategy backtests |
|---|---|
| Pro, $79/mo plus add-on | Backtests on daily data, planned as a Pro add-on at about $29/mo |
The add-on comes later, once end-of-day chain history is live. It isn't sold as a dataset. Prices are early access and may change.
Vendors we studied charge $69 to $299 a month for options backtesting, based on 3 prices.
Side by side
How we compare
Only 2 of the 50 providers we studied sell options strategy backtests. One sells them through a web interface only; the other sells an API add-on on top of a more expensive data plan. We plan to return every result in a documented JSON shape, let you choose mid or bid_ask fills explicitly, and keep the underlying chain data available so you can check any trade yourself.
FAQ
Frequently asked questions
What data do backtests run on?
Daily end-of-day option chains with bid, ask, volume, open interest and Greeks. Intraday backtests are not planned at launch.
Which strategies will be supported?
We plan to start with single legs and common structures such as short_put, iron_condor and long_straddle. Tell us what you need on the early access form.
Are prices adjusted for splits and dividends?
Option prices are kept as traded. Strikes and contract terms follow OCC adjustments after a split, so a backtest across a split uses the contracts that really existed.
What time zone do dates use?
Dates are US trading dates. Entries and exits happen at end-of-day prices for that date.
Can I export the trade list?
The response summary is shown above. A per-trade list is planned as an optional part of the response.
Is this real-time?
No. Backtests use history only, and results come back in the response to your request.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Options Greeks explained, Implied volatility and IV rank