New

The Tools APIs are now live: option scanning, backtest search, intraday backtesting, and time & sales over REST

@orats/cli v1.0 · for Claude Code and Codex

Options data your AI agent can actually read.

Claude Code and Codex can already reason about vol surfaces and skew. The hard part is handing them numbers that hold up.

One CLI. Every ORATS endpoint. SMV-cleaned IV surfaces, forecast vol, end-of-day data since 2007, and one-minute intraday back to August 2020. Now with the Tools APIs: chain scans, 300M+ precomputed backtests, custom intraday backtests, and the tick tape.

$get an API token read the docs

Not a coder? Otto, the agent built into the ORATS dashboard, does this in plain English. And if you’d rather skip the CLI, the Tools APIs take the same calls over plain REST.

zsh·~/.oratslive

sample1 / 4

Install in 60 secondsfull guide

1Install

$npm i -g @orats/cli

2Token

$export ORATS_TOKEN=your_token

3skill

$orats skills

Live Demo

Watch Claude Code run the CLI.

auto-playing · click a tab to jump

Type /orats in Claude Code and the agent picks the endpoints, writes the flags, and reads what comes back. Below, the transcripts for eight real questions. Three lean on the new Tools APIs: a scan, a backtest, and a read of the tape.

you

claude code · slash command

Try it on your own ticker.$get an API token

The Edge

The edge you can’t train into a model.

Frontier models already know what IV rank means. What they can’t do from pre-training is pull this morning’s smoothed vol surface, compare today’s implied earnings move against the last eight quarterly realized ones, or backtest the trade they just proposed.

SMV-cleaned IV surfaces

Every strike returns smvVol, ORATS’ smoothed fit of the implied vol surface. Your agent reasons on a clean curve instead of a noisy mid between wide bids and asks.

raw bid-ask vs SMV fit

atmiv 0.2206slope +1.22deriv +0.07

1-minute intraday since Aug 2020

hist-intraday-strikes-chain, hist-intraday-summaries, and the rest of the minute endpoints. Replay an earnings print or a CPI morning, minute by minute.

SPY · 2024-08-05 · minute-by-minute IV

ticker SPYdate 2024-08-05Δ open→peak +5.58

Forecast vol, built in

orFcst20d, impliedMove, live-monies-forecast. ORATS’ rich-vs-cheap signal, ready for the agent to read.

AAPL · implied vs ORATS forecast

ticker AAPLthreshold ×1.15

iv30d

27.55

orFcst20d

25.48

iv30d / orFcst20d1.08 · below 1.15 · near fair

LLM-native CLI

orats --llms emits a manifest. --schema emits JSON Schema. orats mcp add --agent claude-code wires MCP. JSON on pipe, TOON in a terminal.

agent sees tools

›delayed-cores

›live-monies-implied

›live-strikes

›live-summaries

orats --llms

{

"version": "incur.v1",

"commands": [...44]

}

End-of-day data since 2007

Every US equity option, every trading day, since 2007. hist-eod-cores, hist-eod-strikes, hist-eod-monies-implied. Backtest GFC, Volmageddon, COVID, and August 2024 on the same API.

19 years · four data schemas · daily

~5,000 trading days4 schemas: cores · strikes · monies · summaries

Earnings-aware analytics

wksNextErn, impliedMove, exErnIv30d, and the last twelve realized earnings moves (ernMv1…ernMv12). Pre-earnings event studies without stitching a single date series.

NVDA · delayed-cores snapshot

NVDApre-earnings

earnings in 4w

implied move

±7.37%

iv30d

33.39%

orFcst20d

33.32%

fields from delayed-coreswksNextErn = 4

Scans that return trades

orats scanner scan hands your agent ranked candidates from live or delayed chains: pricing, greeks, probability of profit, breakevens, max loss. Strategy definition in, JSON trades out. Single-leg via flags, multi-leg via --body.

SPY · short put scan · Tools API

scanner scan · short putranked by edge

1SPY 737P · 31d-3.05pop 0.74

2SPY 741P · 31d-3.62pop 0.71

3SPY 733P · 24d-2.48pop 0.77

mid < 0 = credit receivedbreakEvens, maxLoss included

Backtests in the loop

orats finder performance searches 300M+ precomputed backtests; orats backtest submit runs custom ones on one-minute data, 0DTE included. The agent proposes a trade and shows you its track record in the same breath.

SPY IronCondor · top row · Tools API

finder stats · SPY IronCondor2007 - present

win rate

81%

trades

214

max dd

-9%

The tape, with greeks

hist-time-sales-option and the live feeds: every historical option print carries delta, gamma, IV, and the underlying price at the moment it traded, back to September 2022. Ask who was lifting offers and get timestamps and sizes back.

SPY prints · aggressor-tagged · Tools API

SPY option printsgreeks at trade time

09:32:38748P855 @ 2.74BUYiv 21.0

09:32:07750P1,204 @ 3.30SELLiv 20.2

09:31:44745P620 @ 1.98BUYiv 21.3

09:31:12748P1,930 @ 2.61BUYiv 20.7

hist-time-sales-optionsince Sep 2022 · live too

Plug this edge into your agent.$get an API token

Reference

Every endpoint. One consistent CLI.

Four data tiers plus the new Tools APIs, all speaking the same flags. Search by name, pick a tier, copy the example. Pipe anything and it comes out JSON.

Live7Delayed3Hist EOD12Hist Intraday4ToolsNEW

$orats data <endpoint> --ticker T [flags]

~/.orats/endpoints/·ls -R

filter:

endpoints

32 endpoints · 5 tiers · composable flags: --ticker, --dte, --delta, --fields, --trade-date, --format

delayed·delayed-cores.md~15 min

description

Per-ticker analytics. 500+ indicators. Always use --fields.

key fields

iv30dorFcst20dslopederivimpliedMoveavgOptVolu20dwksNextErn

example

$ orats data delayed-cores --ticker AAPL --fields iv30d,orFcst20d,slope

i every endpoint takes --format (json, toon, csv, yaml, md, jsonl) and emits JSON when piped. orats glossary <field> requires no API token.

NORMALdelayed-cores.mdutf-8 · line 1:1 · orats-cli v1.0

One token unlocks every endpoint on your plan.$get an API token

FAQ

The CLI, answered.

What is the ORATS CLI?

A single command that wraps every ORATS endpoint so an AI coding agent can call it without you writing a client first. Install it with npm i -g @orats/cli, set ORATS_TOKEN, and every data endpoint plus the four Tools APIs is one subcommand away. It prints JSON when piped and readable TOON in a terminal, so the same command serves you and your agent.

How do I wire it into Claude Code or Codex?

Run orats skills to install the skill, then type /orats in Claude Code and the agent picks the endpoints and writes the flags itself. For MCP clients, orats mcp add --agent claude-code does the wiring. If your tooling wants to discover the surface on its own, orats --llms emits a manifest and --schema emits JSON Schema.

Does it work with agents other than Claude Code and Codex?

Yes. Anything that speaks MCP can pick it up through orats mcp add, and anything that can run a shell command can use the CLI directly. There is nothing Claude-specific in the data path; it is HTTPS and JSON underneath.

Which endpoints does it cover?

All of them. Four data tiers (delayed and live end-of-day, delayed and live intraday) and the Tools APIs: orats scanner scan for ranked trade candidates, orats finder performance for the 300M+ precomputed backtests, orats backtest submit for custom one-minute backtests including 0DTE, and the time and sales endpoints for tick-level prints with greeks attached.

Is the CLI a separate purchase?

No. The CLI and the skill are built and maintained by ORATS and installed from npm; what you pay for is the ORATS data plan whose token they call. Plans start at $199 per month for delayed data and run to $899 per month for the All-In plan, which includes every data endpoint plus all four Tools APIs.

How is this different from Otto?

Otto is the agent inside the ORATS dashboard, for people who want to ask in plain English and not write code. The CLI is the opposite end: it puts the same data inside the agent you already run in your own terminal and your own repo. Same data, different seat.

Can I use it without an AI agent?

Yes, it is a perfectly ordinary CLI. Call an endpoint, pipe the JSON into jq or a script, and you have a data pipeline with no agent involved.

Do I need to sign anything for live data?

For the live endpoints, yes: the OPRA and Cboe agreements are available to sign right after signup. The delayed and historical endpoints work as soon as you have a token.

Questions about the API requirements? Want to become an affiliate? Curious about the backtester? Leave us a message and we'll get back to you shortly.

Your email

Your message

Submit

ORATS University

Master the art of options

Research

Implementation

Risk

Review

Get started

Institutional Quality Tools for All Options Traders

(312) 986 - 1060

support@orats.com

36 Maplewood Ave, Portsmouth, NH 03801

Trading Tools

APIs

Historical Data

Near End-of-day - Since 2007

1 Minute Intraday - Since Aug. 2020

More Information

The opinions and ideas presented herein are for informational and educational purposes only and should not be construed to represent trading or investment advice tailored to your investment objectives. You should not rely solely on any content herein and we strongly encourage you to discuss any trades or investments with your broker or investment adviser, prior to execution. None of the information contained herein constitutes a recommendation that any particular security, portfolio, transaction, or investment strategy is suitable for any specific person. Option trading and investing involves risk and is not suitable for all investors. For more information please see our disclaimer.

Interactive Brokers is not affiliated with Option Research & Technology Services, LLC and does not endorse or recommend any information or advice provided by Option Research & Technology Services, LLC.