Williams Alligator

The Williams Alligator is a technical analysis tool developed by trader and author Bill Williams. It’s designed to help traders identify trends and potential trading opportunities in the market. The indicator is composed of three smoothed moving averages that are meant to resemble the teeth, lips, and jaws of an alligator, hence the name.

Here’s a breakdown of the components:

  1. Alligator’s Jaw (Blue line): This is a 13-period smoothed moving average that is moved 8 bars into the future.
  2. Alligator’s Teeth (Red line): This is an 8-period smoothed moving average that is moved 5 bars into the future.
  3. Alligator’s Lips (Green line): This is a 5-period smoothed moving average that is moved 3 bars into the future.

When the Alligator indicator is applied to a chart, traders look for the following signals:

  • Trending Upward: When the three lines are intertwined, with the green line (Lips) at the top, the red line (Teeth) in the middle, and the blue line (Jaw) at the bottom, this indicates that the market is in a strong upward trend. Traders might look for buying opportunities.
  • Trending Downward: Conversely, when the three lines are intertwined, but with the green line (Lips) at the bottom, the red line (Teeth) in the middle, and the blue line (Jaw) at the top, this suggests a strong downward trend. Traders might look for selling opportunities.
  • Consolidation/Range-bound: When the Alligator’s lines are close together and intertwined, this suggests the market is ranging or consolidating, and traders might avoid entering new positions until a clear trend emerges.
  • Awake/Asleep: Bill Williams also described the Alligator as “asleep” when the three lines are close together and flat. Conversely, when the Alligator is “awake,” the three lines diverge, indicating an emerging trend.

Customise the indicator

With our API, traders have the flexibility to customize the Williams Alligator indicator according to their preferences and trading strategies using optional parameters. This includes adjusting the length of each of the moving averages (Jaw, Teeth, and Lips) to suit different timeframes and market conditions. For example, traders can experiment with longer or shorter periods for the moving averages based on the volatility of the asset being analyzed. Additionally, traders can modify the offset by specifying how many bars into the future each line is moved. These adjustments are possible using the optional parameters described in the table below.

Get Williams Alligator values via API

We provide API access to the Williams Alligator values for all of the most popular assets like stocks, crypto (try one of the popular exchanges like Binance) and forex, on all commonly used timeframes – from the weekly and daily all the way down to one minute intervals. You can also calculate the values on your own data using our manual method.

Get started with the williamsalligator

Simply make an HTTPS [GET] request or call in your browser:

			[GET] https://api.taapi.io/williamsalligator?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=1h

API response

The williamsalligator endpoint returns a JSON response like this:

			{
	"valueJaws": 68078.54021534462,
	"valueTeeth": 67764.67773254868,
	"valueLips": 66023.99113981522
}
Example response from TAAPI.IO when querying williamsalligator endpoint.

API parameters

secret
Required String
The secret which is emailed to you when you request an API key.
exchange
Required String
The exchange you want to calculate the indicator from: binance, binancefutures or one of our supported exchanges. For other crypto / stock exchanges, please refer to our Client or Manual integration methods.
symbol
Required String
Symbol names are always uppercase, with the coin separated by a forward slash and the market: COIN/MARKET. For example: BTC/USDT Bitcoin to Tether, or LTC/BTC Litecoin to Bitcoin...
interval
Required String
Interval or time frame: We support the following time frames: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 12h, 1d, 1w. So if you're interested in values on hourly candles, use interval=1h, for daily values use interval=1d, etc.
backtrack
Optional Integer
The backtrack parameter removes candles from the data set and calculates the williamsalligator value X amount of candles back. So, if you are fetching the williamsalligator on the hourly and you want to know what the williamsalligator was 5 hours ago, set backtrack=5. The default is 0.
chart
Optional String
The chart parameter accepts one of two values: candles or heikinashi. candles is the default, but if you set this to heikinashi, the indicator values will be calculated using Heikin Ashi candles. Note: Pro & Expert Plans only.
addResultTimestamp
Optional Boolean
true or false. Defaults to false. By setting to true the API will return a timestamp with every result (real-time and backtracked) to which candle the value corresponds. This is especially helpful when requesting a series of historical values using the results parameter.
fromTimestamp
New Optional String
The start of the time range in Unix epoch time. For example: 1685577600
toTimestamp
New Optional String
The end of the time range in Unix epoch time. For example: 1731456000 If you only use fromTimestamp, the API will return all results from that time until present.
gaps
Optional Boolean
true or false. Defaults to true. By setting to false, the API will ensure that there are no candles missing. This often happens on lower timeframes in thin markets. Gaps will be filled by a new candle with 0 volume, and OHLC set the the close price of the latest candle with volume.
results
New Optional String
number or max. Use this parameter to access historical values on the past X candles until the most recent candle. Use max to return all available historical values. Returns an array with the oldest value on top and most recent value returned the last.
jawsLength
Optional Integer

Default: 13

teethLength
Optional Integer

Default: 8

lipsLength
Optional Integer

Default: 5

jawsOffset
Optional Integer

Default: 8

teethOffset
Optional Integer

Default: 5

lipsOffset
Optional Integer

Default: 3

More examples

Let's say you want to know the williamsalligator value on the last closed candle on the 30m timeframe. You are not interest in the real-time value, so you use the backtrack=1 optional parameter to go back 1 candle in history to the last closed candle.

				[GET] https://api.taapi.io/williamsalligator?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=30m&backtrack=1
Get williamsalligator values on each of the past X candles in one call

Let's say you want to know what the williamsalligator daily value was each day for the previous 10 days. You can get this returned by our API easily and efficiently in one call using the results=10 parameter:

				[GET] https://api.taapi.io/williamsalligator?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=1d&results=10

Looking for even more integration examples in different languages like NodeJS, PHP, Python, Curl or Ruby? Continue to [GET] REST - Direct documentation.