1
Inside bar
The high and low are contained within the prior bar's range. The market is consolidating.
Objective price action data, delivered as an API.
Price Action API classifies every bar into an objective state, giving your systems a live read of market structure and trend. Built for automated trading bots, agents, and dashboards. Based on TheStrat by Rob Smith.
Get Free API Key
Free API key, open to everyone. Real-time during market hours. No credit card required.
SPY
live state
Live during market hours
M
...
W
...
D
...
60
...
30
...
15
...
5
...
Loading live state.
Updated waiting
Symbols
4
SPY, QQQ, DIA, and IWM - the four major US index ETFs.
Timeframes
7
From 5-minute to monthly on every symbol.
API limits
10/min
1,000 requests per day. Key issued instantly - no credit card.
Three primary states. Two layers of detail.
Every bar gets a primary state - 1, 2, or 3 - from what it did to the prior bar's range. Two further reads sharpen it: where the bar sits against its own open, and whether a break is holding.
2
Directional bar
Price broke one side of the prior bar's range, upward or downward.
3
Outside bar
Price broke both sides of the prior bar's range.
Every bar: above or below its open.
>
Above open
Current price is above the opening price of the bar on a given timeframe.
<
Below open
Current price is below the opening price of the bar on a given timeframe.
Conditional: the failed break.
F
Failed break
A 2 up breaks the prior bar's high. If price trades back to or below that high, the break has failed - the market rejected it. Same on the downside with the prior bar's low. Failed states are first-class fields in the feed.
No parameters, no ambiguity. Two systems reading the same bar will always agree.
A response your strategy can act on directly.
The classification work happens before the response reaches you. There is no OHLCV parsing, no indicator library, and no resampling logic to maintain on your side.
Read API docsGET /v1/snapshot?symbols=SPY&tf=M,W,D,H1,30m,15m,5m
{
"type": "bar_state.update",
"symbol": "SPY",
"timeframes": {
"D": {
"cc": "F2u",
"open_sign": "<",
"is_failed": true,
"display": "F2u<"
}
},
"continuity": {
"signs": { "M": "<", "W": "<", "D": "<", "H1": "<", "30m": "<", "15m": "<", "5m": "<" },
"full_continuity": "bear"
},
"tfc": {
"state": "bear",
"full_bear": true,
"net_direction": -7
}
}What traders do with Price Action API.
Rule-based entry and management
Gate entries, exits, and stops on objective bar states instead of gut reads or lagging indicators.
Market structure detection
Know instantly whether a bar is consolidating, breaking out, expanding, or failing - on any timeframe.
Trend direction and strength
Read direction from the open markers and strength from how many timeframes agree.
Cross-index alignment
See when SPY, QQQ, DIA, and IWM are moving together - and when one breaks ranks.
Get started in 60 seconds.
1
Create a free account
Your API key is issued instantly. No waitlist, no approval step, no credit card.
2
Call metadata first
Confirm supported symbols, timeframes, limits, and response fields with /v1/meta.
3
Pull live state
Use /v1/snapshot for bots, agents, dashboards, and research notebooks.
Built for all traders.
Whatever your strategy, the feed gives you an objective read of what price is doing - in plain fields any tool or bot can use. No indicator stack, no chart-reading required.
And if you trade TheStrat, you're already home: 1s, 2s, 3s, and timeframe continuity, straight off the feed.
Frequently asked questions.
What is a price action API?
A price action API is a data feed that returns market-structure information, such as bar classifications and trend direction, as machine-readable fields instead of raw price data. Price Action API classifies each bar as an inside, directional, or outside bar and reports whether multiple timeframes agree on direction.
What is an inside bar / outside bar?
An inside bar (also called an inside candle) is a bar whose high and low are contained within the previous bar's range. An outside bar is a bar that breaks both the high and the low of the previous bar. A directional bar breaks one side only.
What is a failed breakout bar?
A failed bar is one that broke above the prior bar's high but is now trading back at or below that high - the market rejected the breakout. The same applies on the downside with the prior bar's low. Price Action API marks failed directional and failed outside bars as distinct states, because a rejected break and a holding break are different trading information.
What is timeframe continuity?
Timeframe continuity is TheStrat's term for trend agreement across multiple timeframes - whether bars on each timeframe are trading in the same direction relative to their opens. Full continuity is commonly used as a trade filter. The API computes it on every request.
Which symbols are covered?
Price Action API covers SPY, QQQ, DIA, and IWM - the ETFs tracking the S&P 500, Nasdaq-100, Dow Jones Industrial Average, and Russell 2000. Additional symbols are planned.
Is the data real-time?
Yes. The feed updates in real time during market hours.
Do I need to know TheStrat to use this?
No. The API is documented in plain terms: inside, directional, and outside bars. TheStrat users will recognize the 1/2u/2d/3 notation in the response fields.
How much does it cost?
The API is free. Free keys include 10 requests per minute and 1,000 per day - enough to poll a symbol every minute, all session. Sign up and a key is issued instantly.
Add objective market context to your workflow.
Get a free API key for the core market-structure feed. Keys are issued instantly - no waitlist, no approval, no credit card.