Market data tools
Live data from Hyperliquid for every market Farao lists. All four tools need the markets:read scope and are read-only.
get_supported_assets
The exact symbol of every tradeable market, HIP-3 markets included.
Input: none
| Output | |
|---|---|
assets | Symbols such as BTC, xyz:NVDA, xyz:GOLD |
count | How many there are |
Call it once when a symbol is uncertain, then use the returned name as is. See Symbols.
get_market_snapshot
What an agent needs before it sizes an order.
| Input | Type | |
|---|---|---|
coins | string[] | Optional. Omit for every market |
Each market has:
| Output | |
|---|---|
midPrice | Current mid price |
maxLeverage | Highest leverage the market allows |
minNotionalUsd | Smallest order by notional, about $10 |
minSize | Smallest order in units of the asset |
fundingRate | Current funding. Positive means longs pay shorts |
get_candles
Raw OHLCV bars.
| Input | Type | |
|---|---|---|
coins | string[] | Required. Exact symbols |
intervals | string[] | Required. Any of 1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M |
limit | integer, 1 to 120 | Most recent bars per series. Default 50 |
Coins are crossed with intervals, up to 8 series per call. Each series has bars, oldest first, with t (bar close time in epoch ms), o, h, l, c and v (volume in units of the asset, not USD). The last bar may still be open. truncated: true means older bars were dropped to fit the response, so ask for fewer series to get more depth.
A series that fails is reported in errors without failing the rest.
get_indicators
About 20 indicators computed on the server, matching the chart in the Farao app. Prefer it to pulling candles and doing the math in the model: it uses far less context.
| Input | Type | |
|---|---|---|
coins | string[] | Required. Exact symbols |
intervals | string[] | Required. Same 14 intervals as get_candles |
One call reads one market across several timeframes, or screens a watchlist at one timeframe. Each reading has:
| Group | Indicators |
|---|---|
trend | SMA, EMA, VWAP, MACD, ADX with +DI and −DI, Parabolic SAR, Ichimoku, Supertrend |
momentum | RSI, Stochastic, Stochastic RSI, CCI, Williams %R, ROC, MFI |
volatility | Bollinger Bands with %B and bandwidth, ATR and ATR as a percent of price, Keltner, Donchian |
volume | OBV as a direction over the last 20 bars, its change, and any divergence from price |
emaCross | Direction of the EMA 12/26 cross (golden or death) and barsAgo. A null age means the cross is older than the window, not that it is recent |
Each reading also has close, lastBarAt and barsUsed. These are numbers, not recommendations. A good agent shows the readings it used so you can disagree with them.