GET/indicator/sar

Parabolic SAR (TA-Lib)

Category: Trend · Updated November 2026

The TAAPI.IO SAR (TA-Lib) API returns real-time and historical values for the Parabolic SAR indicator as JSON, for crypto pairs and US stocks. Send an exchange, symbol and timeframe to get real-time or historical data, with no candles to download and no calculations to maintain.

Spec	Value
Endpoint	`GET https://v2.taapi.io/indicator/sar`
Outputs	`value`
Markets	Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes	`1m` to `1w`
Delivery	REST, bulk and WebSocket

Get SAR (TA-Lib) with one API call

This request returns SAR (TA-Lib) for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.

curl -G https://v2.taapi.io/indicator/sar \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h"

import requests

resp = requests.get(
    'https://v2.taapi.io/indicator/sar',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h'},
)
print(resp.json())

const params = new URLSearchParams({"exchange": "binance", "symbol": "BTCUSDT", "timeframe": "1h"});
const res = await fetch(`https://v2.taapi.io/indicator/sar?${params}`, {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());

SAR (TA-Lib) API response

This response came from the live API on 9 November 2026. Long lists are shortened here.

200 OK

{
  "value": [75578.67022710969],
  "timestamp": [1794218400]
}

Field	Type	Description
`value`	number[]	SAR (TA-Lib) result
`timestamp`	integer[]	Unix time of each candle, in seconds

SAR (TA-Lib) API parameters

Name	Type	Required	Default	Description
`exchange`	string	Yes	—	`binance`, `binancefutures`, `bybit`, `gateio`, `kraken` or `stocks`
`symbol`	string	Yes	—	Pair or ticker, e.g. `BTCUSDT` or `AAPL`
`timeframe`	string	Yes	—	`1m` `5m` `15m` `1h` `4h` `1d` `1w`
`acceleration`	number	No	0.02	Acceleration Factor
`maximum`	number	No	0.2	AF Maximum
`results`	integer	No	1	Number of values to return, or `max`
`backtrack`	integer	No	0	Candles to skip from the most recent

What is SAR (TA-Lib)?

This endpoint exposes the TA-Lib Parabolic SAR with its two standard settings, acceleration and maximum. Use psar if you need a separate start and increment, or sarext for full control.

SAR (TA-Lib) formula

Output	Calculation
Next SAR	SAR + acceleration factor × (extreme point − SAR)

How to read SAR (TA-Lib) in your code

Signal	Meaning	Condition
Uptrend	Stop below price	Close above `value`
Downtrend	Stop above price	Close below `value`
Reversal	Stop flipped	Close crosses `value`

Limitations: It flips repeatedly in ranges, so it works best with a trend filter. Nothing on this page is financial advice.

Compare the last two closed SAR (TA-Lib) values

Use backtrack=1 to skip the candle still forming, and results=2 to compare the last two closed candles. Arrays run oldest first.

curl -G https://v2.taapi.io/indicator/sar \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=2" \
  --data-urlencode "backtrack=1"

import requests

resp = requests.get(
    'https://v2.taapi.io/indicator/sar',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'results': 2, 'backtrack': 1},
)
data = resp.json()
prev, last = data['value']
print('value', prev, '->', last)
print('rising' if last > prev else 'falling or flat')

Get historical SAR (TA-Lib) values

Add results to return a series for backtesting or charting. The last element is the most recent candle.

curl -G https://v2.taapi.io/indicator/sar \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get SAR (TA-Lib) for multiple symbols

Combine SAR (TA-Lib) with other indicators in one request. Each exchange, symbol and timeframe combination is one construct: Basic allows 1 per request, Pro 3 and Expert 10.

POST/bulk

curl -X POST https://v2.taapi.io/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "constructs": [
    {
      "id": "btc_1h",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "timeframe": "1h",
      "indicators": [
        {
          "id": "sar",
          "indicator": "sar"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream SAR (TA-Lib) in real time

Subscribe over WebSocket to receive new values every 5 seconds while the candle is forming. Streaming supports 1m, 5m, 15m and 1h, and uses interval where REST uses timeframe.

WSSwss://v2.taapi.io/streaming

{
  "type": "subscribe",
  "id": "sar",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "sar"
}

SAR (TA-Lib) API FAQ

What does the SAR (TA-Lib) API return?

It returns value, plus a timestamp for the request. Results are JSON.

Is the latest SAR (TA-Lib) value final?

No. The newest value belongs to the candle still forming and can change until it closes. Add backtrack=1 to read the last closed candle.

Which SAR (TA-Lib) settings can I change?

You can set acceleration, maximum. See the parameters table above for defaults.

Can I get SAR (TA-Lib) for US stocks?

Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.

See the full list of indicators, or start for free.