ai_chat | Ask Femtos AI a question about Hyperliquid (HyperCore, HyperEVM, Elysium): it reads Femtos data with its tools and answers with its sources. Pick a model of ai_models. It spends money: billed in USD from the account's prepaid balance: OpenRouter's exact cost of each model call x 1.25, held before the call (an upper bound) and charged once it answers; the Femtos tools it runs count in credits as usual. Pass the conversation as messages [{role: user | assistant, content}]. |
ai_jobread-only | A Femtos AI job of your account (a token_forensics run): its status, the text so far and, once done, the answer with its findings. Pass wait (up to 60 s) and call again until status is done or failed. Free. |
ai_modelsread-only | The models Femtos AI (ai_chat) runs on, with the USD price per million prompt and completion tokens (OpenRouter's price x 1.25). Free. |
cancel_plan | Stop your plan from renewing: it runs to its period end (no refund), then the key is back on pay as you go. subscribe_plan before then resumes it. Free. |
create_webhook | Create an outgoing webhook: we POST the events of its subscriptions to your HTTPS URL (port 443 or 8443, public address), signed (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature = v1,<base64 HMAC-SHA256 of "id.timestamp.body" with the secret>). Channels (WebSocket vocabulary): bridge.transfers and elysium.bridge (matched bridge legs), wallet (filter.address: up to 100 addresses, filter.channel: event kinds), hc.liquidations and hc.positions (filter.min_notional; positions >= 10000), elysium.launches, hyperevm.launches. Your URL first gets a webhook.verification POST: answer {"challenge": "<data.challenge>"} within 10 s, nothing else is sent before. The answer carries the secret once. Free tier: 2 webhooks, 5 subscriptions, 10k deliveries a day. |
delete_accountdestructive | Delete your account: the key stops working for good. Refused while a plan runs or overage is due; a positive balance is lost only with forfeit_balance=true. Needs management_secret (agents); an account with an email gets a confirmation link. Cannot be undone. |
delete_webhookdestructive | Delete one of your webhooks and its pending deliveries. Cannot be undone. |
elysium_rpcread-only | One JSON-RPC call on our Elysium mainnet (chain 99901) node, free: eth_chainId, eth_blockNumber, net_version, net_listening, web3_clientVersion, eth_syncing, eth_getBlockByNumber, eth_getBlockByHash, eth_getBlockTransactionCountByNumber, eth_getBlockTransactionCountByHash, eth_getTransactionByHash, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByBlockHashAndIndex, eth_getTransactionReceipt, eth_getBlockReceipts, eth_getBalance, eth_getCode, eth_getStorageAt, eth_getTransactionCount, eth_call, eth_estimateGas, eth_gasPrice, eth_maxPriorityFeePerGas, eth_feeHistory, eth_getLogs, eth_getProof; eth_sendRawTransaction from 2026-12-24 (until then, send on POST https://api.femtos.xyz/v1/elysium/rpc). The answer is the node's {jsonrpc, id, result} or {error}. eth_getLogs over at most 1000 blocks; state (eth_call, eth_getBalance…) of the last 128 blocks only. Limits of your key's plan (no key: 5/s per IP): use the indexed tools for history. |
enable_webhook | Turn a disabled webhook (410 Gone, or failing for 24 h) on again: your URL gets a new webhook.verification challenge, deliveries resume once it is answered; pending ones are kept 7 days. |
freeze_keydestructive | Emergency stop for a leaked key: it is refused everywhere at once, this MCP connection included. Unfreeze or rotate it after with your management secret (POST /v1/account/unfreeze, /v1/account/rotate). Free. |
get_accountread-only | Your Femtos account: name, tier and limits in force, balance and debt (USD), credits used this month and free credits left, monthly cap, plan and renewal, how to pay (USDC deposit address, card, x402), how rotate/delete are confirmed (manageWith). Start here to manage the account. Free. |
get_balancesread-only | What an address holds, one flat list: HyperCore spot tokens (live), HyperEVM and Elysium ERC-20s and native HYPE (indexed head), each with raw units, amount, USD price and value, largest first; spam tokens left out; HyperCore perp accounts (account value, withdrawable) apart in `perp`; totals per layer and overall, each layer with its source, height and asOf. Past balances: block or at (Unix ms) on one layer (EVM: needs tokens, read on our archive node; HyperCore: the holder snapshot at or before it, 7 days kept). verify: EVM rows read again on the node at the same block (indexer drift shows as onchain.match false). |
get_blockread-only | One HyperEVM or Elysium block (a number, or latest): hash, time, small or big block (HyperEVM), gas, base fee, tips, HYPE burnt and fees, and every transaction in order with sender, recipient (named wallets tagged), HYPE sent, function called, status, gas, tip, fee and its decoded swaps, transfers and liquidity changes. |
get_bookread-only | Live L2 order book of one HyperCore market from our own node: bids and asks best first as [px, sz, n] (price, size, order count), and the block it was read at. coin: perp name (BTC), spot @index (@107) or HIP-3 dex:COIN. depth 1: the best bid and offer (BBO) only. |
get_bridgesread-only | Bridge movements, newest first, with 24 h stats. route core_evm: HyperCore <> HyperEVM transfers, both legs matched (status, latency, how they were paired); route evm_elysium: HyperEVM <> Elysium (Orbit) deposits and withdrawals; route arb_core: deposits and withdrawals of the native Hyperliquid USDC bridge on Arbitrum One, with their Arbitrum transactions (a withdrawal from its request, before the HyperCore ledger shows it). Filter by account to follow one wallet across layers. Medium call. |
get_builderread-only | One HyperCore builder code over a window (24h to all since 2025-07-19): fees (USD stablecoins at par, exact per token), volume, fills, users, rank; one row per day; its markets; its orders from 2026-10-13 15:50 UTC by status (fills, cancels, each rejection reason) and the fee rates they charged. |
get_builder_fillsread-only | Fills of one HyperCore builder code, newest first, with the builder fee of each, account, market, price, size, direction, PnL, oid, tid and hash. From 2025-07-19; window from / to, default the last 24 h, at most 24 h per call. Next page: pass `next_cursor` as cursor. |
get_builder_ordersread-only | Order statuses of one HyperCore builder code, newest first: open, filled, canceled, triggered and every rejection reason, with market, side, type, prices, sizes, account and the fee rate charged. From 2026-10-13 15:50 UTC; window from / to, default 24 h, at most 7 days per call. Next page: pass `next_cursor` as cursor. |
get_buildersread-only | HyperCore builder codes ranked over a window (24h, 7d, 30d, 90d, all since 2025-07-19): builder fees earned (USD stablecoins at par, exact per token), volume, fills, distinct users, share of all builder fees, and order outcomes (distinct orders, filled, canceled, rejected; from 2026-10-13 15:50 UTC), and the app behind each code (Phantom, MetaMask…) when known. Sort by fees, volume, fills, users or orders. |
get_candlesread-only | OHLCV candles of one market, ascending, UTC-aligned. hypercore: market = coin (BTC, HYPE, @107 spot, xyz:TSLA), down to 1 s. hyperevm / elysium: market = pool key from list_markets; prices in quote plus `usd` and `mcap` OHLC (USD price and market cap). hypercore with includeUsd: the same `usd` and, on a spot market, `mcap`, each candle converted with the quote token's USD price then (a USDH, USDT0 or USDE market; a USDC market's usd equals the candle) and the supply named in `supply`. Or token instead of market: a token's candles in USD through its reference pool (most liquid; the answer names it), HyperCore: its USDC market. Without from: the `limit` candles ending now. Windows over 30 days are billed as heavy calls. |
get_chain_activityread-only | HyperEVM or Elysium activity per bucket (1m, 15m, 1h or 1d), oldest first: user transactions, distinct wallets and new wallets, contracts created, fees in HYPE, swaps, traders, volume in USD, launches, ERC-20s created, and deposits bridged in from the parent chain (count, depositors, USD). The last bucket is the open one (`partial`). Ask 1d for a trend over weeks, 1h for days, 15m or 1m for the last hours. |
get_coinread-only | One token: its links across layers, the markets it trades on (most traded first) and its 5 largest holders. hypercore: id = token name (HYPE), index or token id; hyperevm / elysium: id = 0x address. Price, FDV, liquidity and 5m–24h windows over all its pools: get_token_overview. |
get_deploysread-only | HyperCore deploy actions, newest first: `perpDeploy` (HIP-3 perp dexs: market registrations, halts, funding rates, open interest caps, margin tables, sub-deployers…), `spotDeploy` (HIP-1 tokens and spot pairs), `outcomeDeploy` and `activateOutcomeDeployer` (HIP-4 outcomes), `VoteGlobalAction` (validator votes: `J` lists a main-dex perp), with account, signers, status and the exchange's answer; the action as the node wrote it, every digit (a named wallet's address: its handle). Filters: kind, variant, dex, coin, user, status; notable: true leaves out the routine actions (funding interest rates, outcomes registered from a template, every outcome settlement, the validators' votes registering and settling outcomes and questions). Window from / to, default the last 24 h, at most 31 days per call, since 2026-11-01. head: the newest block the history has read; pending: blocks of the window it does not hold yet. Named wallets carry `entity`. Next page: pass `next_cursor` as cursor (same window). |
get_deposit_address | Your USDC deposit address (created on the first call, then the same): send USDC on HyperCore (usdSend), HyperEVM, Base or Arbitrum One (ERC-20 transfer) and it is credited 1:1 to your balance. Answers how to pay on each chain. Free. |
get_depositsread-only | Your USDC deposit address on each chain (HyperCore, HyperEVM, Base, Arbitrum One), amounts waiting to reach the minimum, and its latest deposits: amount, tx, pending / credited / ignored with the reason. Free. |
get_entityread-only | One named entity by id (from search_entities, get_identity or an `entity` field): its addresses with each one's role and evidence, their HyperCore account value, positions and spot, HyperEVM and Elysium holdings, latest moves, the totals, and 30 days of HyperCore trading. A person's addresses are given as handles <entityId>.<hex>, usable as addresses in every tool. |
get_entity_graphread-only | How each wallet of a named entity was attributed: the links (bridges, HyperCore sub-accounts, sends both ways, Farcaster self-declarations) back to the public source, with their proofs (source, time, USD value, chains), and the HyperCore metrics of smart-money wallets. Use it to judge an attribution before relying on it. |
get_entity_pnlread-only | The HyperCore PnL curve of a named entity (id from search_entities): per hour or day, realized PnL, fees, funding, net and cumulative net, over 7d, 30d, 90d or all history. Realized only: open positions' unrealized PnL is in get_entity's answer. |
get_erc20_transfersread-only | ERC-20 Transfer events, newest first (from, to, amount, block, tx). address: the transfers sent / received by a wallet (direction in, out or any), optionally of one token, in a window (from / to, Unix ms) or above minUsd (amount × current token price); each row with token, symbol, direction and USD value. Without address: the transfers of one token. Filtered pages may hold fewer rows than limit: keep paging with `next_cursor` (null = no more). |
get_forced_flowread-only | Open stop-loss / take-profit orders and the liquidation prices of open positions of one HyperCore market on the same price buckets: per bucket the stops by kind and side (each at what it would execute: a reduce-only order at most what is left of its wallet's position, the rest under stops.unbacked), the liquidations by side, the cascade (what fires with the move: sell = sell stop-losses + long liquidations, buy = buy stop-losses + short liquidations) and forced = cascade + take-profits (which fire against the move: sell ones above the mark, buy ones below), each with its running total from the mark outward (cumCascadeSell / cumSell downward, cumCascadeBuy / cumBuy upward); summary = cascade selling under the mark and buying over it, take-profits on the far side, and the forced totals, inside the grid. Same grid parameters as get_stop_map. |
get_forensics_reportread-only | The newest token forensics report of an Elysium token, in full (report text, findings: verdict, proofs, groups, links, operator), with its older verdicts; report null when none was run (token_forensics runs one, paid). Free, no key. |
get_gasread-only | HyperEVM or Elysium gas over 1h, 6h, 24h or 7d: each block's base fee, gas used and limit, transactions and priority fees (p50 / p90 tips), HyperEVM small and big blocks as two series (each has its own base fee). Stats per series (base fee min / median / p90 / p99 / max / mean, typical tips, utilization) and the latest block. Points are every block up to 25000 per series, else buckets with min / mean / max base fee; ask a coarse resolution (5m, 15m, 1h) for a short answer. Values in wei. |
get_holdersread-only | Largest holders of a token and its concentration (top-10 share…); system addresses (pools, bridges, launchpad, zero/dead) counted apart. hypercore: token = name (HYPE), kind = balances (spot) or positions (perp open interest of a coin); hyperevm / elysium: token = 0x address. Named wallets carry `entity`; EVM rows say what each address is (label, labelKind: pool, bridge, protocol, token, creator, multisig, contract, wallet; contract: has code) and what each holder did with the token: pnl (buys / sells since its first swap, average entry price and market cap, realized / unrealized PnL) and tags (dev, sniper, bundler, insider, pro); tagShares = supply held by snipers, bundlers, insiders, pro traders, the creator among the 100 largest (proHolders: how many pro traders). |
get_holders_historyread-only | How the number of holders of a HyperEVM or Elysium ERC-20 evolved: one point a UTC day (holders at the indexed head just after 00:00 UTC, system addresses such as pools, bridges and zero / dead left out, as get_holders totalHolders) and the count now. History from the layer's first snapshot (`since`) on, up to 365 days. interval=1h: one point an hour over the last hours (up to 720), the count at each hour's start. `sinceLaunch` true: the series covers the token from its first transfer (stored hourly counts, or a replay of its transfers for a token of up to 20,000); false: an older or larger token, from the layer's first hourly snapshot on. A missing hour was not counted: never read a gap as a flat line. |
get_hypercore_accountread-only | The HyperCore account of an address (or a named wallet's handle), read from our node at most 2 s ago: perp account value, margin used and withdrawable, each position (size, entry and liquidation price, leverage, unrealized PnL, cumulative funding with Hyperliquid's sign: positive = paid), the HIP-3 dex accounts, the spot balances with USD values, and whether the perp collateral is held in spot (`perp.inSpot`). The other layers of the address: get_wallet. |
get_hypercore_wallet_pnlread-only | The HyperCore PnL curve of any address (or a named wallet's handle): per hour or day, realized PnL, fees, funding, net and cumulative net, plus the perp account value at each bucket's end and the net transfers in it, over 7d, 30d, 90d or all history. Account values are walked back from our node's state now (standard accounts; unified and portfolio-margin ones get none, accountValue.status says why). Open positions now: get_hypercore_account. |
get_identitiesread-only | get_identity for up to 1000 addresses at once (holders, traders, counterparties of a token or a wallet): entity, role, confidence, basis, evidence, other addresses, labels and traits of each. One REST call per 25 addresses. |
get_identityread-only | Who an address belongs to (exchange, protocol, launchpad, builder, HyperCore vault, bridge, the chain itself, fund, market maker, KOL, trader), the address's role, the confidence, the basis and evidence with where to check each, the entity's other addresses, what the address is on HyperEVM / Elysium (pool, token, Safe, contract) and what it did (sandwich bot, token creator, honeypot operator, HyperCore vault leader, HIP-1 or HIP-3 deployer, builder code). Use it before calling an address by a name. Many addresses at once: get_identities. Search by name: search_entities. |
get_launchread-only | The story of one launched token: launch event, market cap, volume, holders, dev wallet and its funding, early buyers with flags, coordination signals, fees (exact from the launchpad ledger when indexed), lifecycle stage across layers and, for Ascend, progress toward the "Ascended" criteria. Elysium first, then HyperEVM LiquidLaunch. |
get_launchpadread-only | One launchpad of Elysium (default) or HyperEVM by name (ascend, obol, liquidlaunch… as list_launchpads names them) or contract: launches 24h / 7d / all time, on curve, graduated and the rate, 24 h volume, top token, and its launches and graduations per day over 30 days. |
get_launch_timelineread-only | Replayable life of a launch, oldest first: launch, swaps and transfers with the running holder count and market cap, graduation links (bridge to HyperEVM, HyperCore listing). Long histories are cut to fit (see `truncated`). |
get_ledgerread-only | Your money movements, newest first: USDC deposits and x402 packs (with tx), card payments, credits by Femtos, plans paid from the balance, refunds; usage debits with usage=true. With the balance now. Next page: pass `next_cursor` as cursor. Free. |
get_liquidation_mapread-only | Liquidation prices of the open perp positions of one HyperCore market, bucketed by price around the mark: per bucket the longs (liquidated by a forced sell as price falls to them) and the shorts (forced buy), count, |size| and |size| × liquidation price. Real per-position prices: every account's positions a few seconds old (the node state rolled forward with every fill, funding payment, ledger update and accepted account action), each liquidation price from Hyperliquid's formula on the account state, not a leverage model; `coverage` gives the share of open interest that has one (portfolio-margin cross accounts have none). Same grid parameters as get_stop_map: the buckets line up. |
get_liquidationsread-only | HyperCore perp liquidations, newest first: one row per account, coin and block (side of the liquidated position, market or backstop, size, notional, average and mark price). Default window: the last 24 h; `from` older than 7 days (30 with a coin) is clamped, the answer's `from` says where it starts. Named wallets carry `entity`. |
get_liquidation_statsread-only | HyperCore liquidations over a window (1h, 24h, 7d, 30d), every perp or one coin: totals (notional, count, accounts, long / short, market / backstop), per coin, per time bucket, the most liquidated accounts and the largest events. |
get_mev_botread-only | One Elysium sandwich bot over all its sandwiches: its contracts, first / last seen, sandwiches, USD taken, distinct victims and pools, median tip (wei). Its sandwiches: list_sandwiches with bot. |
get_mev_statsread-only | MEV on Elysium over 24h, 7d, 30d or all: sandwiches (count, USD taken, victims, bots, USD of the swaps hit), cyclic arbitrage (txs, profit USD), an hourly or daily series, and the top bots, pools and routers hit. |
get_nft_collectionread-only | One NFT collection of an EVM layer: metadata, standards, token ids seen (counted up to 1,000), transfers / mints / burns over the 24 h before the indexed head. |
get_nfts_ownedread-only | NFTs an address holds on an EVM layer at the indexed head: ERC-721 tokens and ERC-1155 balances, counted per collection, the tokens listed up to limit. |
get_nft_tokensread-only | Tokens of one collection by token id, ascending: current ERC-721 owner (null for ERC-1155), metadata URI, image URL. Next page: pass `next_cursor` as cursor. |
get_nft_transfersread-only | Transfers (mints and burns included) of one collection or one of its tokens, newest first: from, to, token id, amount, block, tx. Next page: pass `next_cursor` as cursor. |
get_open_interestread-only | Open interest of a HyperCore perp over time (bars of 1s to 1M since 2023-05-20, 1s and 15s since 2025-09-28): open / high / low / close of the open interest (size, Σ |position| of longs and shorts), its value at the last price, longs and shorts opened and closed in each bar, the part opened by aggressors, the size liquidated, accounts long and short, the hourly funding rate settled. Exact after every block since 2025-03-22 10:49 UTC, from every trade and Hyperliquid's own per-minute values (anchored on every hourly funding since 2025-09-28, where accounts start); before, Hyperliquid's per-minute values alone, moves and trades null. Hyperliquid's API serves only the current open interest. |
get_open_interest_cohortsread-only | Who holds a HyperCore perp's open interest, every hour since 2025-09-28: long and short size and accounts by position size tier (0 = no trade price known, 1 = under $10k, 2 = $10k–100k, 3 = $100k–1M, 4 = $1M–10M, 5 = $10M and more), and the share of the 10 largest longs and shorts. Read whale vs retail positioning over time. |
get_open_interest_opensread-only | Who opened positions on a HyperCore perp in a window of up to a day (since 2025-03-22 10:49 UTC): the orders that opened longs or shorts, largest value first, with the account and its named wallet, size and value opened, average price, taker or resting, position before and after; plus the window's longs / shorts opened in total and by aggressors. Use it to explain an open interest jump. |
get_payment_options | How to pay your account now: your USDC deposit address on each chain with exact instructions, x402 credit packs, a card checkout URL when cards are offered (give usd), and the credits an amount buys. Free. |
get_plansread-only | The price list: credits per call class (and which calls are medium / heavy), pay-as-you-go bands, plans with their monthly and annual price and included credits, payment methods. Use it before subscribe_plan. Free. |
get_poolread-only | One DEX pool of HyperEVM or Elysium: dex, factory, fee tier, hooks, tokens with USD prices, creation block / tx, price, liquidity with its USD value and how it is measured (pool balances for V2 / V3; for V4 / Infinity pools what their positions hold at the current price), depth to ±2 %, trades / buys / sells / USD volume / price change over 5m, 1h, 6h, 24h, for V2-style pools the largest LP holders, and how much of its liquidity is burned, locked (until when), free or in contracts. |
get_pool_metrics_historyread-only | One pool's metrics over time (HyperSwap V3 and V2 on HyperEVM): per hour or per UTC day its swaps, volume, fees paid, the liquidity providers' and the protocol's parts (USD at each swap's own price), the tokens it held at the end of the unit (raw units: divide by 10^decimals) with their USD value then (tvlUsd; null with tvlReason for a unit not recorded) and its fee APR (LP fees of the unit over the tokens held through it, at today's values, simple, % per year). Oldest first, the unit in progress last (complete: false). The metrics count from `since`: no point before it. interval: 1h (limit up to 720) or 1d (up to 365). |
get_position_changesread-only | Past HyperCore perp position changes of one coin over a notional (at least 10000), one row per account and block (opens, closes, increases, reductions, flips, with size, average price and whether a liquidation moved it): the history of the WS hc.positions channel, the rows behind get_position_flow's bars. Window: the last 24 h by default, at most 30 days, anywhere since 2025-05-25. sort=notional for the largest of the window. Named wallets carry `entity`. |
get_position_flowread-only | Large HyperCore perp position moves and liquidations of one coin summed per bar of a unit (1m to 1d, 1w, 1M): buys, sells, longs liquidated, shorts liquidated, each with notional, count, volume-weighted price and the largest move (named wallet when known). The figures add up across units. Floors: minNotional for buys and sells, liqMinNotional for liquidations (at least 10000). History from 2025-05-25. |
get_positionsread-only | Open positions of one HyperCore perp, current to a few seconds (the node state rolled forward with every fill, funding payment, ledger update and accepted account action): account, size, side, entry price, notional, unrealized PnL at the mark, leverage, margin mode and liquidation price when known. Sort by notional (default), upnl or liqDistance (closest to liquidation first). Named wallets carry `entity`. |
get_predicted_fundingread-only | Predicted hourly funding rate of the running hour for HyperCore perps, main dex and HIP-3 dexes (coin: one perp, dex: one dex, neither: every perp): the rate that will be paid at nextFundingTime if the hour ended now (Hyperliquid's own), the average premium it stands for (null while it sits within clamp of the interest rate), the latest premium, and the terms of the formula (interestRate and clamp per 8 h, multiplier). |
get_price_historyread-only | USD prices in the past. With at (Unix ms): the price of up to 100 tokens at that time (last observation at or before it). With from / to / interval: USD closes per unit (1m 5m 15m 1h 4h 1d) of up to 25 tokens, gap-filled. Same sources as get_prices. Windows over 30 days are billed as heavy calls. |
get_price_levelread-only | The wallets behind one price band of a HyperCore market (a bucket of get_forced_flow / get_stop_map / get_liquidation_map: px_lo = its pxLo, px_hi = its pxHi): the open stop-loss / take-profit orders triggering in it, each with what it would execute (a reduce-only order at most what is left of its wallet's position; the rest as unbackedSz) and the wallet's position, and the open positions liquidated in it (size, entry, leverage, liquidation price). Largest first. Named wallets carry `entity`. |
get_pricesread-only | Current USD price of up to 100 tokens in one call, each with its source and provenance: hl_mid (HYPE / WHYPE: HyperCore spot mid; hl_oracle when no mid is recorded), hl_spot (HyperCore tokens and HyperEVM tokens linked to one: last trade of its USDC market), hl_perp, unit (USDC), pool (HyperEVM / Elysium: last swap of the token's reference pool, the most liquid one, with block / tx / logIndex). hypercore: tokens = names (HYPE, PURR) or perp coins (BTC). |
get_recovery_challengeread-only | No key needed. Lost the key of an account created by an x402 payment? Get the message its paying wallet must sign (personal_sign), then call recover_account. EOA wallets only. |
get_signup_challengeread-only | No key needed. Step 1 of a free API key for an agent: a proof-of-work challenge. Find a nonce of 1-32 characters [0-9a-zA-Z] such that SHA-256 of "<salt>:<nonce>" starts with `difficulty` zero bits (run code: about 0.5 M hashes), then call signup. |
get_statusread-only | State of each layer (HyperCore, HyperEVM, Elysium): indexed head block and time, lag behind the chain, live or syncing, Elysium network (mainnet), HyperCore <> HyperEVM bridge matching coverage. Check it when an answer looks stale. Free. |
get_stop_mapread-only | Open trigger orders (stop-loss and take-profit) of one HyperCore market bucketed by trigger price around the mark (default ±10 %, 20 round-width buckets): per bucket the count, size and notional (size × trigger price) of stops and take-profits, sell (closes longs) and buy (closes shorts), market and limit. Each order counts at what it would execute: a reduce-only order closes at most what is left of its wallet's position when it fires (positions a few seconds old); the size past it (wallets with no position, oversized or duplicate stops) is apart under `unbacked`. Position TP/SL that close the whole position (size 0) are counted apart under `whole`, sized the same way. `totals` cover every open trigger order of the coin, `below` / `above` those outside the grid. Cut at `height` (block) / `asOf`. |
get_token_balanceread-only | The balance of one token for one address: HyperCore coin name (USDC, HYPE…), or a HyperEVM / Elysium token address (`native` = HYPE; layer hyperevm unless elysium is given). 0 when not held. block / at for a past balance, verify to compare with the node. |
get_token_lifecycleread-only | One token from launch to perp across Elysium, HyperEVM and HyperCore: its address on each layer, the stages reached (Elysium launch, listing desk, HyperEVM mirror, HyperCore spot, perps) with chain evidence, and the links between them, each exact or inferred. address: an Elysium / HyperEVM address, core:<index>, a HyperCore token id or name, or a perp coin (dex:COIN). |
get_token_overviewread-only | One token across all its pools on HyperEVM or Elysium (DexScreener style): USD price and source, FDV, market cap, liquidity, volume / trades / buys / sells / unique buyers, sellers and traders / price change over 5m, 1h, 6h, 24h, holders and top-10 share, pool count, the 5 best pools and the reference one, creator and creation time. |
get_tokensread-only | Metadata of up to 100 tokens: symbol, name, decimals, total supply, creator and creation time, logo, description and socials (website, X, Telegram, Discord, docs) with the source of each field and the X / Telegram handles in `profile` (issuer-provided, unverified text), token family, cross-layer links, spam flag. Unknown addresses come back in `missing`. |
get_token_securityread-only | Is this HyperEVM or Elysium ERC-20 safe to trade: a buy, a transfer and a sell simulated on our node through its most liquid pool (state overrides, nothing sent): canBuy, canSell, buy / sell / transfer tax, gas, revert reason; static checks of its code (owner and renounced, mintable, pausable, blacklist, max tx / wallet, cooldown, tax setters, upgradeable proxy, selfdestruct, ownership reclaim, verified source on Sourcify or the Blockscout bytecode database, of the implementation behind a proxy); holders (top 10 share and its part in EOAs, creator / owner share), liquidity and who holds it (LP burned / locked with the unlock time / free / in contracts, V2 LP tokens and V3 / V4 positions). Verdict ok / caution / danger / honeypot with reasons; each check has a severity (info, warn, danger). Cached 60 s per token. Medium call. |
get_token_tradersread-only | Who traded a HyperEVM or Elysium token over 1h, 6h, 24h or since launch (window=all), over all its pools or one (pool), and how they did, or one wallet's line (trader): per wallet buys / sells, amounts and USD bought / sold, average buy and sell price, current balance and supply share, realized, unrealized and total PnL (average cost over the window: realized = min(bought, sold) × (avg sell − avg buy); unrealized = what it still holds of its net buy × (current price − avg buy)), first / last swap, named wallets with entity. sort = pnl, realized or volume; totals of the window (traders, buyers, sellers, swaps, volume). Priced swaps only, the token on either side of any pool; trader = the wallet that received or gave the tokens (tx.from when no other). Medium call. |
get_token_volumeread-only | Daily USD swap volume of an EVM token (both sides of every priced swap), oldest first, up to the indexed head (the last day is partial). |
get_tradesread-only | Latest trades of a market, newest first. hypercore: fills of a coin (px, sz, side B = buyer aggressor / A, block time). hyperevm / elysium: DEX swaps of a pool (sender, amounts, px = pool price after the swap, USD value). Answer: an array of trades with only market / limit; one object {rows, next_cursor, coverage…} as soon as a history filter is given. History (hyperevm / elysium): pass trader (a wallet: every swap it sent), beneficiary (a wallet: every swap that paid it or took its tokens, smart-account swaps sent by a bundler included), pool or token (more than 20 pools: its priced swaps only, `coverage: priced`), optionally side, minUsd (USD at the swap), from / to (Unix ms): newest first, each row with its pool and symbols; filtered pages may hold fewer rows than limit, keep paging with `next_cursor` (null = no more). |
get_transactionread-only | One transaction by hash, HyperEVM then Elysium (or layer): status, block, from / to, value, gas and fee (HYPE and USD), decoded ERC-20 transfers, swaps, liquidity events, pools created and NFT transfers, the raw logs we do not decode (from our node), and when it is a bridge leg its legs, matched bridge rows and the cross-layer journey it belongs to. A transaction not indexed yet comes from the node (source: rpc, nothing decoded). |
get_transaction_statusread-only | Where one transaction is on HyperEVM or Elysium (layer): pending with the upstreams that accepted it, included (block, index, success or reverted), replaced (the hash that took its nonce) or dropped, for a transaction sent through hyperevm_rpc / elysium_rpc or POST /v1/<layer>/rpc; any other hash: included or unknown, from the chain. The same signed transaction sent again within 60 s is not sent twice. |
get_triggered_stopsread-only | Stop-loss and take-profit orders of one HyperCore market that fired, newest first: wallet, side, trigger and limit price, size (0 = whole position), the order the trigger placed (its status in the trigger block) and its fills there (size, average price, notional). Window: since / until, default the last hour, at most 24 h per call and 7 days back. Named wallets carry `entity`. Next page: pass `next_cursor` as cursor. |
get_twap_historyread-only | HyperCore TWAP orders that ended (finished, terminated, or error with its reason) in a window, newest first, by market (coin) and / or account (user): size, executed size and notional, average price, what was left undone, start, scheduled end, when and how it ended. Window from / to, default the last 24 h, at most 7 days per call, since 2026-10-13. Named wallets carry `entity`. Next page: pass `next_cursor` as cursor. |
get_twapsread-only | Running HyperCore TWAP orders of a market (coin) and / or an account (user), every market when neither is given: side, size, executed size and notional, average price, remaining size and notional at the last trade, progress, start and scheduled end, trigger, status; and per market the net TWAP pressure (remaining buys minus remaining sells, in quote units). sort=remaining (default), newest or ending. Named wallets carry `entity`. Ended TWAPs: get_twap_history. |
get_usageread-only | Your usage per UTC day and call class (rest, medium, heavy, hl, ws_bytes, webhook, ai_usd for Femtos AI): calls or bytes, credits, USD charged. Free. |
get_walletread-only | One address on HyperCore, HyperEVM and Elysium at once: HyperCore perp account (value, positions with liquidation price) and spot balances, HyperEVM and Elysium token balances and NFTs with USD values, bridge legs in flight and journeys across the layers, latest events (fills, ledger, swaps, transfers, bridges), each section with its freshness. Medium call; balances alone: get_balances (a REST call). |
get_wallet_fill_barsread-only | A wallet's fills on one HyperCore market summed per bar of a unit (1m to 1d, 1w, 1M): per bar its buys and sells (count, size, notional, average price, closed PnL, fees), its position on the coin after the bar and whether it was liquidated in it. Only the bars with a fill. Window from / to in Unix ms, or the last `limit` bars. History from 2025-05-25. |
get_wallet_fillsread-only | A wallet's HyperCore fills, newest first: market, side, price, size, notional, direction (Open Long, Close Short…), closed PnL, fee, builder fee, oid, tid, hash, the position before the fill, and whether it is a liquidation of the wallet. coin: one market; from / to: a window in Unix ms (default everything up to now). History from 2025-05-25. Next page: pass `next_cursor` as cursor. |
get_wallet_fundingread-only | A wallet's HyperCore funding payments, newest first: per perp and hour the amount in USDC (negative = paid by the wallet, positive = received), its position and the funding rate. coin: one perp; from / to: a window in Unix ms (default everything up to now). History from 2025-09-27. Next page: pass `next_cursor` as cursor. |
get_wallet_lp_positionsread-only | One wallet's liquidity positions on the DEXs followed position by position (HyperSwap V3 and V2 on HyperEVM): position NFTs, positions opened on a pool directly, LP tokens, and positions a vault holds for it (custody: delegated). Per position: pool, tokens, range (ticks), liquidity, whether it is in range, the token amounts it holds and their USD value, what it can collect now (uncollected fees, exact: the contract's maths read on our node at one block), what went in and out since it is followed (flows), and its performance since then (fees earned, value of holding instead, impermanent loss, position vs holding, realized fee APR; USD at current values; and pnlUsd, the profit or loss in USD with deposits and collects at the prices of their own block). totals: open positions, in range, USD value, uncollected USD. Amounts are raw token units (divide by 10^decimals). status=all adds the closed positions. Filters: protocol, pool. |
get_wallet_mevread-only | Every sandwich (MEV) of a wallet's Elysium swaps, newest first: the bot, its front-run and back-run transactions, the pool and tokens, what the victim paid and got, its loss in USD; with the totals (sandwiches, USD lost, USD of the swaps hit). strict = front-run in the victim's block, back-run in the next; probable = another spacing, up to 120 blocks; sure = strict or by a known sandwich bot. Free, no key. |
get_wallet_open_ordersread-only | A wallet's open HyperCore orders now (our node, at most 1 s old): resting limit orders and trigger orders (stop-loss / take-profit) on the main dex and every HIP-3 dex, each with coin, side, kind, limit and trigger price, size left and placed (0 = whole position), reduce-only, time in force, placed at. coin: one market. The status history of its trigger orders: get_wallet_stops. |
get_wallet_order_historyread-only | A wallet's HyperCore orders that left the book (filled, canceled, rejected), newest first: market, side, kind, limit and trigger price, size placed, filled and left, average fill price, the last status with Hyperliquid's reason (marginCanceled, reduceOnlyRejected…) and its time. Orders that left the book in the last 1 to 2 days (since 00:00 UTC yesterday, whenever placed) come first by exit time; then older ones placed in the last 30 days, by placement day then order id, not by exit time. coin: one market; outcome: filled, canceled or rejected. A page can be shorter than limit while next_cursor is set: keep following it (pass it as cursor). A cursor of the last-days part expires after about 2 days (400: start again without one). Orders whose last status fell in an ingest gap of our node are missing: Hyperliquid's historicalOrders has them. |
get_wallet_pnlread-only | One wallet's positions on HyperEVM or Elysium and how it did: per token balance, average cost, cost of what it holds, bought / sold amounts and USD, realized and unrealized PnL at the current price, first buy, last trade (pools=true: per pool too); totals for 1d / 7d / 30d / all: realized PnL, volume, swaps, closed positions and win rate, all-time unrealized PnL and value. Average cost over the wallet's priced swaps; tokens received by transfer are held with no cost; the native HYPE balance is in the wrapped HYPE row. sort = value, pnl, realized, unrealized, volume or lastTrade; status = all, open or closed. Medium call; live: WS pnl. |
get_wallet_stopsread-only | A wallet's open HyperCore trigger orders (stop-loss / take-profit): coin, side, trigger and limit price, size (0 = whole position), reduce-only, placed at. history: true lists instead every status event of its trigger orders over the last 3 days at most (placed, triggered, canceled, rejected, and the fill or cancel of the order a trigger placed, `triggered: true`), newest first (a heavy call; next page: pass `next_cursor` as cursor). |
get_wallet_value_historyread-only | The USD value of one address on HyperEVM or Elysium over time: window 1d (5 min points), 7d (hourly), 30d or all (daily), then the head. Exact balances at each point (our archive node + the stored transfers), prices as get_price_history. Spam and unpriced tokens left out. Heavy for window=all; current holdings: get_balances. |
get_wall_eventsread-only | One HyperCore market's large resting orders that the price came to, one by one, newest first: held (filled) or pulled (cancelled as the price came), with time, price, size, value, life and owner. A wall: a resting limit order (Gtc or Alo, not a trigger) worth at least $25k, placed on its passive side at least 20 bps from the last trade (a bid below, an ask above), resting 24 h at most. Tested: the price came to it before it ended. It held when it traded (a fill of the order), wholly or in part, however it ended; it was pulled when its owner cancelled it unfilled (a cancel or a scheduled cancel) with a trade within 10 bps of it, or through it, in the 60 s from its cancel on: as the price came, or just ahead of it (ladders that requote large orders a few seconds ahead of the price are pulled walls, the commonest kind). Up to 24 h per call. |
get_wallsread-only | Which HyperCore accounts' order book walls hold: per account, its large resting orders placed away from the price (≥ $25k, ≥ 20 bps away), how many the price came to, how many held (filled) and how many were pulled as the price came, with the hold rate. A low hold rate over many tested walls is liquidity that leaves as the price comes: requoting ladders, or spoofing (a record, not a verdict). Filter by market, account, side, wall size tier; window 24h, 7d or all (since 2026-10-13 15:50 UTC). |
get_webhookread-only | One of your webhooks: state (pending_verification, active, or disabled with the reason and how to turn it on), failures in a row, subscriptions with their seq, today's deliveries against your tier's daily limit. |
get_webhook_deliveriesread-only | Deliveries of one webhook, newest first (kept 7 days): msgId (the webhook-id header), type, status pending / delivered / dead, and each attempt with its HTTP status, latency, error and the first 4 KiB of your answer. Next page: pass `next_cursor` as cursor. |
hyperevm_rpc | One JSON-RPC call on our HyperEVM (chain 999) node, free: eth_chainId, eth_blockNumber, net_version, net_listening, web3_clientVersion, eth_syncing, eth_getBlockByNumber, eth_getBlockByHash, eth_getBlockTransactionCountByNumber, eth_getBlockTransactionCountByHash, eth_getTransactionByHash, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByBlockHashAndIndex, eth_getTransactionReceipt, eth_getBlockReceipts, eth_getBalance, eth_getCode, eth_getStorageAt, eth_getTransactionCount, eth_call, eth_estimateGas, eth_gasPrice, eth_maxPriorityFeePerGas, eth_feeHistory, eth_getLogs, eth_getProof, and eth_sendRawTransaction (a transaction you signed, sent on to the chain; its answer is the hash). The answer is the node's {jsonrpc, id, result} or {error}. eth_getLogs over at most 1000 blocks; state (eth_call, eth_getBalance…) of the last 128 blocks only. Limits of your key's plan (no key: 5/s per IP): use the indexed tools for history. |
kol_activityread-only | Latest moves of named wallets, newest first: HyperCore fills (minNotional USD, default 1000), HyperEVM / Elysium swaps and transfers. Optionally one entity (id from search_entities). Next page: pass `next_cursor` as cursor. |
kol_leaderboardread-only | Named wallets ranked by their trading on a layer. hypercore: PnL, volume, fills, win rate, open notional (default 7d, sort netPnl). hyperevm / elysium: swaps, transfers, net buy, holdings, bridge legs (default 24h, sort volume). |
kol_positioningread-only | How named wallets (KOLs, funds, market makers; or smart-money clusters with kind=cluster) are positioned on each HyperCore perp: long vs short notional and entity counts, net, average entry and unrealized PnL per side, the named position closest to liquidation, the largest entities per side, and the net change over 1 h and 24 h. One market with coin. |
list_forensics_reportsread-only | Every token forensics report written so far on Elysium, newest first: token, symbol, verdict label and sentence, model, time. Free, no key. Read one with get_forensics_report. |
list_launchesread-only | Latest token launches: Elysium (default) every launchpad, Ascend and every bonding curve inferred from its trades (launchpad name, curve progress, graduation to a DEX pool), or HyperEVM LiquidLaunch (launchpad = liquidlaunch). Each: token, the pool it trades in now (pair), creator, priceUsd, mcapUsd, 24 h volume, holders, top-10 / dev share, dev sold, Ascend progress and on-chain graduation (Ascend rows: ascendGraduation phase, progress, hold, graduatedAt, deadline). sort: newest (default), volume24h, mcap, progress; status: curve, graduated, pool. Next page (newest, Elysium): pass `next_cursor` as cursor. |
list_launchpadsread-only | Every launchpad of Elysium (default) or HyperEVM ranked by launches in 24 h (or by 24 h volume, graduations, all-time launches): launches 24h / 7d / all time, tokens on their curve, graduated and the graduation rate, the 24 h USD volume of its tokens, its top token, its latest launch. A launchpad's tokens: list_launches with launchpad = its name. |
list_marketsread-only | Tradable markets of a layer, most traded first (24 h USD volume) unless sort says otherwise; HyperCore markets are sorted by the tool (GET /v1/markets without sort answers them in the venue's order). hypercore: perps, spot, HIP-3 dex perps (dex:COIN), outcome markets; `id` is the coin to pass to get_candles / get_trades (BTC, @107, xyz:TSLA); each with its last 5 min and last hour (change5m / change1h, volume5mUsd / volume1hUsd, trades5m / trades1h, traders5m / traders1h: distinct accounts) and trendScore; sort (hypercore only): trending (markets with a score above 0, highest first), volume, volume1h, volume5m, gainers, losers. hyperevm / elysium: DEX pools with price, priceUsd, 24 h volume, mcapUsd (Elysium); `id` is the pool key to pass to get_candles / get_trades / get_pool. `total` = markets matching. Next page: pass `next_cursor` as cursor. pairs (a watchlist, up to 100 ids, comma-separated: pool keys, HyperCore coins): those markets only, in that order, whatever q, kind, limit and the spam filter. |
list_mev_botsread-only | The sandwich bots of Elysium over 24h, 7d, 30d or all, most USD taken first: contracts, first / last seen, sandwiches, USD taken, victims, pools, median tip (wei). |
list_new_poolsread-only | Every new pair / pool of every DEX on HyperEVM or Elysium (V2, V3, V4, PancakeSwap Infinity, LiquidLaunch curves…), newest first: dex, factory, fee tier, hooks, both tokens with symbols and whether each was just created (newToken), creation block / tx / time, initial liquidity, current liquidity (V2 / V3 pools: token balances; V4 / Infinity: what their positions hold at their price; USD = twice the smaller side), price, 24 h volume. Pools of a spam token left out. Filters: dex, token (either side), quote, minLiquidityUsd, newTokenOnly, since (ms). Filtered pages may hold fewer rows than limit: keep paging with `next_cursor` (null = no more). Live: WS <layer>.pools.new. |
list_new_tokensread-only | Every ERC-20 created on HyperEVM or Elysium, newest first (not only launchpad launches): creation block / tx / time, creator, the contract it was deployed through, launchpad (ascend, liquidlaunch… or null = direct), first pool (dex, quote, initial liquidity) and, once a pool exists, priceUsd, mcapUsd, liquidityUsd, 24 h volume, holders; an Ascend token (Elysium): its on-chain graduation (ascendGraduation: phase, progress, graduatedAt). Spam tokens left out. Filters: launchpad (name, none, any, 0x), hasPool, minLiquidityUsd, minHolders, creator, since (ms); security=summary adds the cached get_token_security verdict to each row. Filtered pages may hold fewer rows than limit: keep paging with `next_cursor` (null = no more). Live: WS <layer>.tokens.new. |
list_nft_collectionsread-only | Most active NFT collections of an EVM layer over the last 1 h or 24 h before the indexed head: transfers, mints, burns, with each collection's name, symbol, standard and logo. |
list_open_interestread-only | Open interest of every HyperCore perp now (main dex and HIP-3): size and USD value, accounts long and short, change over 1 h, 24 h and 7 d, totals per perp dex. Sort by value, size, 24 h change or accounts. Exact, from every fill and hourly funding. |
list_pool_metricsread-only | The pools of a DEX with their numbers (HyperSwap V3 and V2 on HyperEVM): what each pool holds and its USD value (TVL), and over 24h, 7d and 30d its swaps, volume, fees paid, the liquidity providers' and the protocol's parts, and its fee APR (LP fees over the tokens held through the window, at current prices, simple, % per year). Fees are recomputed swap by swap from the chain, not estimated. A token that is not a reference asset (HYPE, WHYPE, HyperCore-linked tokens) is valued at most at the reference assets held against it in the layer's pools (`tvl.capped`), so a made-up price never inflates a TVL. Filter by `dex`, `token` (either side), `minTvlUsd`; sort by tvl, liquidity, volume, fees or apr on `window`. A window that reaches before the metrics start (`since`) or the pool's creation has `apr` null and `covered.apr` over the part counted. Next page: pass `next_cursor` as cursor. |
list_sandwichesread-only | Sandwich attacks found on Elysium, newest first, one row per victim swap: confidence (strict / probable), the victim and the bot, the pool and tokens, front-run / victim / back-run transactions and blocks, what the victim paid and lost in USD, the bot's profit, tips. Filters: victim, bot, pool, token, from / to (Unix ms), minLossUsd, confidence; keep paging with next_cursor. |
list_sent_transactionsread-only | The transactions this account sent through hyperevm_rpc / elysium_rpc or POST /v1/<layer>/rpc in the last 24 hours (layer; from: up to 10 sender addresses), newest first, each pending (with the upstreams that accepted it), included, replaced or dropped. Never another account's. |
list_top_tokensread-only | The tokens of HyperEVM or Elysium with activity (a pool traded in the last 24 hours, or created in the last hour), one row per token over all its pools (not one per pool like list_markets): price, windows 5m / 1h / 6h / 24h (change, volume, trades, buys / sells, distinct traders / buyers / sellers), liquidity, market cap, FDV, holders (daily snapshot and now) and top-10 share, first pool time, pool count, the most traded pool (topPool: the market for get_candles / get_trades), creator, launchpad and launch (progress, bonded, dev share, dev sold, the on-chain graduation of an Ascend launch), the HyperCore price and gap of a Core-linked token, socials, named wallets trading it, a 24 h hourly spark and a 1 h five-minute spark. sort: trending (default; rows with a score of 0 left out), volume, gainers, losers, new, mcap, liquidity. Stablecoins and WHYPE left out unless includeStables, spam unless includeSpam, liquidity under minLiquidityUsd (default 1000) always. security=summary adds the cached get_token_security verdict to each row. addresses (a watchlist, up to 100 token addresses, comma-separated): those tokens' rows only, in that order, whatever sort and filters (spam ones flagged). Trending = last-hour volume (capped at 10 × liquidity) × its acceleration over the 24 h hourly average × √distinct wallets. Next page: pass next_cursor as cursor. |
list_webhooksread-only | Your account's webhooks: URL, state (pending_verification, active, disabled with the reason and how to enable), failures in a row, subscriptions. A rotated key sees the same webhooks. Next page: pass `next_cursor` as cursor. |
pay_with_wallet | Step 2: send chain, authorization (the quote typedData.message), signature, and the planId / interval or usd of the quote. Femtos settles it on chain (no gas for you) and credits the account or buys the plan. state pending: call again with the same body after retryAfter (never charged twice). Spends money. Free. |
quote_wallet_payment | Step 1 of paying from an EVM wallet with USDC (Base, Arbitrum One or HyperEVM), no gas: the EIP-712 typed data of a USDC TransferWithAuthorization to sign with eth_signTypedData_v4, for a plan (planId, interval: what the balance lacks) or a top-up (usd). Then pay_with_wallet with the signature. Free. |
recover_accountdestructive | No key needed. Send wallet, nonce and the signature of the recovery message: answers a new key and management secret (save both), the old ones stop working. |
replay_webhook | Send deliveries again, same webhook-id (dedupe on it): one (msgId, delivered or dead), or every dead one since a time (since, Unix ms within 7 days; status all: delivered ones too). |
rotate_keydestructive | Replace your API key: the new one is answered once, the current one (the one this MCP connection uses) stops working at once: reconnect with the new key. Needs management_secret (agents); an account with an email gets a confirmation link instead. Free. |
rotate_webhook_secret | A new whsec_ signing secret, answered once; for 24 h every delivery carries two signatures (the new and the previous secret): accept either while you switch. |
search_coinsread-only | Tokens by symbol, name or address, with their links across layers (Elysium <-> HyperEVM <-> HyperCore), decimals, supply and USD price. Without layer: every layer. An exact address always answers its token (spam flagged). |
search_entitiesread-only | Search named entities by name, X handle or address: people and traders (KOLs, funds, market makers, from public attribution lists, not verified identities) and organisations (exchanges, protocols, launchpads, builders, bridges, the chain's system addresses, from on-chain facts or their own published addresses). Filter with `type`. A person's address is given as its handle <entityId>.<hex>, usable as an address in every tool. Use the entity id with get_entity or kol_activity. To ask who one or many addresses are: get_identity. Next page: pass `next_cursor` as cursor. |
set_spending_cap | Set your monthly spending cap in USD (null lifts it). Past it, heavy and medium calls answer 402 until next month. Answers the billing view. Free. |
signup | No key needed. Step 2: send agent_name with the solved salt and nonce; answers a free API key and a management secret, each once: save both (the secret rotates, unfreezes and deletes the account). Then connect with Authorization: Bearer <key>. |
subscribe_plan | Subscribe to a plan (get_plans lists them): paid from your USDC balance now (interval month, or year = 12 months prepaid at a discount) and renewed from it, or by card (checkout URL). Spends money. 402 insufficient_balance says how much to deposit. Free. |
test_webhook | Queue a webhook.test delivery to a verified webhook (not billed); its result shows in get_webhook_deliveries within seconds. |
token_forensics | Start a sourced investigation of one token launch on Elysium (insider allocation, dumps, one-operator wallet clusters, funding and exits across chains, team links). Returns a job id at once: read the report with ai_job (wait up to 60 s, call again until done; a run takes minutes). Any account with prepaid credit, free plan included; 25 USD held, charged model cost x 1.25 + 5 USD (at most 25), a report under 1 h old is free. |
update_webhook | Change a webhook: url (verified again by a webhook.verification challenge before anything else is sent), description, or subscriptions (the whole list: unchanged ones keep their seq). |
protogrid