{"api": "https://api.fractrade.xyz", "app": "https://app.fractrade.xyz", "mcp": "https://api.fractrade.xyz/mcp", "groups": {"markets": "Markets: prices, trends, funding, cost, what a market tracks", "events": "Detections: what the detectors found, as it happens and after", "wallets": "Wallets: who trades, how well, and what they hold", "positioning": "Positioning: what groups of wallets and the whole venue hold", "tracked": "Tracked wallets: the wallets on an account's list and what they did", "news": "News: posts of X accounts, judged, and how often markets are named", "watchlist": "Watchlist: the wallets an account has marked for itself", "account": "Account: signing in with a wallet, API keys, what the account may see", "system": "System: what runs, what was recorded, this reference"}, "endpoints": [{"name": "overview", "method": "GET", "path": "/api/overview", "url": "https://api.fractrade.xyz/overview", "group": "markets", "summary": "The last 24 hours at a glance: totals, activity over time, movers, detections.", "description": "The last 24 hours at a glance: totals, activity over time, movers, detections.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "markets", "method": "GET", "path": "/api/markets", "url": "https://api.fractrade.xyz/markets", "group": "markets", "summary": "Every market with a trade in the last 24 hours: price, change, volume, open interest, funding and its trend per timeframe.", "description": "Every market with a trade in the last 24 hours, the busiest first.\n\nPer market: ``inst``, ``type`` (perp or spot), ``name``, ``last`` (price) at\n``t_ms``, ``change_pct`` and ``notional`` over 24 hours (the venue's own figures\nfor a perpetual: ``change_src`` and ``notional_src`` say whose), ``trades``,\n``hour_notional`` with ``hour_times`` (the last hour against the market's usual\nhour) and ``hour_buy_share`` (the part takers bought), ``spark`` (the price over\nthe day), and for a perpetual ``funding`` (per hour), ``open_interest``,\n``oi_notional`` (in USD), ``oi_change_pct`` and ``mark_px``. ``trends`` is its\ntrend per timeframe, as ``GET /api/trends`` has it.", "params": [{"name": "limit", "in": "query", "type": "integer", "description": "How many markets at most.", "default": 1000, "minimum": 1, "maximum": 5000}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "market", "method": "GET", "path": "/api/markets/{inst}", "url": "https://api.fractrade.xyz/markets/{inst}", "group": "markets", "summary": "One market: what it is, its bars, its detections, its trend and strength; for a stock, index, commodity or currency also what it tracks and whether that market is open.", "description": "One market: what it is, how it trades, what was detected on it.\n\n``instrument`` is the venue's listing (symbol, exchange, base and quote, leverage,\nwhen we first saw it), ``state`` the newest funding, open interest and mark\nprice of a perpetual, ``last`` the last trade. ``bars`` are the one-minute bars\nof the last ``minutes`` (240), of which ``recorded_minutes`` we recorded\nourselves. ``trends`` is the trend per timeframe and ``strength`` the market\nagainst its lead (``GET /api/trends`` explains both). ``tracks``, for a stock,\nindex, commodity or currency, is what it follows and whether that market is open\n(``GET /api/tradfi``). ``events`` are the newest detections on the market.", "params": [{"name": "inst", "in": "path", "type": "string", "description": "An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}, {"name": "minutes", "in": "query", "type": "integer", "description": "How many one-minute bars back.", "default": 240, "minimum": 1, "maximum": 10080}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "candles", "method": "GET", "path": "/api/markets/{inst}/candles", "url": "https://api.fractrade.xyz/markets/{inst}/candles", "group": "markets", "summary": "A market's candles for a chart, oldest first, up to 600.", "description": "A market's candles for a chart, oldest first.\n\n``tf`` is ``1m``, ``5m``, ``15m``, ``1h`` (the default), ``4h`` or ``1d``. Each of\n``candles`` is ``[t, open, high, low, close, notional]``: ``t`` the candle's start\nin seconds since 1970 (UTC), ``notional`` what traded in it in the quote currency.\nAt most 600, the newest still forming. Up to 15 minutes they come from the minutes\nwe recorded (and the venue's where we did not), so they reach back days; from an\nhour up the venue's hourly candles fill the history, back to 15 September 2026.", "params": [{"name": "inst", "in": "path", "type": "string", "description": "An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}, {"name": "tf", "in": "query", "type": "string", "description": "The length of a candle.", "default": "1h", "choices": ["1m", "5m", "15m", "1h", "4h", "1d"]}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "flow", "method": "GET", "path": "/api/markets/{inst}/flow", "url": "https://api.fractrade.xyz/markets/{inst}/flow", "group": "markets", "summary": "What stands behind a market's candles, in the same steps: open interest, funding, what takers bought and sold, liquidations.", "description": "What stands behind a market's candles, in the same steps of time (``tf``, as for\n``/candles``): three series, each oldest first and each with the start of its step\nin seconds since 1970 (UTC) in front.\n\n``oi``: ``[t, open interest in USD, funding per hour]``, both as last recorded in\nthe step; we record them since 13 November 2026, perpetuals only.\n``funding``: ``[t, rate per hour]``: the last rate paid in the step, from\nHyperliquid's own history, which reaches back 90 days.\n``flow``: ``[t, bought, sold]``: the notional takers bought and sold in the step,\nfrom the trades we recorded ourselves (minutes we did not record are left out: the\nvenue's candles do not say who took).\n``liquidations``: ``[t, longs, shorts]``: the value of the positions liquidated in\nthe step, from the archive of all fills, which is a day late.\nA step with nothing recorded is not in a series.", "params": [{"name": "inst", "in": "path", "type": "string", "description": "An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}, {"name": "tf", "in": "query", "type": "string", "description": "The length of a candle.", "default": "1h", "choices": ["1m", "5m", "15m", "1h", "4h", "1d"]}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "cost", "method": "GET", "path": "/api/markets/{inst}/cost", "url": "https://api.fractrade.xyz/markets/{inst}/cost", "group": "markets", "summary": "What trading a market costs right now: the spread, the value resting within 1% of the price, and what a market order of 10,000, 100,000 and 1,000,000 USD pays.", "description": "What trading a market costs right now, from its order book at the venue.\n\n``spread_bps`` is the gap between the best bid and ask in basis points (hundredths\nof a percent) of the middle, ``bid_usd`` and ``ask_usd`` the value resting within\n``depth_pct`` (1) percent of it on each side. ``orders`` has, for a market order of\n``usd`` 10,000, 100,000 and 1,000,000, what it pays against the middle when buying\n(``buy_bps``) and selling (``sell_bps``), half the spread included; null where the\nbook the venue shows is not deep enough. Fees are not in it. The venue is asked\nfor the book (two requests), at most every ``COST_TTL_S`` seconds per market;\n``fracx2.cost`` says how the figures are worked out.", "params": [{"name": "inst", "in": "path", "type": "string", "description": "An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": true}, {"name": "ages", "method": "GET", "path": "/api/markets/{inst}/ages", "url": "https://api.fractrade.xyz/markets/{inst}/ages", "group": "positioning", "summary": "How long the positions on a market have been held: longs and shorts by when they were opened (fresh, this week, this month, months, older), with average entry and what part is losing.", "description": "How long the positions on a market have been held, for longs and for shorts.\n\nA short opened months ago and one opened into today's move are different things;\nthis sorts every position we know of on the market by when it was opened.\n``sides`` has ``long`` and ``short``, each with its ``usd`` and ``wallets`` and its\n``ages``, the youngest first: ``fresh`` (opened since the archive of all fills\nends, which is a day late: the last day or two, today's move included), ``week``\n(in the last 7 days), ``month`` (in the last 30), ``months`` (longer ago, within\nthe archive) and ``older`` (held through the whole archive: about six months or\nmore). Per age: ``wallets``, ``usd``, ``share`` (of the side's value),\n``avg_entry`` and ``under_water`` (the part of the value that is losing at\n``px``), both over the positions whose entry price is known (``entry_known`` of\nthe value: a position opened since the last daily snapshot has none yet), and the\nlargest position (``largest_usd``, ``largest_wallet``).\n\nWhen a position was opened is read from the venue's own record of each fill (what\nthe wallet held just before it), not estimated. A position that was added to keeps\nthe age of its opening. ``archive`` names the days that record covers, ``t_ms``\nwhen the positions were last worked out (every ten minutes). We see about half of\na market's open interest. A short may be the hedge of coins held elsewhere: where\nthe same wallet holds them at the venue, ``hedged_usd`` says how much of the shorts\n(of the short side and of each age) that is, of the shorts whose wallets were asked\n(``asked_usd``); None where nobody was asked (``GET /api/hedges``). Whether age says\nanything about the price to come is not tested: this describes who is there\n(``fracx2.scout.ages``).", "params": [{"name": "inst", "in": "path", "type": "string", "description": "An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "levels", "method": "GET", "path": "/api/levels", "url": "https://api.fractrade.xyz/levels", "group": "markets", "summary": "A market against its price now: reference lines (last week's high and low, the month's open), a usual day's range, and where it turned and traded before.", "description": "A market's support and resistance, against its price now.\n\n``levels``, the highest first: ``price``, ``kind`` (``support`` below the price,\n``resistance`` above), ``distance_pct`` from the price, ``strength`` from 0 to 1,\n``timeframe`` of the candles it was found on (``1h``, ``4h``, ``1d``), ``source``\n(``pivot``: the price turned there, ``touches`` times, last at ``last_touch_ms``;\n``volume``: it traded most there; ``both``). The twelve strongest within 20% of\nthe price. ``support`` and ``resistance`` are the nearest of each, and ``zone`` is\n``near_support`` or ``near_resistance`` when one of some strength is within 1%.\n``profile`` is where the last 200 hours traded: the price with the most volume\n(``poc``) and the range around it holding 70% of the volume (``val`` to ``vah``).\n\n``reference`` are the lines a chart draws: the previous week's high and low and\nthis month's open (``key``, ``label``, ``price``, ``distance_pct``; weeks and months\nby UTC): reference points that many traders watch, not forecasts. In our tests,\nthe longest on six months, no kind of level held more often than random prices.\n\n``expected`` is what a usual day does on this market: ``sigma_pct`` (the usual move\nof a day in percent, from the hourly returns of the last weeks with the newer ones\ncounting more), ``upper`` and ``lower`` (that far from ``day_open``, the price at\n00:00 UTC), ``today_pct`` and ``today_sigmas`` (the move since then, in percent and\nin usual moves) and ``percentile`` (how volatile it is against its own days\nbefore). Measured on 2,985 market-days: the day closed inside the band on 70% of\nthem, and the price left it at some time of the day on 55%.\n\nWorked out when asked, from our hourly candles. They say where the price turned\nand traded before: in our tests they held no more often than random prices at the\nsame distance (``fracx2.levels`` has the figures and the method).", "params": [{"name": "inst", "in": "query", "type": "string", "description": "The market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "trends", "method": "GET", "path": "/api/trends", "url": "https://api.fractrade.xyz/trends", "group": "markets", "summary": "Every perpetual's trend (up, down, sideways) on four timeframes, its change over an hour to a month, its strength against its lead, and the trend of crypto and of stocks as a whole.", "description": "Every perpetual's trend and change, and the trend of the market as a whole.\n\n``markets``, the busiest first: ``trends`` per timeframe (``15m``, ``1h``, ``4h``,\n``1d``): ``trend`` (``up``, ``down``, ``sideways``), ``confidence`` (``high``,\n``medium``, ``low``), ``adx`` (the strength: below 20 is no trend), ``since_ms``\n(since when it is that way); and its change in percent over ``c_1h``, ``c_4h``,\n``c_24h``, ``c_7d`` and ``c_30d`` (null where our candles do not reach back).\nAgainst its ``lead`` (BTC for crypto, the S&P 500 for the shares and indices of\n``xyz``; null for the leads themselves and for commodities and currencies):\n``rel_7d`` and ``rel_30d`` are its change less the lead's, in points; ``corr_7d``\nand ``corr_30d`` how closely its returns followed the lead's (1: step for step),\n``beta_7d`` and ``beta_30d`` how far it moved when the lead moved by one.\n``class`` narrows to ``crypto`` or one of the classes of ``/api/tradfi``. A market\nnew to the venue has no trend on a timeframe until it has 60 candles of it.\n\n``groups``: ``crypto`` (led by BTC) and ``stocks`` (led by the S&P 500), each per\ntimeframe with ``trend``, ``confidence``, the lead market's own trend and the\nbreadth: the share of the other markets' 24-hour volume in an uptrend\n(``breadth_up``), a downtrend and sideways, and how many markets that is.\n\nUp is the price above its 20-candle average and that above the 50-candle one, down\nthe reverse, and neither counts while the ADX is below 20. Worked out every five\nminutes; a trend changes when two runs agree. ``fracx2.trends`` defines all of it.", "params": [{"name": "class", "in": "query", "type": "string", "description": "Only markets of this class; crypto is the main exchange.", "choices": ["crypto", "stocks", "indices", "commodities", "fx", "rates", "preipo"]}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "funding", "method": "GET", "path": "/api/funding", "url": "https://api.fractrade.xyz/funding", "group": "markets", "summary": "Every perpetual's funding per year: now, its averages over 1, 7 and 30 days, where it stands in its own month, and what Binance and Bybit pay for the same market.", "description": "Every perpetual's funding, and what the same market pays on other exchanges.\n\nFunding is what longs pay shorts (a negative rate: shorts pay longs), every hour\non Hyperliquid, as a fraction of the position. All rates here are per year in\npercent of the position, at the hourly rate meant: ``year_pct`` now (``rate`` is\nthe hourly fraction), ``avg_1d``, ``avg_7d`` and ``avg_30d`` what was paid on\naverage over those days, ``paid_30d_pct`` what a long paid over the last 30 days\nin percent of its position, ``percentile`` where the rate now stands among the\nhours of its last 30 days (1: the highest) and ``hours`` how many hours of history\nthat rests on. ``oi_usd`` and ``notional`` (24 hours) say how much can be done.\n\n``binance`` and ``bybit`` are the rate each will pay next for the same market, per\nyear, from Hyperliquid's own comparison (they pay every 1, 4 or 8 hours; null: not\nlisted there). ``gap`` is Hyperliquid's rate less the other exchange's that is\nfurthest from it, ``gap_venue`` which one: short where funding is high and long\nwhere it is low earns the gap, before fees, spread and the margin on both sides.\n``day_10k`` is what a position of 10,000 USD pays (a short: earns) a day at the\nrate now. ``class`` narrows to ``crypto`` or a class of ``/api/tradfi``;\n``min_oi`` (USD) leaves out markets too small to trade. The markets of ``xyz``\nhave no rates of other exchanges. ``summary`` is over the markets returned.", "params": [{"name": "min_oi", "in": "query", "type": "number", "description": "Leave out markets with less open interest than this, in USD.", "default": 0.0, "minimum": 0.0}, {"name": "class", "in": "query", "type": "string", "description": "Only markets of this class; crypto is the main exchange.", "choices": ["crypto", "stocks", "indices", "commodities", "fx", "rates", "preipo"]}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "tradfi", "method": "GET", "path": "/api/tradfi", "url": "https://api.fractrade.xyz/tradfi", "group": "markets", "summary": "The perpetuals on stocks, indices, commodities and currencies: what each tracks, whether its own market is open, how far the price moved since it closed, and how the wallets that won and lost in 30 days are placed on it.", "description": "Perpetuals on stocks, indices, commodities and currencies, the busiest first.\n\n``markets`` has one row per market with a trade in the last 24 hours: ``class``\n(``stocks``, ``indices``, ``commodities``, ``fx``, ``rates``, ``preipo``, as\nHyperliquid states it; ``class=`` narrows to one), ``name`` and ``description`` of\nwhat it tracks, and the figures of ``/api/markets`` (``last``, ``change_pct``,\n``notional``, ``oi_notional``, ``funding`` per hour, ``spark``).\n``funding_year_pct`` is the funding over a year at the current rate, in percent of\nthe position: what a long pays a short.\n\nThe perpetual trades around the clock, what it tracks does not. ``session`` names\nthe hours the market follows (``label``, e.g. ``US stocks``), ``open`` says whether\nthat market is open now, ``since_ms`` since when and ``until_ms`` until when. While\nit is closed ``close_px`` is the perpetual's price when it closed and\n``since_close_pct`` the move since then: on a weekend, what Monday's open is priced\nat. The price is the last trade of the six hours before the close, or where we\nhold none the close of the venue's last whole hour before it. The hours are those\nthe ``xyz`` exchange publishes, with its holidays as far as ``holidays_until``\n(after that day a holiday shows as open); a market of another\nexchange or a company not yet listed has no session.\n\n``winners`` and ``losers`` are the wallets that made and lost 100,000 USD or more\nin the last 30 days and hold the market now: ``long_share``, ``usd``, ``wallets``.\n``events`` counts the detections on the market in 24 hours (without the tracked\nwallets' trades, which are an account's own). ``classes`` adds each\nclass up, ``sessions`` lists the hours with the markets that follow them,\n``perp_notional`` is the 24-hour volume of every perpetual we record, and\n``latest`` the newest detections on these markets.", "params": [{"name": "class", "in": "query", "type": "string", "description": "Only markets of this class.", "choices": ["stocks", "indices", "commodities", "fx", "rates", "preipo"]}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "extras", "method": "GET", "path": "/api/extras", "url": "https://api.fractrade.xyz/extras", "group": "markets", "summary": "The whole crypto market in outside figures: the Fear & Greed index, the large coins' share of the market, and the dollar coins in existence with what came in or left over 1, 7 and 30 days.", "description": "Two figures about the whole crypto market, from public services.\n\n``fear_greed``: alternative.me's index from 0 (extreme fear) to 100 (extreme\ngreed), one value a day: ``value``, ``label`` (their word for it), ``t_ms`` and\n``days`` (``[t_ms, value]``, the last 90). It is that site's reading, made from\nvolatility, momentum, social media and more; shown as theirs.\n``dominance``: from CoinGecko, the share of all coins' value that is Bitcoin\n(``btc``), Ether (``eth``) and the two large dollar coins together (``stable``),\nin percent, with ``market_cap`` and ``market_volume`` (24 hours) in USD, ``t_ms``,\nand ``history`` per figure as ``[t_ms, value]`` by the hour since we began to\nfetch them (16 November 2026), and ``stable_change_24h`` and ``stable_change_7d``:\nby how many points the dollar coins' share moved (null until our history reaches\nthat far). The share moves with prices: it rises when coins fall, with no money\nmoving at all.\n``dollars``: from DefiLlama, all dollar coins in existence in USD (``supply``),\none value a day, with ``change_1d``, ``change_7d`` and ``change_30d`` in USD and\n``days`` (``[t_ms, value]``, the last 90), and the same for the dollar coins on\nHyperliquid (``hyperliquid``). A dollar coin is made when a dollar is paid in and\ndestroyed when one is paid out, so a rising supply is money entering crypto and a\nfalling one is money leaving; unlike the share it does not move with prices.\nNull where nothing was fetched yet.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "agenda", "method": "GET", "path": "/api/agenda", "url": "https://api.fractrade.xyz/agenda", "group": "markets", "summary": "The scheduled dates that move every market: Fed decisions, US inflation and US jobs reports.", "description": "The scheduled events of the next ``days`` (45, up to 400) that move every market.\n\n``events``, the nearest first: ``t_ms`` (when it is published), ``kind`` (``fomc``:\nthe Fed's decision on rates, ``cpi``: US consumer prices, ``jobs``: the US\nemployment report), ``title``, ``day`` (its date in New York) and ``tentative``\n(the Fed's dates of next year, until it confirms them). From a list kept by hand\nfrom the Fed's and the Bureau of Labor Statistics' own calendars; ``known_until``\nis its last date, after which the list is empty until it is renewed.", "params": [{"name": "days", "in": "query", "type": "integer", "description": "How many days ahead.", "default": 45, "minimum": 1, "maximum": 400}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "liquidation_map", "method": "GET", "path": "/api/liquidations/map", "url": "https://api.fractrade.xyz/liquidations/map", "group": "markets", "summary": "Where on a market positions are liquidated: USD of longs below the price and of shorts above it, in half-percent steps.", "description": "Where on a market positions are liquidated: USD of longs below the price and of\nshorts above it.\n\n``inst`` is the market. ``steps`` are half-percent steps of price from 30% below to\n30% above the price now (``px``): ``pct`` is the step's lower edge in percent from\nthat price, ``long_usd`` the longs and ``short_usd`` the shorts whose liquidation\nprice lies in it. The liquidation prices are the venue's own, from its daily snapshot\nof all positions and, for the wallets we watch, from our last look; a position\nopened since the snapshot by a wallet we do not watch has none. ``covered`` says how\nmuch of what we see held on the market is in the map, and ``moved`` how much of the\nmap is positions whose size has changed since their price was given, so that it is\nno longer exact.", "params": [{"name": "inst", "in": "query", "type": "string", "description": "The market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "events", "method": "GET", "path": "/api/events", "url": "https://api.fractrade.xyz/events", "group": "events", "summary": "Detections, newest first: spikes, large and sliced orders, liquidations, transfers, news, new listings and the rest.", "description": "Detections, newest first.\n\nAn event is one finding of one detector: ``id``, ``type`` (the kind of event),\n``detector``, ``mode``, ``market`` (an instrument id, where it is about one),\n``t_ms`` (when it happened), ``title`` (one line in words), ``value`` (its size in\nUSD, where it has one), ``metrics`` and ``evidence`` (the figures behind it, by\nkind of event), ``subjects`` (the wallets and markets it is about, each with its\nrole) and ``delay_ms`` from the venue's time to ours. ``then`` is what the event's\nwallet held on the market right after its order and what the order did (opened,\nadded, reduced, closed, flipped), where that was seen; ``tracks`` on a new listing\nis what the new market follows, once the venue has said it.\n\nNarrowed by ``detector``, ``exclude`` (detectors to leave out), ``market``,\n``subject`` (a wallet), ``mode``, and in time by ``since`` and ``before`` (ms);\npage back by passing the oldest ``t_ms`` received as ``before``.", "params": [{"name": "limit", "in": "query", "type": "integer", "description": "How many events at most.", "default": 100, "minimum": 1, "maximum": 1000}, {"name": "detector", "in": "query", "type": "string", "description": "Only this detector's events (GET /api/detectors lists them)."}, {"name": "exclude", "in": "query", "type": "string", "description": "Detectors to leave out, with commas between them, at most 8."}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "subject", "in": "query", "type": "string", "description": "Only events about this wallet or entity id."}, {"name": "mode", "in": "query", "type": "string", "description": "Only events of this mode.", "choices": ["live", "shadow"]}, {"name": "since", "in": "query", "type": "integer", "description": "Only events at or after this time, ms since 1970.", "default": 0, "minimum": 0, "maximum": 4611686018427387904}, {"name": "before", "in": "query", "type": "integer", "description": "Only events before this time, ms since 1970.", "default": 0, "minimum": 0, "maximum": 4611686018427387904}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "stream", "method": "GET", "path": "/api/events/stream", "url": "https://api.fractrade.xyz/events/stream", "group": "events", "summary": "Events as they happen, as server-sent events; starts with the last few.", "description": "Events as they happen, as server-sent events. Starts with the last few.", "params": [], "open": false, "account": false, "writes": false, "stream": true, "asks_venue": false}, {"name": "signals", "method": "GET", "path": "/api/signals", "url": "https://api.fractrade.xyz/signals", "group": "events", "summary": "What detectors saw and did not publish, newest first, in the shape of events.", "description": "What detectors saw and did not publish, newest first, in the shape of events.", "params": [{"name": "limit", "in": "query", "type": "integer", "description": "How many signals at most.", "default": 60, "minimum": 1, "maximum": 500}, {"name": "detector", "in": "query", "type": "string", "description": "Only this detector's signals."}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "scoreboard", "method": "GET", "path": "/api/scoreboard", "url": "https://api.fractrade.xyz/scoreboard", "group": "events", "summary": "Per kind of event: how often the price went the way the event said after 15 minutes, 1 hour and 4 hours, beside control times.", "description": "What the price did after each kind of event: the test of the detectors.\n\nPer event type, for 15 minutes, 1 hour and 4 hours after its live events of the\nlast ``days`` (7): ``events`` measured, ``signed`` of them saying which way, ``hit``\nthe share where the price went that way and ``move`` the median return that way in\npercent, with ``hit_control`` and ``move_control`` for control times on the same\nmarkets (what chance gives). ``size`` and ``size_control`` are the median move\neither way, for events that point nowhere. ``fracx2.jobs.outcomes`` defines the\ndirections and measures the prices; a figure on a handful of events means little.", "params": [{"name": "days", "in": "query", "type": "integer", "description": "Over the events of the last so many days.", "default": 7, "minimum": 1, "maximum": 90}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "wallets", "method": "GET", "path": "/api/wallets", "url": "https://api.fractrade.xyz/wallets", "group": "wallets", "summary": "The wallets that traded most in the trades we recorded.", "description": "The wallets that traded most in the trades we recorded, the largest first.\n\nOver the last ``window`` days (1, 7 or 30): what each took and made\n(``taker_notional``, ``maker_notional``, the fills of each kind), on how many\n``markets``, its ``maker_share``, its ``role`` and ``owner`` where known, and\n``after_bps``: what the price did after its taker orders, in basis points its\nway, over ``orders_measured`` orders. It covers the time we recorded\n(``GET /api/recorded``); ``GET /api/leaderboard`` and ``GET /api/discover`` rank\nwallets over longer periods.", "params": [{"name": "window", "in": "query", "type": "integer", "description": "Over the last so many days: 1, 7 or 30.", "default": 1, "minimum": 1, "maximum": 30}, {"name": "limit", "in": "query", "type": "integer", "description": "How many wallets at most.", "default": 100, "minimum": 1, "maximum": 1000}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "wallet", "method": "GET", "path": "/api/wallets/{id}", "url": "https://api.fractrade.xyz/wallets/{id}", "group": "wallets", "summary": "One wallet: its role, owner, measures, detections and last trades.", "description": "One wallet, from what we recorded of it.\n\n``role`` (what kind of account it is, and its ``owner`` where known),\n``measures`` (what it took and made over 1, 7 and 30 days), ``markouts`` (what the\nprice did after its orders), ``leaderboard`` (the venue's own figures for it and\nits rank of the month), ``events`` (the detections about it) and ``trades`` (its\nlast trades in what we recorded, each as taker or maker).\n``GET /api/wallets/{id}/analysis`` has its trades worked out as positions, and\n``GET /api/wallets/{id}/history`` its months from the archive.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "positions", "method": "GET", "path": "/api/wallets/{id}/positions", "url": "https://api.fractrade.xyz/wallets/{id}/positions", "group": "wallets", "summary": "What a wallet holds in perpetuals now, asked of the venue.", "description": "What a wallet holds in perpetuals now. With ``market``: on that market's exchange.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "market", "in": "query", "type": "string", "description": "Only the exchange this market is on (one request). An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": true}, {"name": "orders", "method": "GET", "path": "/api/wallets/{id}/orders", "url": "https://api.fractrade.xyz/wallets/{id}/orders", "group": "wallets", "summary": "A wallet's resting orders, asked of the venue: per market what rests to buy and to sell, what only closes, its stop, and the orders nearest the price.", "description": "A wallet's resting orders at the venue, asked now: where it means to buy, sell,\ntake profit and stop.\n\n``markets`` has one entry per market the wallet has orders on, the largest value\nfirst: ``orders`` (how many), ``buy_usd`` and ``sell_usd`` (what rests on each\nside), ``closing_usd`` (the part that can only close a position), ``low_px`` and\n``high_px`` (the range they span), ``stop_px`` (the stop nearest the price),\n``mid_px`` (the price now) and ``rows``: the orders, the nearest to the price\nfirst. An order has ``side`` (buy, sell), ``kind`` (limit, stop, take_profit),\n``px`` (its limit price, or for a stop or take-profit the price that triggers it),\n``size`` and ``value`` (None where the order closes the whole position whatever its\nsize: ``whole_position``), ``reduce_only``, ``away`` (how far ``px`` is from the\nprice now, as a share of it: 0.05 is 5% above) and ``placed_ms``. ``rows`` has a\nmarket's 12 orders nearest the price, the sums are over all of them; a market with\nmore than 30 orders is a grid or a market maker's quotes (``grid``).\n\nAsked are the venue's main exchange (spot orders included) and ``xyz``; with\n``market`` only that market's exchange, and only its orders are given. A resting\norder is an intention and can be cancelled at any moment. Most wallets have none:\nof 45 wallets that made over a million USD in 30 days, 11 had any and one had a\nstop (2026-11-17, ``fracx2.orders``).", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "market", "in": "query", "type": "string", "description": "Only this market's orders (one exchange asked). An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": true}, {"name": "analysis", "method": "GET", "path": "/api/wallets/{id}/analysis", "url": "https://api.fractrade.xyz/wallets/{id}/analysis", "group": "wallets", "summary": "One wallet by its trades: every window, its markets, its last trades, what it has open, and where it stands among all wallets of the venue.", "description": "One wallet by its trades: every window, its markets, its last trades.\n\n``build`` says what it rests on: how many fills, from when to when, how many times\nthey did not join up, how many positions are open, and when the wallet was last\nlooked at. ``pending`` is true while a look someone asked for (``PUT``) is still to\ncome. ``markets`` and ``trades`` are of the last 30 days. ``open`` is what it had\nopen when it was last looked at; ``candidate.since_found`` what it made after the\nsweep found it. ``venue`` is where it stands among all wallets of the venue: its\n``standing`` from 100 to 0 (``GET /api/ranking/test`` says by which ranking), what it\nmade over 30 days and over all the days held, and its tier of every kind\n(``GET /api/tiers``); null for a wallet the venue-wide data does not have.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "limit", "in": "query", "type": "integer", "description": "How many trades at most.", "default": 100, "minimum": 1, "maximum": 1000}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "analyse", "method": "PUT", "path": "/api/wallets/{id}/analysis", "url": "https://api.fractrade.xyz/wallets/{id}/analysis", "group": "wallets", "summary": "Ask for a wallet's fills to be fetched and analysed now; with wait, the answer is the finished analysis.", "description": "Ask for a wallet to be looked at now: its fills fetched and its trades worked out.\n\nThe scout does it, usually within a few seconds. With ``wait`` (seconds, at most 60)\nthe answer comes when it is done and is the analysis itself, as ``GET`` gives it:\none call for \"analyse this wallet now\". If it is not done in that time, ``pending``\nis true in the answer. Without ``wait``: ``GET`` the analysis until ``pending`` is\nfalse.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "wait", "in": "query", "type": "integer", "description": "Seconds to wait for the analysis before answering.", "default": 0, "minimum": 0, "maximum": 60}, {"name": "limit", "in": "query", "type": "integer", "description": "How many trades at most.", "default": 100, "minimum": 1, "maximum": 1000}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": true, "stream": false, "asks_venue": true}, {"name": "history", "method": "GET", "path": "/api/wallets/{id}/history", "url": "https://api.fractrade.xyz/wallets/{id}/history", "group": "wallets", "summary": "Any wallet's months on the venue, from the archive of every fill: what it made day by day and market by market.", "description": "Any wallet's months on the venue, from the archive of every fill.\n\nFor every address that traded perpetuals in the days the archive holds (about six\nmonths, to the day before yesterday), whether or not anyone asked about it before.\n``result`` is everything it made: what it closed and what its open positions gained\nor lost, less fees, without funding; ``closed`` is the closed part alone. ``days``\nhas every day from ``first_day`` to ``through`` with the day's ``result`` and the\n``total`` so far; ``markets`` has each market with its result, volume, the orders\nthat closed at a profit and at a loss, and what is still held (``held``,\n``held_usd`` at the last close). ``drawdown`` is the largest fall of the total from\na peak, in USD. ``carried_in`` counts positions held from before the first day: they\ncount from that day on. ``days=`` narrows all of it to the last so many days.\n``known`` is false for a wallet with no fill in the archive.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "days", "in": "query", "type": "integer", "description": "Only the last so many days; 0 for all.", "default": 0, "minimum": 0, "maximum": 400}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "wallet_trades", "method": "GET", "path": "/api/wallets/{id}/trades", "url": "https://api.fractrade.xyz/wallets/{id}/trades", "group": "wallets", "summary": "What a wallet did on one market, in the steps of that market's chart: bought, sold, the position after, what it realised.", "description": "What a wallet did on one market, in the steps of that market's chart.\n\n``inst`` is the market, ``tf`` the length of a step as for\n``/api/markets/{inst}/candles``. ``trades``, oldest first, has a row for every\nstep in which the wallet had a fill: ``[t, bought, sold, buy_px, sell_px,\nposition, realised, fills]``: the start of the step (seconds since 1970, UTC),\nthe notional it bought and sold and at which average prices (null where it did\nneither), the signed position it held after its last fill of the step (in the\nmarket's unit; negative is short), what it realised in the step less fees, and\nthe number of fills. Up to 600 steps back from now.\n\nFills come from our own fetch of the wallet where we have it (to the minute, TWAP\nslices included) and before that from the archive of all fills (every wallet of\nthe venue, six months, a day late); ``own_from_ms`` says from when our own fetch\nstands. It is null for a wallet nobody tracks and the scout does not watch: such\na wallet has the archive alone, so its last day or two are missing.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "inst", "in": "query", "type": "string", "description": "The market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true}, {"name": "tf", "in": "query", "type": "string", "description": "The length of a candle.", "default": "1h", "choices": ["1m", "5m", "15m", "1h", "4h", "1d"]}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "leaderboard", "method": "GET", "path": "/api/leaderboard", "url": "https://api.fractrade.xyz/leaderboard", "group": "wallets", "summary": "The venue's own ranking of its wallets, with what we know of each.", "description": "The venue's leaderboard as last fetched, with what we know of each wallet.", "params": [{"name": "window", "in": "query", "type": "string", "description": "The period ranked.", "default": "month", "choices": ["day", "week", "month", "all"]}, {"name": "sort", "in": "query", "type": "string", "description": "Ranked by profit, return, volume or account value.", "default": "pnl", "choices": ["pnl", "roi", "volume", "account"]}, {"name": "order", "in": "query", "type": "string", "description": "The best first, or the worst.", "choices": ["top", "bottom"]}, {"name": "min_account", "in": "query", "type": "integer", "description": "Only accounts worth this much, in USD.", "default": 10000, "minimum": 0, "maximum": 1000000000000}, {"name": "q", "in": "query", "type": "string", "description": "Part of an address or of a name."}, {"name": "limit", "in": "query", "type": "integer", "description": "How many wallets at most.", "default": 200, "minimum": 1, "maximum": 1000}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "discover", "method": "GET", "path": "/api/discover", "url": "https://api.fractrade.xyz/discover", "group": "wallets", "summary": "Wallets ranked by their own trades.", "description": "Wallets ranked by their own trades.\n\n``window`` (24h, 3d, 7d, 30d) is the period of the trades, up to now; ``day``\n(``today``, ``yesterday`` or YYYY-MM-DD, UTC) takes one day instead. ``sort`` is score,\npnl, roi, win_rate or trades (``fracx2.scout.measures`` defines them). The filters:\n``min_trades`` (5), ``min_win_rate`` and ``min_roi`` in percent, ``min_pnl`` in USD,\n``min_hold`` in seconds (60: a wallet faster than that is a machine), ``style``,\n``min_account`` in USD, ``max_fills_day``. ``inst`` (one market) or ``class``\n(``crypto``: the main exchange; ``tradfi``: the stocks, indices and commodities on\n``xyz``) ranks the wallets by their trades there alone. ``named=1`` lists only wallets\nwith a name (``GET /api/names``). ``candidates=1`` lists only\nwallets the\ndaily sweep found; ``tracked=1`` includes those on the account's list already.\n``pnl_month`` and ``roi_month`` are the venue's own figures, which count open\npositions too: a wallet that keeps its losers open looks better on its closes than\nit is, and the venue's figure shows it. ``open_pnl`` is what its open positions were\nup or down when it was last looked at (``open_ms``); ``max_open_loss`` (percent of the\nperiod's profit) leaves out wallets whose open positions are down by more.\n``since_found``, for a wallet the sweep found, is what it made after that\n(``fracx2.scout.looks``), and ``forward`` adds those up: the test of the sweep.\n``standing`` is the wallet's place among all active wallets of the venue, from 100\n(first) to 0, by the way of ranking that held best in the venue-wide test\n(``standing_rule``; ``GET /api/ranking/test``); null for a wallet that was not\nactive enough in the newest week to be ranked.", "params": [{"name": "window", "in": "query", "type": "string", "description": "The period of the trades, up to now.", "default": "7d", "choices": ["24h", "3d", "7d", "30d"]}, {"name": "day", "in": "query", "type": "string", "description": "One UTC day instead of a window: today, yesterday or YYYY-MM-DD."}, {"name": "sort", "in": "query", "type": "string", "description": "What to rank by.", "default": "score", "choices": ["score", "pnl", "roi", "win_rate", "trades"]}, {"name": "min_trades", "in": "query", "type": "integer", "description": "Only wallets with this many closed trades.", "default": 5, "minimum": 1, "maximum": 100000}, {"name": "min_win_rate", "in": "query", "type": "number", "description": "Only wallets that won this share of their trades, percent.", "default": 0, "minimum": 0.0}, {"name": "min_roi", "in": "query", "type": "number", "description": "Only wallets with this return, in percent.", "default": 0.0, "minimum": -1000000000.0}, {"name": "min_pnl", "in": "query", "type": "number", "description": "Only wallets that made this much, in USD.", "default": 0.0, "minimum": -1000000000000000.0}, {"name": "min_hold", "in": "query", "type": "number", "description": "Only wallets that hold a position this long on average, in seconds.", "default": 60.0, "minimum": 0.0}, {"name": "style", "in": "query", "type": "string", "description": "Only wallets of this style of trading.", "choices": ["scalper", "day_trader", "swing_trader", "position_trader"]}, {"name": "min_account", "in": "query", "type": "number", "description": "Only accounts worth this much, in USD.", "default": 0.0, "minimum": 0.0}, {"name": "max_fills_day", "in": "query", "type": "integer", "description": "Leave out wallets with more fills a day than this (machines).", "default": 0, "minimum": 1, "maximum": 1000000000}, {"name": "max_open_loss", "in": "query", "type": "number", "description": "Leave out wallets whose open positions are down by more than this, in percent of the period's profit.", "default": 50.0, "minimum": 0.0}, {"name": "inst", "in": "query", "type": "string", "description": "Rank by the trades on this market alone. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "class", "in": "query", "type": "string", "description": "Rank by the trades on the main exchange (crypto) or on the stocks, indices and commodities (tradfi) alone.", "choices": ["crypto", "tradfi"]}, {"name": "named", "in": "query", "type": "string", "description": "1: only wallets with a name.", "choices": ["0", "1"]}, {"name": "candidates", "in": "query", "type": "string", "description": "1: only wallets the daily sweep found.", "choices": ["0", "1"]}, {"name": "tracked", "in": "query", "type": "string", "description": "1: include wallets that are on the account's list already.", "choices": ["0", "1"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many wallets at most.", "default": 100, "minimum": 1, "maximum": 500}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "ranking_test", "method": "GET", "path": "/api/ranking/test", "url": "https://api.fractrade.xyz/ranking/test", "group": "wallets", "summary": "Which way of picking wallets holds: picks at past cuts over every wallet of the venue, measured on the week after.", "description": "Which way of picking wallets holds: the test over every wallet of the venue.\n\nAt each cut (a Monday, 00:00 UTC) every wallet that was active in the week before\nis ranked on what was known then, and the first ``top`` (30, 300, 2,000) of each way\nof ranking are followed through the week after. A wallet's result counts what it\nclosed and what its open positions gained or lost, less fees. The ways (``rule``):\n``closed`` (profit closed in the week before), ``return`` (that against what it\ntraded), ``result`` (made in the week before, open positions counted), ``month``\n(the same over four weeks), ``steady`` (as ``month``, only wallets that made money\nin each of the four weeks) and ``others`` (every wallet that could have been picked:\nwhat chance gives). ``overall`` adds the cuts up: ``weeks``, ``wallets`` picked,\n``up``, ``down`` and ``flat`` of them (made money, lost, did nothing),\n``in_profit`` (up of up and down), ``chance`` (the same for all wallets over the\nsame cuts), ``better`` (cuts at which the picks beat chance) and ``total`` in USD.\n``weeks`` lists every cut. ``watched`` says which wallets are analysed live as a\nresult: the ``wallets`` picked on ``day``, of which ``steady`` made money in each\nof the four weeks before and the rest are the largest closed profits of the last\nweek. ``fracx2.scout.venue`` defines all of it.", "params": [], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "names", "method": "GET", "path": "/api/names", "url": "https://api.fractrade.xyz/names", "group": "wallets", "summary": "The wallets with a name: the venue's display names and those given by hand.", "description": "The wallets with a name: ``name``, ``kind`` (fund, trader, market_maker, exchange,\nother), ``note`` (where the name comes from) and ``source``: ``venue`` for a display\nname the wallet's owner set on Hyperliquid's leaderboard, ``hand`` for one given by\nwhoever runs this system, which wins. ``kind`` narrows the list.", "params": [{"name": "kind", "in": "query", "type": "string", "description": "Only names of this kind.", "default": "", "choices": ["fund", "trader", "market_maker", "exchange", "other"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many names at most.", "default": 5000, "minimum": 1, "maximum": 20000}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "top_trades", "method": "GET", "path": "/api/trades/top", "url": "https://api.fractrade.xyz/trades/top", "group": "wallets", "summary": "The trades of the day: what each position realised in a period, the best or the worst first.", "description": "What positions realised in a period, the best or the worst first.\n\nA trade here is what one wallet's position on one market realised in the period\n(``fracx2.scout.measures``): closed for good or in part. ``by`` ranks by what it made\nin USD (``usd``) or by its return on the position (``pct``); ``order`` is ``best`` or\n``worst``. The period is a UTC ``day`` (YYYY-MM-DD) or the last ``hours``, from a full\nhour. ``min_value`` is the smallest entry value listed; ``market`` and ``direction``\nnarrow it. ``ended`` says whether the position is closed; if not, ``remaining`` is\nwhat it still held after its last close. The trades are those of the wallets whose\nfills we have; ``coverage`` says how many those are.", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 24, "minimum": 1, "maximum": 168}, {"name": "day", "in": "query", "type": "string", "description": "One UTC day instead of the last hours: YYYY-MM-DD."}, {"name": "by", "in": "query", "type": "string", "description": "Ranked by USD made or by return.", "default": "usd", "choices": ["usd", "pct"]}, {"name": "order", "in": "query", "type": "string", "description": "The best first, or the worst.", "default": "best", "choices": ["best", "worst"]}, {"name": "min_value", "in": "query", "type": "number", "description": "Only positions entered with this value, in USD.", "default": 0.0, "minimum": 0.0}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "direction", "in": "query", "type": "string", "description": "Only longs or only shorts.", "choices": ["long", "short"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many trades at most.", "default": 50, "minimum": 1, "maximum": 500}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "whales", "method": "GET", "path": "/api/whales", "url": "https://api.fractrade.xyz/whales", "group": "wallets", "summary": "The largest taker orders of the last hours with who placed each, and the alerts for new wallets that arrived with a large order.", "description": "The largest taker orders of the last hours, and the new wallets among them.\n\n``orders``: one row per order (a wallet's executions on one market and side under\none transaction; the slices of a TWAP order together), of ``min_value`` (100,000 USD)\nor more within the last ``hours`` (4), the largest first; ``market`` narrows to one.\nEach has the wallet's leaderboard name and account where it has one, whether we\nhave analysed it (``analysed``), and, where it was looked up, when it first traded\n(``first_fill_ms``; ``first_fill_exact`` false: it is older than that; ``new`` if\nit first traded within 7 days). ``alerts`` are the events of type ``new_whale`` of\nthe last ``days`` (7): a wallet under a week old placing an order of 500,000 USD or\nmore (``fracx2.scout.newcomers``). Those of them that are the insider's pattern (a\nfresh wallet, funded just before, with one bet larger than its account) are not\nhere: ``GET /api/insiders`` has them.", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 4, "minimum": 1, "maximum": 72}, {"name": "min_value", "in": "query", "type": "number", "description": "Only orders of this value, in USD.", "default": 100000.0, "minimum": 0.0}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "days", "in": "query", "type": "integer", "description": "The new-wallet alerts of the last so many days.", "default": 7, "minimum": 1, "maximum": 90}, {"name": "limit", "in": "query", "type": "integer", "description": "How many orders at most.", "default": 50, "minimum": 1, "maximum": 500}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "insiders", "method": "GET", "path": "/api/insiders", "url": "https://api.fractrade.xyz/insiders", "group": "wallets", "summary": "Possible insider trades: a fresh wallet is paid into and at once makes one bet larger than its account. What the price did after each, and how all of them did against chance.", "description": "Possible insider trades: a fresh wallet is paid into and makes one large bet.\n\nThe pattern of someone who knows something others do not: an account nobody has\nseen before, money arriving, and at once a position far larger than that money.\nAll three must hold (``rule`` has them in numbers): the order of at least\n``min_value`` USD comes within ``fresh_hours`` of the wallet's very first trade on\nthe venue; money was paid into the wallet within ``funded_days`` before it; and\nafter it the wallet holds a position on that market of at least ``bet`` times its\naccount. A new wallet that has traded for days, or holds nothing afterwards, is a\nlarge trader with another account and is not here (``GET /api/whales``, ``alerts``).\nThe pattern says what an order looks like, not that anyone knows anything: a\ntrader who opens a new account for one leveraged trade looks the same.\n\n``alerts``, newest first, of the last ``days`` (7), from ``min_value`` up, on one\n``market`` or all: ``t_ms``, ``wallet``, ``side`` (buy or sell), ``market``,\n``value`` (USD), ``px`` (its average price), ``fills`` and ``twap`` (whether it\nwas sliced), ``age_hours`` (from the wallet's first trade to the order),\n``funded_usd`` (paid into the wallet before the order), ``funded_minutes`` (from\nthe last payment to the order), ``account_value`` and ``position`` right after,\n``leverage`` (the position against the account). What the price did afterwards, in\npercent in the order's direction (positive: it went the order's way): ``after`` at\n15 minutes, 1 hour and 4 hours, each null until that time has passed and been\nmeasured, and ``since_pct`` from the order's price to ``px_now``.\n\n``score`` is how all such alerts of the last 30 days did against chance, as\n``GET /api/scoreboard`` has it for every kind of event: per horizon ``events``,\n``hit`` (the share that went the order's way), ``hit_control`` (the same at\nrandom times on the same markets), ``move`` and ``move_control``. The pattern is\nrare; with a handful of alerts, several on one market in the same hours, a\ndifference is not yet evidence. ``markets`` says how they spread.", "params": [{"name": "days", "in": "query", "type": "integer", "description": "The alerts of the last so many days.", "default": 7, "minimum": 1, "maximum": 90}, {"name": "min_value", "in": "query", "type": "number", "description": "Only orders of this value, in USD.", "default": 0.0, "minimum": 0.0}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "limit", "in": "query", "type": "integer", "description": "How many alerts at most.", "default": 200, "minimum": 1, "maximum": 500}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "hedges", "method": "GET", "path": "/api/hedges", "url": "https://api.fractrade.xyz/hedges", "group": "positioning", "summary": "Which shorts are hedges: per market, what of the short value is against coins the same wallet holds on the venue's spot side or in staking, and the long share with those shorts left out. With market, the single shorts.", "description": "Which shorts are hedges: against coins the same wallet holds at the venue.\n\nA wallet short a coin's perpetual that holds the same coin on Hyperliquid's spot\nside or in staking is not betting against it: it earns the funding or protects\nwhat it holds. For every market whose coin has a spot side, ``markets`` gives\n``short_usd`` and ``long_usd`` (all positions we know of), ``asked_usd`` (the shorts\nwhose wallets were asked what they hold: those of ``rule.min_usd`` or more, asked\nevery hour; ``asked_share`` of the short value), ``hedged_usd`` (of those, what is\ncovered by coins the same wallet holds; ``spot_usd`` is the part in spot, the rest\nis staking; ``hedging`` the wallets), ``hedged`` (its share of all shorts),\n``open_short_usd`` (the shorts that are left) and the long share with every short\ncounted (``long_share``) and with the hedged ones left out (``long_share_open``).\n\nWith ``market`` also ``shorts``: the asked shorts on it, each with its wallet, what\nthe wallet holds of the coin (``spot_usd``, ``staked_usd``), ``hedged_usd`` and\n``hedged`` (1: wholly covered), ordered ``by`` ``hedged`` (most covered value\nfirst), ``short`` (largest first) or ``open`` (the largest uncovered first: the\nreal bets).\n\n``hedged_usd`` is a floor. Not seen: coins on another wallet of the same owner, on\nanother exchange or chain or moved to HyperEVM, and shorts under ``rule.min_usd``.\nA coin without a spot side on the venue is not listed. Whether the hedged share\nsays anything about the price to come is not tested (``fracx2.scout.hedges``).", "params": [{"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "by", "in": "query", "type": "string", "description": "With market, the order of the shorts: most covered value, largest short, or largest uncovered short first.", "default": "hedged", "choices": ["hedged", "short", "open"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many shorts at most.", "default": 50, "minimum": 1, "maximum": 500}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "liquidations", "method": "GET", "path": "/api/liquidations", "url": "https://api.fractrade.xyz/liquidations", "group": "wallets", "summary": "Positions of the watched wallets that the venue liquidated, newest first.", "description": "Positions of the watched wallets that the venue liquidated, newest first.\n\nOne row is a wallet's liquidation fills on a market within a minute: ``was`` (long or\nshort), ``value``, the average ``px``, and ``pnl`` (what it realised, after fees).\nOnly wallets whose fills we fetch are covered (``fracx2.scout.ledger``); a\nliquidation is here a minute or two after it happened.", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 24, "minimum": 1, "maximum": 720}, {"name": "min_value", "in": "query", "type": "number", "description": "Only liquidations of this value, in USD.", "default": 10000.0, "minimum": 0.0}, {"name": "limit", "in": "query", "type": "integer", "description": "How many rows at most.", "default": 100, "minimum": 1, "maximum": 1000}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "transfers", "method": "GET", "path": "/api/transfers", "url": "https://api.fractrade.xyz/transfers", "group": "wallets", "summary": "Deposits, withdrawals and sends of the watched wallets, newest first.", "description": "Money moved in or out of the watched wallets' accounts, newest first.\n\n``kind`` is the venue's word (deposit, withdraw, send), ``direction`` in or out,\n``other`` the wallet on the other end of a send. Moves between a wallet's own\naccounts are left out. A wallet's list is read when its account value changed by\nmore than its trading explains, so a transfer shows up to an hour after it happened,\nand small ones may not show at all (``fracx2.scout.ledger``).", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 24, "minimum": 1, "maximum": 720}, {"name": "min_usd", "in": "query", "type": "number", "description": "Only transfers of this size, in USD.", "default": 100000.0, "minimum": 0.0}, {"name": "direction", "in": "query", "type": "string", "description": "Only money coming in, or going out.", "choices": ["in", "out"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many rows at most.", "default": 100, "minimum": 1, "maximum": 1000}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "positioning", "method": "GET", "path": "/api/positioning", "url": "https://api.fractrade.xyz/positioning", "group": "positioning", "summary": "What a group of the analysed wallets holds on each market now: wallets and value long and short, the lean, and the flow of 24 hours.", "description": "What a group of the analysed wallets holds on each market now.\n\n``group`` is ``all`` (every wallet looked at), ``profitable`` (by their trades of 7\ndays), ``candidates`` (found by the sweep) or ``tracked`` (the account's list);\n``fracx2.scout.positioning`` defines them. Per market: wallets and value long and\nshort, what each side is up or down, ``net_pct`` and ``lean`` (long, short, split),\nand how many of the positions were opened in the last 24 hours. Beside it the flow\nof those 24 hours, the old sentiment: how many of the group bought and sold, how\nmuch, ``net_volume_pct`` and ``sentiment`` (bullish, bearish, neutral). Markets with\nfewer than ``min_wallets`` (3) wallets holding or trading are left out. ``coverage``\nsays how many wallets of the group hold something and how old the oldest look\ncounted is.", "params": [{"name": "group", "in": "query", "type": "string", "description": "Which wallets: all that are analysed, those profitable on their trades of 7 days, those the daily sweep found, or those on the account's list of tracked wallets.", "default": "all", "choices": ["all", "profitable", "candidates", "tracked"]}, {"name": "min_wallets", "in": "query", "type": "integer", "description": "Leave out markets with fewer wallets than this.", "default": 3, "minimum": 1, "maximum": 10000}, {"name": "limit", "in": "query", "type": "integer", "description": "How many markets at most.", "default": 300, "minimum": 1, "maximum": 1000}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "positions_now", "method": "GET", "path": "/api/positioning/positions", "url": "https://api.fractrade.xyz/positioning/positions", "group": "positioning", "summary": "The single positions behind the positioning: the largest, the nearest to liquidation, the most in profit or in loss.", "description": "The single positions of a group of the analysed wallets, as of each one's last look.\n\n``by`` orders them: ``value`` (largest first), ``liquidation`` (nearest to its\nliquidation price first; ``distance`` is how far the mark price is from it),\n``pnl`` (most unrealised profit) or ``loss``. ``market`` narrows to one market,\n``side`` to long or short, ``min_value`` to positions of that notional or more.\n``t_open`` is when the position was opened, if that was within the last 24 hours.", "params": [{"name": "group", "in": "query", "type": "string", "description": "Which wallets: all that are analysed, those profitable on their trades of 7 days, those the daily sweep found, or those on the account's list of tracked wallets.", "default": "all", "choices": ["all", "profitable", "candidates", "tracked"]}, {"name": "by", "in": "query", "type": "string", "description": "How to order them.", "default": "value", "choices": ["value", "liquidation", "pnl", "loss"]}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "side", "in": "query", "type": "string", "description": "Only longs or only shorts.", "choices": ["long", "short"]}, {"name": "min_value", "in": "query", "type": "number", "description": "Only positions of this value, in USD.", "default": 0.0, "minimum": 0.0}, {"name": "limit", "in": "query", "type": "integer", "description": "How many positions at most.", "default": 100, "minimum": 1, "maximum": 1000}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "consensus_now", "method": "GET", "path": "/api/consensus", "url": "https://api.fractrade.xyz/consensus", "group": "positioning", "summary": "The markets on which the analysed wallets are opening the same side right now, and the consensus events of the last days.", "description": "Where the analysed wallets are opening the same side of a market right now.\n\n``standing`` lists every market on which a counted wallet opened something within\nthe window, the most one-sided first: wallets and value on each side, the wallets\nof the larger side, and ``missing``: what keeps it from being a consensus (empty\nwhen it is one). ``events`` are the consensus events of the last ``days`` (7), which\n``python -m fracx2.jobs.consensus`` publishes; ``rule`` is the rule in numbers.\n``fracx2.scout.consensus`` defines all of it.", "params": [{"name": "days", "in": "query", "type": "integer", "description": "The consensus events of the last so many days.", "default": 7, "minimum": 1, "maximum": 90}, {"name": "limit", "in": "query", "type": "integer", "description": "How many markets at most.", "default": 50, "minimum": 1, "maximum": 500}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "tiers", "method": "GET", "path": "/api/tiers", "url": "https://api.fractrade.xyz/tiers", "group": "positioning", "summary": "Who of the whole venue is long and who is short: every wallet by account size and by profit, what each tier holds, now and over time.", "description": "Who of the whole venue is long and who is short: every wallet by size and by profit.\n\nEvery wallet of the venue is in a tier of each ``kind``: ``size`` (account value:\nsmall under 10K USD, medium to 100K, large to 1M, whale above), ``profit_30`` and\n``profit_all`` (what it made in USD over 30 days and over all the days held, up to\nsix months: ``won_1m``, ``won_100k``, ``won``, ``lost``, ``lost_100k``, ``lost_1m``)\nand ``return_30`` and ``return_all`` (the same in percent of its account: ``up_50``,\n``up_10``, ``up``, ``down``, ``down_10``, ``down_50``). Per tier: ``wallets``\nholding anything, ``wallets_long`` and ``wallets_short`` (net, over all their\nmarkets), ``long_usd`` and ``short_usd``, ``long_share`` (long of long and short),\n``lean`` (strongly_long from 70%, long from 58%, balanced, short under 42%,\nstrongly_short under 30%) and ``line``: the long share over the last ``days`` (30),\nas ``[ms, share]``. With ``inst`` the figures are those of one market, and there is\nno line; there each tier also has ``hedged_usd`` (of its shorts, what the same\nwallets hold of the coin at the venue: ``GET /api/hedges``) and ``long_share_open``\nand ``lean_open``, the same with those shorts left out. What a wallet holds is the\nvenue's daily snapshot of all positions moved on by every fill since\n(``snapshot_day``, ``t_ms``); ``fracx2.scout.tiers`` defines it.", "params": [{"name": "days", "in": "query", "type": "integer", "description": "How many days of each tier's line.", "default": 30, "minimum": 1, "maximum": 90}, {"name": "inst", "in": "query", "type": "string", "description": "The figures of this market alone. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "default": ""}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "tier", "method": "GET", "path": "/api/tiers/{kind}/{tier}", "url": "https://api.fractrade.xyz/tiers/{kind}/{tier}", "group": "positioning", "summary": "One tier: the markets it holds and its largest wallets.", "description": "One tier: the markets it holds and its largest wallets.\n\n``kind`` and ``tier`` as in ``GET /api/tiers``. ``markets``: per market the wallets\nand USD long and short, ``long_share`` and ``lean``, largest first. ``wallets``:\nthe ``limit`` (100) wallets of the tier that hold the most, each with its\n``account_value``, the ``value`` of its positions, ``leverage`` (value against\naccount value), ``net``, ``long_share``, what it made (``profit_30``,\n``profit_all``) and its tier of every kind.", "params": [{"name": "kind", "in": "path", "type": "string", "description": "What the tiers are by.", "required": true, "choices": ["size", "profit_30", "profit_all", "return_30", "return_all"]}, {"name": "tier", "in": "path", "type": "string", "description": "The tier's name, as GET /api/tiers gives it: whale, won_1m, up_50\u2026", "required": true}, {"name": "limit", "in": "query", "type": "integer", "description": "How many wallets at most.", "default": 100, "minimum": 1, "maximum": 500}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "tier_history", "method": "GET", "path": "/api/tiers/history", "url": "https://api.fractrade.xyz/tiers/history", "group": "positioning", "summary": "How the wallets that won and that lost in 30 days were placed on one market, day by day and now.", "description": "How the winning and the losing wallets were placed on a market, over time.\n\n``days``, oldest first: one per daily snapshot of all positions we hold (30 days),\nand a last one for now. Each has ``t`` (seconds since 1970, UTC), ``day`` (null for\nnow) and for ``winners`` and ``losers`` their ``long_share`` (of the value they\nhold on the market), ``usd`` and ``wallets``; null where nobody of them held it.\nWinners are the wallets that made 100,000 USD or more in the 30 days before that\nday, losers those that lost as much: the tiers as they stood on the day, not as\nthey stand now.", "params": [{"name": "inst", "in": "query", "type": "string", "description": "The market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC.", "required": true, "default": ""}], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "tracked_wallets", "method": "GET", "path": "/api/tracked/wallets", "url": "https://api.fractrade.xyz/tracked/wallets", "group": "tracked", "summary": "The wallets the account tracks, each with its filter, what it did in the last day and week, and its leaderboard figures.", "description": "The tracked wallets, each with why it is on the list, its filter and its last day.\n\nThe list is twenty wallets chosen by a rule once a week (``rule``; ``rotation_day``\nis the day the list in force is of), and whatever was put on it by hand. The rule:\na wallet that made money in each of the last four weeks, ``rule.min_made`` USD or\nmore over them, with no more than ``rule.max_closes`` closing orders last week (one a\nperson can read); the longest run of winning weeks first; a picked wallet stays\n``rule.stay_weeks`` at least and then for as long as it can still be picked. Per\nwallet: ``by_rule``, ``run_weeks`` (weeks in a row it made money), ``made_4w``,\n``picked_day``; ``label``; what it did in the last day and week from its fills\n(``fills_day``, ``value_day``, ``realised_day``, ``fills_week``, ``realised_week``,\n``t_last``; ``t_first``: how far back its fills reach); and the venue's figures.\n\nMeasured on six months of every wallet, 21 weeks: 58.9% of such picks made money in\nthe week after, against 52.4% of the twenty that had made the most USD and 37% of\nall wallets. The list says who has kept winning; it does not say they will, and it\nis no recommendation (``fracx2.follow.rotation`` has the test).", "params": [{"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "tracked", "method": "GET", "path": "/api/tracked", "url": "https://api.fractrade.xyz/tracked", "group": "tracked", "summary": "What the tracked wallets did, newest first: positions opened, added to, closed in part, closed and reversed, and TWAP orders as they start.", "description": "What the wallets on the account's list did, newest first.\n\nA row is a move (``fracx2.follow.model``): a position opened, closed or reversed, or\nadded to or reduced by a quarter of itself, with everything the wallet did on that\nmarket since its move before: ``before`` and ``after`` (the position), ``size`` and\n``value`` (the net change), ``fills``, ``traded`` (USD of all of them), ``closed_pnl``.\nFills that have not made a move yet are in no row; ``merge=0`` gives every half\nminute with fills instead, small or not. A TWAP order is two rows: one when it\nstarts (``twap`` is ``started``), with what is planned: ``size``, ``value`` and\n``after`` as they will be if it runs for its ``minutes``, no fills, and ``status``\nfor what became of it since (``activated`` while it runs); and one move when it has\nended, with all its slices (``twap`` is ``finished``, ``terminated`` or ``error``;\n``planned`` and ``executed`` are the order's own size and what it did of it, while\n``size`` is the net change of the position, with whatever else the wallet did on\nthat market meanwhile). Both carry the order's ``twap_id``. Each wallet's own filter\nis applied first\n(``filtered=0`` leaves it out), then what the request asks for: ``wallet``, ``action``\n(several with commas), ``market``, ``direction``, ``min_value``; within the last\n``hours``, at most ``limit``. ``found`` is how many there are before any filter,\n``matched`` how many pass, ``day`` the number of those in the last 24 hours by\naction. ``cut`` is true when the period holds more than are read at once: the oldest\nare then missing.", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 24, "minimum": 1, "maximum": 168}, {"name": "wallet", "in": "query", "type": "string", "description": "Only this wallet."}, {"name": "action", "in": "query", "type": "string", "description": "Only these kinds of move, with commas between them.", "default": "", "choices": ["OPEN", "ADD", "PARTIAL_CLOSE", "CLOSE", "REVERSE"]}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "direction", "in": "query", "type": "string", "description": "Only longs or only shorts.", "default": "", "choices": ["LONG", "SHORT"]}, {"name": "min_value", "in": "query", "type": "number", "description": "Only moves of this value, in USD.", "minimum": 0.0}, {"name": "merge", "in": "query", "type": "string", "description": "0: every half minute with fills, instead of one row a move.", "default": "1", "choices": ["0", "1"]}, {"name": "filtered", "in": "query", "type": "string", "description": "0: leave out each wallet's own filter.", "default": "1", "choices": ["0", "1"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many moves at most.", "default": 200, "minimum": 1, "maximum": 2000}, {"name": "account", "in": "query", "type": "string", "description": "The account asking. Decided by the key once keys exist; until then a name."}, {"name": "list", "in": "query", "type": "string", "description": "Which of the account's lists.", "default": "main"}], "open": false, "account": true, "writes": false, "stream": false, "asks_venue": false}, {"name": "watchlist", "method": "GET", "path": "/api/watchlist", "url": "https://api.fractrade.xyz/watchlist", "group": "watchlist", "summary": "The account's watchlist: the wallets it has marked for itself, each with its label, the venue's figures for it, its tier and what it holds now.", "description": "The account's watchlist: the wallets it has marked for itself.\n\nA bookmark and nothing more: a wallet on a watchlist is not fetched or analysed for\nthat reason (the tracked wallets are, ``GET /api/tracked``). ``wallets`` lists them,\nthe newest first, each with its ``label``, when it was put on (``since_ms``) and\nwhat the system knows of it without asking the venue: the venue's\n``display_name``, ``account_value``, ``pnl_month`` and ``roi_month`` (its own\nfigures of 30 days, as a fraction); ``profit_30`` with ``profit_30_tier`` and\n``size_tier`` (``GET /api/tiers``); and what it holds now, from the venue's daily\nsnapshot of all positions moved on by every fill since: ``positions``,\n``long_usd``, ``short_usd``, the largest (``largest_inst``, ``largest_usd``: negative\nis a short) and ``held_ms``, when that was worked out. None where the system does\nnot know the wallet. What a wallet holds this second is\n``GET /api/wallets/{id}/positions``. The list is the account's own: no other\naccount sees it (``fracx2.bookmarks``).", "params": [], "open": false, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "watch", "method": "PUT", "path": "/api/watchlist/{id}", "url": "https://api.fractrade.xyz/watchlist/{id}", "group": "watchlist", "summary": "Put a wallet on the account's watchlist, or change its label. A bookmark: nothing is fetched for it.", "description": "Put a wallet on the account's watchlist, or change its label. JSON with ``label``.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}, {"name": "label", "in": "body", "type": "string", "description": "A name of your own for the wallet."}], "open": false, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "unwatch", "method": "DELETE", "path": "/api/watchlist/{id}", "url": "https://api.fractrade.xyz/watchlist/{id}", "group": "watchlist", "summary": "Take a wallet off the account's watchlist.", "description": "Take a wallet off the account's watchlist.", "params": [{"name": "id", "in": "path", "type": "string", "description": "A wallet: its address (0x\u2026) or its id (hl:0x\u2026).", "required": true}], "open": false, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "news", "method": "GET", "path": "/api/news", "url": "https://api.fractrade.xyz/news", "group": "news", "summary": "Posts of the followed X accounts, newest first, each with what the model made of it: relevance, tradability, markets and direction, a one-line summary.", "description": "Posts of the followed X accounts, newest first, each with the model's verdict.\n\n``relevance``, ``tradability`` and ``urgency`` are 0 to 1, ``type`` is the kind of\nnews, ``markets`` the instruments it bears on with ``directions`` (up, down,\nunclear), ``summary`` one line (``fracx2.collectors.x.judge`` defines them). A post\nnot judged yet has nulls there. The filters: within the last ``hours`` (24),\n``min_relevance`` and ``min_tradability`` (0 to 1), ``type``, ``market``, ``handle``.\nOnly accounts that are read now are listed (``all=1``: every stored post). Posts\nthat tell the same story are one row, the newest, with ``posts`` (how many),\n``handles`` (who) and ``first_ms`` (when it was first told); ``stories=0`` lists\nevery post. ``about`` counts the period before the filters. ``post_id`` is a\nstring: it does not fit a JSON number.", "params": [{"name": "hours", "in": "query", "type": "integer", "description": "How many hours back from now.", "default": 24, "minimum": 1, "maximum": 336}, {"name": "min_relevance", "in": "query", "type": "number", "description": "Only posts at least this relevant, 0 to 1.", "default": 0.0, "minimum": 0.0}, {"name": "min_tradability", "in": "query", "type": "number", "description": "Only posts at least this tradable, 0 to 1.", "default": 0.0, "minimum": 0.0}, {"name": "type", "in": "query", "type": "string", "description": "Only news of this kind.", "choices": ["macro", "geopolitics", "policy", "regulation", "corporate", "listing", "security", "onchain", "commentary", "noise"]}, {"name": "market", "in": "query", "type": "string", "description": "Only this market. An instrument id: hl:perp:BTC, hl:perp:xyz:NVDA, hl:spot:PURR/USDC."}, {"name": "handle", "in": "query", "type": "string", "description": "Only this account's posts."}, {"name": "all", "in": "query", "type": "string", "description": "1: also posts of accounts that are no longer read.", "choices": ["0", "1"]}, {"name": "stories", "in": "query", "type": "string", "description": "0: every post, instead of one row a story.", "choices": ["0", "1"]}, {"name": "limit", "in": "query", "type": "integer", "description": "How many posts at most.", "default": 100, "minimum": 1, "maximum": 1000}], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "news_mentions", "method": "GET", "path": "/api/news/mentions", "url": "https://api.fractrade.xyz/news/mentions", "group": "news", "summary": "How often each counted market's ticker was posted on X: the last 24 hours against its usual day, its strongest hour, and 72 hourly counts.", "description": "How often each counted market's ticker was posted on X, from X's own counts.\n\nPer market: ``day`` (posts in the last 24 full hours we hold), ``usual_day`` (24\ntimes the median hour of the days before), ``times`` (one over the other),\n``peak`` and ``peak_ms`` (the strongest of those 24 hours) with ``peak_times`` its\nmultiple of the median hour, and ``hours``: the last 72 hourly counts, oldest first.\n``asked_ms`` is when X was last asked; the counts are a few hours old at most.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "news_accounts", "method": "GET", "path": "/api/news/accounts", "url": "https://api.fractrade.xyz/news/accounts", "group": "news", "summary": "The X accounts and which of them are read, each with its posts of the last day.", "description": "The X accounts, those that are read first, each with its posts of the last day.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "auth_challenge", "method": "POST", "path": "/api/auth/challenge", "url": "https://api.fractrade.xyz/auth/challenge", "group": "account", "summary": "The text a wallet signs to sign in.", "description": "The text a wallet signs to sign in. Send JSON with ``wallet`` (its address).\n\n``text`` is what to have the wallet sign, as it is, with ``personal_sign``: it names\nthe wallet, a number used once and the time. Signing is not a transaction and costs\nnothing. Send the signature to ``POST /api/auth/verify`` within ``expires_s``\nseconds. Asking again gives a new text and makes the old one worthless.", "params": [{"name": "wallet", "in": "body", "type": "string", "description": "The wallet's address.", "required": true}], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "auth_verify", "method": "POST", "path": "/api/auth/verify", "url": "https://api.fractrade.xyz/auth/verify", "group": "account", "summary": "Sign in with the wallet's signature of that text.", "description": "Sign in: send JSON with ``wallet`` and the ``signature`` of the text it was given.\n\nIf the signature is that wallet's, the wallet's FRAC is read from Hyperliquid and\nthe browser is signed in for 30 days by a cookie. The answer is the account, as\n``GET /api/auth/me`` gives it. A text can be used once.", "params": [{"name": "wallet", "in": "body", "type": "string", "description": "The wallet's address.", "required": true}, {"name": "signature", "in": "body", "type": "string", "description": "What the wallet returned for the text: 65 bytes in hex.", "required": true}], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": true}, {"name": "auth_me", "method": "GET", "path": "/api/auth/me", "url": "https://api.fractrade.xyz/auth/me", "group": "account", "summary": "Who is asking, how many FRAC the account holds, and what it may see.", "description": "Who is asking, and what that account may see.\n\n``signed_in``; for an account its ``wallet``, the ``frac`` it held when last read\n(``checked_ms``) and whether that ``passes`` the gate. ``gate`` says whether there\nis one (``enabled``), in which ``token`` and from how many (``min``). With the gate\noff everything is open to everyone and signing in changes nothing. ``read_only``\nsays that this API changes nothing about what the system follows, and ``internal``\nwhether the caller is on the machine itself and so sees the system's own pages too.\n``limits`` are\nthe requests allowed ``per_minute`` and ``per_day`` to a ``key``, a signed-in\nbrowser (``session``) and a caller without either (``anonymous``); a request that\nasks Hyperliquid when made counts ``venue_cost`` times (``fracx2.api.limits``).", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "auth_refresh", "method": "POST", "path": "/api/auth/refresh", "url": "https://api.fractrade.xyz/auth/refresh", "group": "account", "summary": "Read the account's FRAC balance again now.", "description": "Read the account's FRAC balance again now, for someone who has just bought.\n\nAt most once a minute for an account; in between the answer is what is known.", "params": [], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": true}, {"name": "auth_signout", "method": "POST", "path": "/api/auth/signout", "url": "https://api.fractrade.xyz/auth/signout", "group": "account", "summary": "Sign this browser out.", "description": "Sign this browser out. The account's keys stay in force.", "params": [], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "auth_keys", "method": "GET", "path": "/api/auth/keys", "url": "https://api.fractrade.xyz/auth/keys", "group": "account", "summary": "The account's API key, if it has one.", "description": "The account's API key, if it has one (``keys`` has one entry or none).\n\nWith its ``prefix`` (the first characters, to tell one from another), its\n``label`` and ``created_ms``. The keys themselves are shown once, when made, and are\nnot kept.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "auth_key_new", "method": "POST", "path": "/api/auth/keys", "url": "https://api.fractrade.xyz/auth/keys", "group": "account", "summary": "Make the account's API key (one at a time); it is shown this once.", "description": "Make the account's API key: send JSON with a ``label``.\n\nAn account has one key at a time: to have a new one, end the old one first\n(``DELETE /api/auth/keys/{prefix}``). With the gate on, the account must hold\nenough. ``key`` in the answer is the key, and this is the only time it is shown. A program\nsends it as the header ``Authorization: Bearer <key>``, to the API and to the MCP\nserver alike, and is then this account.", "params": [{"name": "label", "in": "body", "type": "string", "description": "A name for the key, to tell it from others."}], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "auth_key_end", "method": "DELETE", "path": "/api/auth/keys/{prefix}", "url": "https://api.fractrade.xyz/auth/keys/{prefix}", "group": "account", "summary": "End the account's key, so that a new one can be made.", "description": "End one of the account's keys, named by its ``prefix``. It stops working within\na minute.", "params": [{"name": "prefix", "in": "path", "type": "string", "description": "The key's first 12 characters, as the list gives them.", "required": true}], "open": true, "account": false, "writes": true, "stream": false, "asks_venue": false}, {"name": "recorded", "method": "GET", "path": "/api/recorded", "url": "https://api.fractrade.xyz/recorded", "group": "system", "summary": "How many minutes of the last 1, 7 and 30 days we recorded, and the last hour.", "description": "How many minutes of the last 1, 7 and 30 days we recorded, and the last hour.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "reference", "method": "GET", "path": "/api/reference", "url": "https://api.fractrade.xyz/reference", "group": "system", "summary": "This API described: every endpoint with its parameters and what it answers.", "description": "This API described: every endpoint with its parameters and what it answers.\n\n``api`` is the address programs use and ``app`` the one people open in a browser\n(empty where the system has no addresses of its own), ``mcp`` the MCP server's.\n``groups`` names the parts of the API. ``endpoints`` has one entry per endpoint:\n``name``, ``method``, ``url`` (where a program finds it), ``path`` (the same inside\nthe dashboard's own address), ``group``, ``summary`` (one line), ``description``\n(the full text: what every field of the answer means and where it comes from) and\n``params``, each with ``name``, ``in`` (path, query or body), ``type``,\n``description`` and, where they apply, ``required``, ``default``, ``minimum``,\n``maximum`` and ``choices``. ``writes`` is true for an endpoint that changes\nsomething, ``stream`` for one that answers with server-sent events, ``account`` for\none whose answer depends on who asks, ``asks_venue`` for one that asks Hyperliquid\nwhen called and is therefore slower. ``fracx2.api.reference`` holds all of it.\n\n``access`` says who gets what. With ``gate`` on, a program (this API under its own\naddress, and the MCP server) needs the key of an account that holds ``min`` of\n``token`` for everything but this description. A visitor of the app sees the\nendpoints marked ``open``, their answers up to ``delay_s`` seconds old; the others,\nand live answers, are for accounts that hold enough.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}, {"name": "openapi", "method": "GET", "path": "/api/openapi.json", "url": "https://api.fractrade.xyz/openapi.json", "group": "system", "summary": "The same description as an OpenAPI 3.1 document.", "description": "The same description as an OpenAPI 3.1 document, for tools that read one.", "params": [], "open": true, "account": false, "writes": false, "stream": false, "asks_venue": false}], "access": {"gate": true, "token": "FRAC", "min": 10000.0, "delay_s": 900.0}}