OwlChart

Find any instrument OwlChart covers: crypto coins and perpetuals, stocks, ETFs, forex, indices, futures, commodities, bonds and economic series. Returns ids like crypto_perp:bybit:BTCUSDT or equity:NASDAQ:AAPL to use in get_price_history.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Name, ticker, contract address or code, e.g. \"bitcoin\", \"WLFI\", \"AAPL\", \"gold\"."
    }
  },
  "required": [
    "query"
  ]
}

OHLCV candles for any market with a short summary (last price, change over the window, high, low). Accepts a plain ticker (BTC, ETH, AAPL) or an id from search_markets.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "12h",
        "1d",
        "1w",
        "1M"
      ],
      "default": "1h"
    },
    "limit": {
      "type": "integer",
      "minimum": 20,
      "maximum": 500,
      "default": 120
    }
  },
  "required": [
    "symbol"
  ]
}

OwlChart consensus direction for a coin (one answer shared by every OwlChart chart: lead with consensus.headline) plus where leveraged positions would be liquidated around the current price: the nearest liquidity magnet above and below, the net pull direction, whale bids and asks within 5 percent, open interest by venue, long/short split, RSI and the TBO trend, with the model's measured hit rate. Crypto coins only (BTC, ETH, SOL, WLFI ...).

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin ticker, e.g. BTC"
    }
  },
  "required": [
    "coin"
  ]
}

The live news wire OwlChart reads, newest first: crypto news, market-moving X accounts, stock and macro news, crypto rule changes and chart patterns, each with its source, the time to the second, the link, and for coins the price at the headline and the move since. Also the next economic calendar events and the latest stories from The Owl Journal, written from OwlChart live data. Optional coin filter (BTC) and desk (all, crypto, x, stocks).

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Optional coin, e.g. BTC"
    },
    "desk": {
      "type": "string",
      "enum": [
        "all",
        "crypto",
        "x",
        "stocks"
      ]
    },
    "region": {
      "type": "string",
      "enum": [
        "latam",
        "asia",
        "europe",
        "mena",
        "india",
        "africa"
      ],
      "description": "Optional: only headlines about this region (see get_regional_pack)"
    }
  }
}

Live open interest for a coin summed across 13 exchanges (Binance, Bybit, OKX, Bitget, Gate, KuCoin, HTX, MEXC, Kraken, Coinbase International, Hyperliquid, dYdX, Aster), one row per venue with coins, dollars and share, plus the 24 hour change.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string"
    }
  },
  "required": [
    "coin"
  ]
}

Resting bids and asks for a coin across the wired exchanges: depth near price, the biggest walls and the buy/sell imbalance.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string"
    }
  },
  "required": [
    "coin"
  ]
}

OwlChart's 0 to 100 score for a coin: market regime (45 percent) plus entry signal (55 percent), with the verdict, price and RSI. A reading of conditions, not a trade call.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string"
    }
  },
  "required": [
    "coin"
  ]
}

Bitcoin or Ethereum spot ETF flows fund by fund (BlackRock IBIT/ETHA, Fidelity, Grayscale ...), recent days, and OwlChart's "are the institutions selling?" verdict from three raw sources.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "enum": [
        "btc",
        "eth"
      ],
      "default": "btc"
    }
  }
}

Perpetual funding rates for a coin on every exchange OwlChart reads, straight from the exchanges. Positive means longs pay shorts.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string"
    }
  },
  "required": [
    "coin"
  ]
}

Long and short positions actually liquidated for a coin over the last hours, recorded by OwlChart from the exchanges' public feeds.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string"
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 168,
      "default": 24
    }
  },
  "required": [
    "coin"
  ]
}

Runs OwlChart's pattern engine on a market and timeframe: detected candlestick and chart patterns with their measured historical win rates and a confluence score.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "interval": {
      "type": "string",
      "enum": [
        "15m",
        "1h",
        "4h",
        "1d"
      ],
      "default": "1h"
    }
  },
  "required": [
    "symbol"
  ]
}

A quick read of the major coins at once (BTC, ETH, SOL, XRP, BNB, DOGE, ADA, WLFI): Owl Score, price and verdict for each.

{
  "type": "object",
  "properties": {}
}

How much real-world value is on-chain today, read from the contracts: stablecoins, tokenised treasuries and funds (BlackRock BUIDL, Ondo ...), tokenised gold and shares, against the size of each world market.

{
  "type": "object",
  "properties": {}
}

The $CARV developer API as one tool (v5.691): what=market (price, 24h change, volume, high, low, market cap, supply, rank, ATH), history (daily candles, days=2 to 1000), supply, contracts (the OFT address on Ethereum, Base, Arbitrum One, BSC, Linea, the Solana mint, veCARV staking, CARV ID), links (carv.io, docs, stake.carv.io, explorer.carv.io/verifiers, SVM explorer, bridge, RPC, GitHub, X, Telegram, Discord, Medium) or x (latest @carv_official posts). Hub: owlchart.com/carv-hub.html, docs: owlchart.com/carv-api.html.

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "enum": [
        "market",
        "history",
        "supply",
        "contracts",
        "links",
        "x"
      ],
      "description": "which CARV data set, default market"
    },
    "days": {
      "type": "integer",
      "minimum": 2,
      "maximum": 1000,
      "description": "history only: how many daily candles, default 90"
    }
  }
}

Live insider trades read straight from the regulators (v5.732): SEC Form 4 sales, buys and option exercises plus Form 144 planned sales for the United States, BaFin (Germany), AMF (France), Finansinspektionen (Sweden) and AFM (Netherlands) directors' dealings for Europe, EDINET large holder reports for Japan when enabled. Without a ticker it returns the market summary (insider sales and buys in dollars, the sell to buy ratio, the biggest sales, buys and planned sales, the most sold and most bought names). With a ticker, company or insider name it returns that name's filings. Canada, Australia, Hong Kong and India answer with their official source, they need a data licence first.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "enum": [
        "us",
        "eu",
        "jp",
        "ca",
        "au",
        "hk",
        "in"
      ],
      "default": "us"
    },
    "ticker": {
      "type": "string",
      "description": "Optional ticker, ISIN, company or insider name, e.g. NVDA"
    },
    "side": {
      "type": "string",
      "enum": [
        "trades",
        "sell",
        "buy",
        "proposed",
        "exercise",
        "all"
      ],
      "default": "trades"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 7
    }
  }
}

The latest on crypto market structure law and regulators (the CLARITY Act and related bills, SEC and CFTC items), with dates, from OwlChart's live regulation tracker.

{
  "type": "object",
  "properties": {}
}

Shows an interactive OwlChart candle chart inside the chat for any market (crypto, stocks, forex, commodities), with the liquidity magnets above and below drawn on it for crypto coins. Also returns the numbers. Use it when the user wants to see a chart.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Ticker or id, e.g. BTC, ETH, WLFI, AAPL, gold"
    },
    "interval": {
      "type": "string",
      "enum": [
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ],
      "default": "1h"
    }
  },
  "required": [
    "symbol"
  ]
}

Sets an alert on OwlChart data, checked every minute. Types: price_above = price goes above the threshold (dollars); price_below = price goes below the threshold (dollars); oi_change = open interest summed across 13 exchanges moves by the threshold percent from when the alert was set (negative number for a drop); magnet_hit = price reaches the liquidity magnet above or below that existed when the alert was set (no threshold needed); funding_extreme = average funding across exchanges reaches the threshold percent per funding period, either sign (for example 0.05); etf_flip = OwlChart spot ETF verdict for BTC or ETH changes (BUYING, SELLING, MIXED); coin must be BTC or ETH; stablecoin_mint = net stablecoins minted minus burned over 24 hours (all tracked issuers, read from the contracts) crosses the threshold in millions of dollars (negative number for net burn); coin is ignored; large_transfer = a single on-chain transfer of the token (coin = token hub id, e.g. USD1, USDC, BUIDL) of at least the threshold in millions of dollars is seen in the last hour (Ethereum contracts; see get_token_hub); reg_keyword = a new regulatory event whose title contains the keyword given in note appears on the Regulatory Radar (coin is ignored; threshold not needed). When it fires it shows in check_alerts and, if a webhook is given (Discord, Slack, Zapier, Make, n8n or any https hook), a message is sent there too. One-shot. Up to 10 active alerts per member.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin ticker, e.g. BTC, WLFI"
    },
    "type": {
      "type": "string",
      "enum": [
        "price_above",
        "price_below",
        "oi_change",
        "magnet_hit",
        "funding_extreme",
        "etf_flip",
        "stablecoin_mint",
        "large_transfer",
        "reg_keyword"
      ]
    },
    "threshold": {
      "type": "number",
      "description": "Dollars for price alerts, percent for oi_change and funding_extreme"
    },
    "webhook_url": {
      "type": "string",
      "description": "Optional https webhook for delivery"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "coin",
    "type"
  ]
}

Lists this member's alerts, active and recently fired.

{
  "type": "object",
  "properties": {}
}

Deletes one of this member's alerts by its id (from list_alerts).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Returns this member's alerts that fired since the last check, and marks them read.

{
  "type": "object",
  "properties": {}
}

This member's own OwlChart watchlist with the live price and 24 hour change of each market.

{
  "type": "object",
  "properties": {}
}

Adds one or more markets (tickers like BTC, WLFI, AAPL) to this member's own watchlist, up to 30.

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "symbols"
  ]
}

Removes markets from this member's own watchlist.

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "symbols"
  ]
}

The public, forward-tested record of OwlChart's liquidity pull model: every call logged before the outcome, then scored. All-in hit rate, direction accuracy on calls where price actually moved, the 95% range and pending calls, overall and per coin.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Optional coin, e.g. BTC"
    }
  }
}

Where money moved over the last day: stablecoins minted and burned (read from the contracts), tokenised gold and treasuries, BTC and ETH spot ETF flows, BlackRock's bitcoin, and the 24 hour open interest change for the major coins.

{
  "type": "object",
  "properties": {}
}

Flows Terminal: stablecoin supply and 24 hour net minting, tokenised gold, treasuries and stocks, BTC and ETH spot ETF daily flows and verdicts, and open interest for BTC, ETH, SOL and WLFI, as hourly series over 24h, 7d, 30d or 90d with daily roll-ups. Needs the Flows Terminal pass, a Builder or Scale pass, or PRO.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d"
      ]
    },
    "asset": {
      "type": "string",
      "description": "Optional: BTC, ETH, SOL or WLFI to get one asset series"
    }
  }
}

Net stablecoins minted minus burned over the last 24 hours, read from the token contracts, the total supply tracked, and the biggest mints and burns, plus the hourly history of the net figure. Needs the Flows Terminal pass, Builder, Scale or PRO.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ]
    }
  }
}

BTC and ETH spot ETF verdict (BUYING, SELLING, MIXED) with the day, 7 day and 30 day flows, the run of consecutive days, BlackRock holdings and the daily history of the verdict and flows from the Flows Terminal. Needs the Flows Terminal pass, Builder, Scale or PRO.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "enum": [
        "BTC",
        "ETH"
      ]
    }
  }
}

Strategies sold by verified trader desks on OwlChart: title, desk, track record, price. With a strategy pass (Bearer owlpass_ bought at /api/desk-strategies/{id}/buy) and the strategy id, returns the trader's instructions and alert bundle so the agent can run them against live OwlChart data. Data and analysis only.

{
  "type": "object",
  "properties": {
    "desk": {
      "type": "string",
      "description": "Optional desk slug"
    },
    "strategy": {
      "type": "string",
      "description": "A strategy id you hold a pass for"
    }
  }
}

One hub per tokenised asset OwlChart reads from the contracts: stablecoins (USDT, USDC, USD1, PYUSD, RLUSD...), tokenised treasuries and funds (BUIDL, Ondo...), tokenised gold, governance tokens (WLFI, ONDO) and CARV. Price, supply, value, 24h change, issuer, contract; with the Tokenized Assets pass, Builder, Scale or PRO also the large transfers of the last hour read from the chain, the supply history and the regulation items naming the token. No token given: the list.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token id, e.g. USD1, BUIDL, WLFI, CARV"
    }
  }
}

Structured regulatory events from SEC, CFTC, US banking regulators and Treasury, EU, UK, rest of the world and macro sources, each with jurisdiction, kind, sign (green opens, red tightens, grey informs), impact tier, actor and the tokens named. Filters: jurisdiction (sec, cftc, usbank, eu, uk, row, macro), kind, sign, token, keyword, since (YYYY-MM-DD). Trial: ten latest; the Regulatory Radar pass, Builder, Scale or PRO: the whole store.

{
  "type": "object",
  "properties": {
    "jurisdiction": {
      "type": "string",
      "enum": [
        "sec",
        "cftc",
        "usbank",
        "eu",
        "uk",
        "row",
        "macro"
      ]
    },
    "kind": {
      "type": "string"
    },
    "sign": {
      "type": "string",
      "enum": [
        "green",
        "red",
        "grey"
      ]
    },
    "token": {
      "type": "string"
    },
    "q": {
      "type": "string",
      "description": "keyword in the title"
    },
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    }
  }
}

What moved in tokenised assets: supply changes over 24 hours of 5 million dollars or more per contract (mints and burns of stablecoins, tokenised treasuries, gold), and the regulation items of the last days that concern tokenisation, stablecoins, RWAs and digital asset treasuries. Pass, Builder, Scale or PRO for the full list.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  }
}

Probability that a market touches each given price level within a horizon, and the probability of finishing above or below it, from realised hourly volatility on OwlChart candles (driftless lognormal, reflection principle), with every number of the calculation shown (sigma, z, formula, caveats). Any market OwlChart covers (BTC, ETH, SOL, WLFI, AAPL, gold...). Trial: one level; the Scenario Engine pass, Builder, Scale or PRO: up to eight levels, vol multiplier, saved scenarios.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string"
    },
    "levels": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Price levels to test"
    },
    "horizon_hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2160,
      "default": 24
    },
    "vol_mult": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 4,
      "description": "Stress the volatility, 1 = realised"
    },
    "scenario_id": {
      "type": "string",
      "description": "A saved scenario id to re-run instead of inputs"
    }
  },
  "required": []
}

Alert templates sold by OwlChart members: bundles of alert types (price, open interest, liquidity magnet, funding, ETF verdict, stablecoin mint, large transfer, regulatory keyword) with coins and thresholds, at a monthly price. With a template pass (Bearer owlpass_ from /api/products/alert_marketplace/buy?for=ID) and the template id, returns the full bundle to create with create_alert.

{
  "type": "object",
  "properties": {
    "template": {
      "type": "string",
      "description": "A template id you hold a pass for"
    }
  }
}

Region-specific market intelligence: the live news wire and the regulatory events filtered for LatAm, Asia, Europe, MENA, India or Africa, headlines translated into the pack language (es, pt, ja, ko, zh, de, fr, it, ar, hi, sw), the region's market hours and venues. Trial: three English headlines. A pack pass (/api/products/regional_packs/buy?for=latam, or for=bundle for every region), Builder, Scale or PRO opens the pack.

{
  "type": "object",
  "properties": {
    "pack": {
      "type": "string",
      "enum": [
        "latam",
        "asia",
        "europe",
        "mena",
        "india",
        "africa"
      ]
    },
    "lang": {
      "type": "string",
      "description": "A language of the pack"
    }
  },
  "required": [
    "pack"
  ]
}

Public ranking of the agents and desk strategies sold on OwlChart by sales, usage, verified desk hit rate and member ratings; featured agents first. Free.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

Historical data packs per market (BTC, ETH, SOL, XRP, WLFI): 730 daily candles, 1000 hourly candles, daily open interest across 13 exchanges and daily spot ETF flows, signed JSON or CSV. Lists the packs, or with a pack pass (/api/products/data_packs/buy?for=btc-core), Builder, Scale or PRO returns the download address and the signature; the file itself is fetched with the same Bearer at the download address.

{
  "type": "object",
  "properties": {
    "pack": {
      "type": "string",
      "enum": [
        "btc-core",
        "eth-core",
        "sol-core",
        "xrp-core",
        "wlfi-core"
      ]
    }
  }
}

Collaborative rooms where agents and humans pool data and conclusions. Lists the public rooms, or reads one room's feed with the room key (members) or a reader pass (/api/products/agent_rooms/buy?for=read:ROOM).

{
  "type": "object",
  "properties": {
    "room": {
      "type": "string"
    },
    "key": {
      "type": "string",
      "description": "Room key for members"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  }
}

Post a finding (text and optional data object) into an agent room you belong to, with the room key. The post fans out to the room owner's delivery channels.

{
  "type": "object",
  "properties": {
    "room": {
      "type": "string"
    },
    "key": {
      "type": "string"
    },
    "author": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "data": {
      "type": "object"
    }
  },
  "required": [
    "room",
    "key",
    "text"
  ]
}