Femtos MCP

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Layer status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 64,
      "description": "Substring of the symbol, base, quote, addresses or protocol"
    },
    "kind": {
      "enum": [
        "perp",
        "spot",
        "hip3",
        "outcome"
      ],
      "type": "string",
      "description": "hypercore only: one kind of market"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 50, max 200)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Markets and pools",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 64,
      "description": "Substring of the symbol, name or address"
    },
    "sort": {
      "enum": [
        "trending",
        "volume",
        "gainers",
        "losers",
        "new",
        "mcap",
        "liquidity"
      ],
      "type": "string",
      "description": "trending: trendScore; volume: volume24hUsd; gainers / losers: change24h (rows without one left out); new: createdAt, newest first; mcap: mcapUsd; liquidity: liquidityUsd. Ties: volume24hUsd, then address (default trending)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 20)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Show spam tokens (tokens.spam: homoglyph, impostor, phishing name, fake transfers…) flagged spam / spamReason; left out of the list by default"
    },
    "includeStables": {
      "type": "boolean",
      "description": "USD stablecoins and the native / wrapped native quote assets (HYPE, WHYPE, backed wrappers), flagged `stable`; left out by default"
    },
    "minLiquidityUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum USD liquidity over its pools (default 1000)"
    }
  }
}

{
  "title": "Token screener (trending, gainers, new…)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "tf"
  ],
  "properties": {
    "tf": {
      "enum": [
        "1s",
        "15s",
        "1m",
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "description": "Candle unit"
    },
    "to": {
      "type": "integer",
      "maximum": 1000000000000000,
      "minimum": 0,
      "description": "End, Unix ms (exclusive; default now)"
    },
    "from": {
      "type": "integer",
      "maximum": 1000000000000000,
      "minimum": 0,
      "description": "Start, Unix ms (inclusive)"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Candles (default 50, 30 for 1d; max 1000)"
    },
    "token": {
      "type": "string",
      "maxLength": 66,
      "minLength": 1,
      "description": "Instead of market: a token (0x address; hypercore: name HYPE, PURR)"
    },
    "market": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "hypercore: coin; hyperevm / elysium: pool key (or give token)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "OHLCV candles",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 999999999999999,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}$"
        }
      ],
      "description": "Window end, Unix ms (exclusive)"
    },
    "from": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 999999999999999,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}$"
        }
      ],
      "description": "Window start, Unix ms (inclusive)"
    },
    "pool": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}(:0x[0-9a-fA-F]{64})?$",
      "description": "History of a pool (alias: market)"
    },
    "side": {
      "enum": [
        "buy",
        "sell"
      ],
      "type": "string",
      "description": "Buys or sells of the base"
    },
    "layer": {
      "enum": [
        "elysium",
        "hyperevm",
        "hypercore"
      ],
      "type": "string",
      "description": "Layer (default hypercore)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Swaps where this token is base or quote"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "market": {
      "type": "string",
      "description": "Pair address (pool key) or coin; required without trader / pool / token"
    },
    "minUsd": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}(\\.\\d{1,6})?$"
        }
      ],
      "description": "Smallest USD value (the indexer's, at the swap)"
    },
    "trader": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "History of a wallet (tx.from of the swaps); a named wallet's handle works too"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Swaps of spam tokens too (flagged)"
    }
  }
}

{
  "title": "Trades / swaps, and swap history of a wallet, pool or token",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Symbol, name or address"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "One layer (default all)"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 20, max 200)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Find tokens",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "HyperCore name / index / token id, or 0x address"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One token",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "kind": {
      "enum": [
        "balances",
        "positions",
        "spot",
        "perp"
      ],
      "type": "string",
      "description": "HyperCore: spot balances of a token, or perp positions (open interest by account) of a coin (spot / perp: the same). Default: positions for a perp coin, else balances"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer (default hypercore)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "token": {
      "type": "string",
      "pattern": "^([A-Za-z0-9@#:/._+-]{1,64}|0x[0-9a-fA-F]{40}(:0x[0-9a-fA-F]{64})?)$",
      "description": "Token address (Elysium, HyperEVM), token name or perp coin (HyperCore)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "excludeSystem": {
      "type": "boolean",
      "description": "1 / true: pools, PoolManager, hooks, gateways, bridge system addresses, LiquidLaunch curve, zero/dead counted apart; 0 / false: counted with the others (default true)"
    }
  }
}

{
  "title": "Token holders",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "UTC days, today included (default 90)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Holder count history",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 64,
      "description": "Elysium: symbol or name contains (case ignored)"
    },
    "layer": {
      "enum": [
        "elysium",
        "hyperevm"
      ],
      "type": "string",
      "description": "hyperevm = LiquidLaunch"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 20)"
    },
    "quote": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Elysium: quote token of the pool (USDC, an RWA token…)"
    },
    "since": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Elysium: launched at or after (ms)"
    },
    "until": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Elysium: launched before (ms)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "creator": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Elysium: launched by this wallet (creator at launch or current creator)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "launchpad": {
      "type": "string",
      "description": "Launchpad name: ascend (Elysium), liquidlaunch (HyperEVM)"
    },
    "minHolders": {
      "type": "integer",
      "maximum": 999999999,
      "minimum": 1,
      "description": "Ascended criterion: minimum unique holders (system excluded)"
    },
    "minMcapUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum market cap, USD (decimal string)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Show spam tokens (tokens.spam: homoglyph, impostor, phishing name, fake transfers…) flagged spam / spamReason; left out of the list by default"
    },
    "minVolumeUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum volume since launch, USD"
    },
    "maxTop10Share": {
      "type": "number",
      "maximum": 1,
      "description": "Ascended criterion: maximum top-10 share of the supply",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Token launches",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Rows (default 20)"
    },
    "since": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Created at or after (Unix ms)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "creator": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Created by this wallet (0x)"
    },
    "hasPool": {
      "type": "boolean",
      "description": "true: tokens with a pool; false: without"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "security": {
      "enum": [
        "summary"
      ],
      "type": "string",
      "description": "summary: each row gets `security` = {verdict, reasons (3), asOf, height} of GET /api/tokens/{address}/security when a report is cached (< 10 min), else null (then computed in the background: ask again)"
    },
    "launchpad": {
      "type": "string",
      "pattern": "^([A-Za-z0-9_.-]{1,40}|0x[0-9a-fA-F]{40})$",
      "description": "ascend, liquidlaunch (a launchpad name), none (no launchpad), any (a launchpad), or a launchpad 0x address"
    },
    "minHolders": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Minimum holders"
    },
    "sinceBlock": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "Created at or after this block"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Show spam tokens (tokens.spam: homoglyph, impostor, phishing name, fake transfers…) flagged spam / spamReason; left out of the list by default"
    },
    "minLiquidityUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum USD liquidity of its pools (twice the smaller side)"
    }
  }
}

{
  "title": "New tokens (chain-wide)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "dex": {
      "type": "string",
      "pattern": "^[a-z0-9_]{1,40}$",
      "description": "Protocol (hyperswap_v3, projectx_v3, uniswap_v4, pancake_infinity_cl, liquidlaunch…)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Rows (default 20)"
    },
    "quote": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Pools quoted in this token (0x), e.g. WHYPE"
    },
    "since": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Created at or after (Unix ms)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Pools of this token, either side (0x)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "sinceBlock": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "Created at or after this block"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Show spam tokens (tokens.spam: homoglyph, impostor, phishing name, fake transfers…) flagged spam / spamReason; left out of the list by default"
    },
    "newTokenOnly": {
      "type": "boolean",
      "description": "Only pools with a new token (newToken not null)"
    },
    "newWithinMin": {
      "type": "integer",
      "maximum": 10080,
      "minimum": 1,
      "description": "A side is new when created at most this many minutes before the pool (default 60)"
    },
    "minLiquidityUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum current USD liquidity"
    }
  }
}

{
  "title": "New pools (chain-wide)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "layer": {
      "enum": [
        "elysium",
        "hyperevm"
      ],
      "type": "string",
      "description": "Default: Elysium, then HyperEVM LiquidLaunch when Elysium has no launch for the token"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Launched token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "minHolders": {
      "type": "integer",
      "maximum": 999999999,
      "minimum": 1,
      "description": "Ascended criterion: minimum unique holders (system excluded)"
    },
    "minMcapUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum market cap, USD (decimal string)"
    },
    "minVolumeUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum volume since launch, USD"
    },
    "maxTop10Share": {
      "type": "number",
      "maximum": 1,
      "description": "Ascended criterion: maximum top-10 share of the supply",
      "exclusiveMinimum": 0
    },
    "earlyWindowSec": {
      "type": "integer",
      "maximum": 3600,
      "minimum": 1,
      "description": "Early-buyer window after the launch block (default 60)"
    },
    "fundingLookbackSec": {
      "type": "integer",
      "maximum": 604800,
      "minimum": 1,
      "description": "Funding lookback before the launch (default 86400)"
    }
  }
}

{
  "title": "One launch",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "layer": {
      "enum": [
        "elysium",
        "hyperevm"
      ],
      "type": "string",
      "description": "Default: Elysium, then HyperEVM"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Launched token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Launch timeline",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Elysium / HyperEVM address, core:<index>, HyperCore token id, name or perp coin"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "minHolders": {
      "type": "integer",
      "maximum": 999999999,
      "minimum": 1,
      "description": "Ascended criterion: minimum unique holders (system excluded)"
    },
    "minMcapUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum market cap, USD (decimal string)"
    },
    "minVolumeUsd": {
      "type": "string",
      "description": "Ascended criterion: minimum volume since launch, USD"
    },
    "maxTop10Share": {
      "type": "number",
      "maximum": 1,
      "description": "Ascended criterion: maximum top-10 share of the supply",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Token across the 3 layers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Token security / honeypot check",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tokens"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium",
        "hypercore"
      ],
      "type": "string",
      "description": "Layer: hyperevm / elysium (0x token addresses) or hypercore (token names HYPE, PURR, token ids, perp coins BTC). Absent: hypercore when every token is a name, else hyperevm"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 66,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "0x addresses (hyperevm, elysium) or HyperCore names / perp coins"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Token prices (batch)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tokens"
  ],
  "properties": {
    "at": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Time (Unix ms): price at or before it"
    },
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Series end (Unix ms, exclusive; default now)"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Series start (Unix ms, inclusive, aligned down to the unit)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium",
        "hypercore"
      ],
      "type": "string",
      "description": "Layer: hyperevm / elysium (0x token addresses) or hypercore (token names HYPE, PURR, token ids, perp coins BTC). Absent: hypercore when every token is a name, else hyperevm"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Units per token at most (default 200)"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 66,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "0x addresses or HyperCore names"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "interval": {
      "enum": [
        "1m",
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "description": "Series unit"
    }
  }
}

{
  "title": "Token price history (batch)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "addresses"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium",
        "hypercore"
      ],
      "type": "string",
      "description": "Layer: hyperevm / elysium (0x token addresses) or hypercore (token names HYPE, PURR, token ids, perp coins BTC). Absent: hypercore when every token is a name, else hyperevm"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "addresses": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 66,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "0x addresses (hypercore: names / token ids)"
    }
  }
}

{
  "title": "Token metadata (batch)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Token overview (all pools)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "token"
  ],
  "properties": {
    "sort": {
      "enum": [
        "pnl",
        "realized",
        "volume"
      ],
      "type": "string",
      "description": "pnl (total, highest first), realized (realized PnL) or volume (USD bought + sold) (default pnl)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Traders (default 20)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address"
    },
    "window": {
      "enum": [
        "1h",
        "6h",
        "24h"
      ],
      "type": "string",
      "description": "Window ending at the indexed head: 1h, 6h or 24h (default 24h)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Top traders of a token (PnL)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "route": {
      "enum": [
        "evm_elysium",
        "core_evm"
      ],
      "type": "string",
      "description": "Bridge (default core_evm)"
    },
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,64}$",
      "description": "Token address (`hype` for native HYPE)"
    },
    "system": {
      "enum": [
        "exclude",
        "include",
        "only"
      ],
      "type": "string",
      "description": "Kinetiq system retryables (evm_elysium) (default exclude)"
    },
    "account": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Sender or recipient"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "direction": {
      "enum": [
        "to_child",
        "to_parent",
        "evm_to_core",
        "core_to_evm"
      ],
      "type": "string",
      "description": "Direction"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "evm_elysium: rows of spam parent tokens (HyperEVM tokens.spam), left out by default"
    }
  }
}

{
  "title": "Bridge movements",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "0x address, or a named wallet's handle <entityId>.<hex>"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "Show spam tokens (tokens.spam: homoglyph, impostor, fake transfers…), flagged spam / spamReason; hidden from lists and USD totals by default"
    }
  }
}

{
  "title": "Cross-layer wallet",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "at": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Past balances at this time (Unix ms): the last block at or before it"
    },
    "sort": {
      "enum": [
        "usd",
        "amount"
      ],
      "type": "string",
      "description": "Order (default usd)"
    },
    "block": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Past balances at this block (one layer; EVM: tokens= required; HyperCore: the snapshot at or before this height)"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium",
        "all"
      ],
      "type": "string",
      "description": "Layer(s) read (default all)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "minUsd": {
      "type": "number",
      "minimum": 0,
      "description": "Leave out holdings worth less (and unpriced ones)"
    },
    "tokens": {
      "type": "string",
      "description": "Comma list (at most 50; 20 with block / at): EVM token addresses (`native` = HYPE) and HyperCore coin names; every token asked is listed, held or not (0)"
    },
    "verify": {
      "type": "boolean",
      "description": "EVM layers: read the rows answered (at most 50 per layer) again on the node at the same block"
    },
    "address": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "0x address, or a named wallet's handle `<entityId>.<hex>`"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "List spam tokens (flagged spam / spamReason); never in the totals"
    }
  }
}

{
  "title": "Token balances",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address",
    "token"
  ],
  "properties": {
    "at": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Past balance at this time (Unix ms)"
    },
    "block": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Past balance at this block"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Default: hypercore for a coin name, hyperevm for an address"
    },
    "token": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9._-]{0,19})$",
      "description": "EVM token address, `native` (HYPE), or a HyperCore coin name"
    },
    "verify": {
      "type": "boolean",
      "description": "EVM layers: read it again on the node at the same block"
    },
    "address": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "0x address, or a named wallet's handle `<entityId>.<hex>`"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One token balance",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "token"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Days (default 30)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Daily token volume",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "to": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 999999999999999,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}$"
        }
      ],
      "description": "With address: window end, Unix ms (exclusive)"
    },
    "from": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 999999999999999,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}$"
        }
      ],
      "description": "With address: window start, Unix ms (inclusive)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "token": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Token address (required without address)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "minUsd": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d{1,15}(\\.\\d{1,6})?$"
        }
      ],
      "description": "With address: smallest amount × current token price, USD"
    },
    "address": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Transfers from / to this address (a named wallet's handle works too); token then optional"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "direction": {
      "enum": [
        "in",
        "out",
        "any"
      ],
      "type": "string",
      "description": "With address: received, sent or both (default any)"
    },
    "includeSpam": {
      "type": "boolean",
      "description": "With address: transfers of spam tokens too (flagged)"
    }
  }
}

{
  "title": "ERC-20 transfers (of a token, or from / to an address)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address",
    "layer"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}(:0x[0-9a-fA-F]{64})?$",
      "description": "Pool address, or <PoolManager>:<PoolId>"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One pool",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "Transaction hash (0x + 64 hex)"
    },
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Only this layer (default: HyperEVM, then Elysium)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One transaction",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "window": {
      "enum": [
        "1h",
        "6h",
        "24h",
        "7d"
      ],
      "type": "string",
      "description": "Window ending now: 1h, 6h, 24h or 7d (default 1h)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "resolution": {
      "enum": [
        "block",
        "10s",
        "1m",
        "5m",
        "15m",
        "1h"
      ],
      "type": "string",
      "description": "block, 10s, 1m, 5m, 15m or 1h; default auto (every block up to 25000 per series) (default 15m)"
    }
  }
}

{
  "title": "Gas tracker",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer (default hyperevm)"
    },
    "number": {
      "anyOf": [
        {
          "type": "string",
          "const": "latest"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        }
      ],
      "description": "Block number, or latest"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One block",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "method"
  ],
  "properties": {
    "method": {
      "type": "string",
      "description": "A method served: 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 (not available: eth_sendRawTransaction / eth_sendTransaction, eth_subscribe, filters, debug_*, trace_*)"
    },
    "params": {
      "type": "array",
      "items": {},
      "description": "Its parameters, as the method takes them (absent: none)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Elysium JSON-RPC (read only)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "HyperCore coin: BTC, @107, xyz:TSLA"
    },
    "depth": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Levels per side (default 20, max 100)"
    }
  }
}

{
  "title": "Order book",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Market (perp name, spot @index, HIP-3 dex:COIN); every market when absent"
    },
    "side": {
      "enum": [
        "B",
        "A"
      ],
      "type": "string",
      "description": "B bids only, A asks only; both when absent"
    },
    "sort": {
      "enum": [
        "tested",
        "pulled",
        "held",
        "walls",
        "pulledUsd",
        "holdRate"
      ],
      "type": "string",
      "description": "Order, largest first (holdRate: lowest first) (default pulled)"
    },
    "tier": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1,
      "description": "Smallest wall counted: 1 = $25k and more, 2 = $100k and more, 3 = $1M and more (default 1)"
    },
    "user": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Only this account"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Accounts (default 25)"
    },
    "window": {
      "enum": [
        "24h",
        "7d",
        "all"
      ],
      "type": "string",
      "description": "Window, whole hours ending with the current one: 24h, 7d, or all (since 2026-10-13 15:50 UTC) (default 7d)"
    },
    "minTested": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Accounts with at least this many tested walls (default 5)"
    }
  }
}

{
  "title": "Order book wall reliability",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "To (Unix ms); default now"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Market (perp name, spot @index, HIP-3 dex:COIN)"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "From (Unix ms); default `to` − 24 h"
    },
    "tier": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1,
      "description": "Smallest wall: 1 = $25k and more, 2 = $100k and more, 3 = $1M and more (default 2)"
    },
    "limit": {
      "type": "integer",
      "maximum": 2000,
      "minimum": 1,
      "description": "Events (default 100)"
    }
  }
}

{
  "title": "Walls held or pulled on a market",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin",
    "tf"
  ],
  "properties": {
    "tf": {
      "enum": [
        "1m",
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "description": "Bar unit"
    },
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "End (ms, exclusive; default now)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp market: BTC, xyz:TSLA (HIP-3: dex:COIN)"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Start (ms, inclusive; aligned down to the unit). Without it: the `limit` bars ending at `to`"
    },
    "limit": {
      "type": "integer",
      "maximum": 5000,
      "minimum": 1,
      "description": "Bars (default 100)"
    }
  }
}

{
  "title": "Open interest history of a perp",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "pattern": "^[a-z0-9]{0,16}$",
      "description": "Only this perp dex (\"\" = the main one); every dex when absent"
    },
    "sort": {
      "enum": [
        "usd",
        "oi",
        "pct24h",
        "accounts"
      ],
      "type": "string",
      "description": "Order, largest first (pct24h: largest increase first) (default usd)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Markets (default 25)"
    }
  }
}

{
  "title": "Open interest of every perp",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "End (ms, exclusive; default now)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp market: BTC, xyz:TSLA"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Start (ms, inclusive). Without it: the `limit` points ending at `to`"
    },
    "every": {
      "enum": [
        "1h",
        "1d"
      ],
      "type": "string",
      "description": "1h: every hourly funding; 1d: the first of each day (default 1h)"
    },
    "limit": {
      "type": "integer",
      "maximum": 744,
      "minimum": 1,
      "description": "Points (744: a month of hours) (default 48)"
    }
  }
}

{
  "title": "Open interest by position size",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "End (ms, exclusive; aligned up to the minute; at most a day after `from`)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp market: BTC, xyz:TSLA"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Start (ms, inclusive; aligned down to the minute)"
    },
    "side": {
      "enum": [
        "long",
        "short"
      ],
      "type": "string",
      "description": "Only the orders that opened longs, or shorts"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Orders (default 20)"
    }
  }
}

{
  "title": "Largest orders that opened positions",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Window end (ms, exclusive)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "One coin"
    },
    "from": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Window start (ms)"
    },
    "user": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "One liquidated account (0x)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "minNotional": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Smallest notional, USD"
    }
  }
}

{
  "title": "Liquidations",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "One coin"
    },
    "window": {
      "enum": [
        "1h",
        "24h",
        "7d",
        "30d"
      ],
      "type": "string",
      "description": "Window (default 24h)"
    }
  }
}

{
  "title": "Liquidation stats",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp coin (BTC, xyz:TSLA)"
    },
    "side": {
      "enum": [
        "long",
        "short"
      ],
      "type": "string",
      "description": "One side"
    },
    "sort": {
      "enum": [
        "notional",
        "upnl",
        "liqDistance"
      ],
      "type": "string",
      "description": "Sort (default notional)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Order (default: desc, liqDistance asc)"
    }
  }
}

{
  "title": "Open positions",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Window end (ms, exclusive)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp coin (BTC, xyz:TSLA)"
    },
    "from": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Window start (ms)"
    },
    "sort": {
      "enum": [
        "time",
        "notional"
      ],
      "type": "string",
      "description": "Newest first, or largest first (default time)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "minNotional": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Smallest notional, USD (default 100000)"
    }
  }
}

{
  "title": "Large position changes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "HyperCore coin: BTC, ETH, xyz:TSLA"
    },
    "step": {
      "type": "string",
      "pattern": "^\\d{1,30}(\\.\\d{1,18})?$",
      "description": "Bucket width in price units, instead of buckets (at most 400 buckets)"
    },
    "buckets": {
      "type": "integer",
      "maximum": 400,
      "minimum": 1,
      "description": "Most buckets (default 20; the width is rounded up to 1, 2, 2.5 or 5 × 10^k)"
    },
    "rangePct": {
      "type": "number",
      "maximum": 100,
      "description": "Half-width of the grid around the mark, percent (default 10)",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Stop-loss / take-profit map",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp coin: BTC, ETH, xyz:TSLA"
    },
    "step": {
      "type": "string",
      "pattern": "^\\d{1,30}(\\.\\d{1,18})?$",
      "description": "Bucket width in price units, instead of buckets (at most 400 buckets)"
    },
    "buckets": {
      "type": "integer",
      "maximum": 400,
      "minimum": 1,
      "description": "Most buckets (default 20; the width is rounded up to 1, 2, 2.5 or 5 × 10^k)"
    },
    "rangePct": {
      "type": "number",
      "maximum": 100,
      "description": "Half-width of the grid around the mark, percent (default 10)",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Liquidation price map",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "Perp coin: BTC, ETH, xyz:TSLA"
    },
    "step": {
      "type": "string",
      "pattern": "^\\d{1,30}(\\.\\d{1,18})?$",
      "description": "Bucket width in price units, instead of buckets (at most 400 buckets)"
    },
    "buckets": {
      "type": "integer",
      "maximum": 400,
      "minimum": 1,
      "description": "Most buckets (default 20; the width is rounded up to 1, 2, 2.5 or 5 × 10^k)"
    },
    "rangePct": {
      "type": "number",
      "maximum": 100,
      "description": "Half-width of the grid around the mark, percent (default 10)",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Forced flow map (stops + liquidations)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "HyperCore coin: BTC, ETH, xyz:TSLA"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "since": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window start (Unix ms, default until − 1 h)"
    },
    "until": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window end (Unix ms, exclusive, default now)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    }
  }
}

{
  "title": "Triggered stops",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "history: events (default 100, max 1000)"
    },
    "since": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "history: window start (Unix ms, default until − 24 h, 3 days back at most)"
    },
    "until": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "history: window end (Unix ms, exclusive, default now)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "status": {
      "type": "string",
      "pattern": "^[A-Za-z]{1,40}$",
      "description": "history: one status (open, triggered, canceled, filled…)"
    },
    "address": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "0x address, or a named wallet's handle <entityId>.<hex>"
    },
    "history": {
      "type": "boolean",
      "description": "Past status events instead of the open orders (heavy call)"
    }
  }
}

{
  "title": "A wallet's stops",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin",
    "px_lo",
    "px_hi"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "HyperCore perp coin: BTC, xyz:TSLA"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Orders, and positions, listed (largest first) (default 50)"
    },
    "px_hi": {
      "type": "string",
      "pattern": "^\\d{1,30}(\\.\\d{1,18})?$",
      "description": "Band high edge (exclusive), price, over px_lo"
    },
    "px_lo": {
      "type": "string",
      "pattern": "^\\d{1,30}(\\.\\d{1,18})?$",
      "description": "Band low edge (inclusive), price"
    }
  }
}

{
  "title": "Who sits at a price level",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "window": {
      "enum": [
        "1h",
        "24h"
      ],
      "type": "string",
      "description": "Window (default 24h)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "NFT collections",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address",
    "layer"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Collection contract"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "One NFT collection",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "collection"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "collection": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Collection contract"
    }
  }
}

{
  "title": "NFT tokens",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "owner"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Tokens listed (default 50)"
    },
    "owner": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Holder address"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "NFTs of a wallet",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "layer",
    "collection"
  ],
  "properties": {
    "layer": {
      "enum": [
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "EVM layer"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "window": {
      "enum": [
        "24h",
        "7d"
      ],
      "type": "string",
      "description": "Window when scope is not all (default 24h)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "tokenId": {
      "type": "string",
      "pattern": "^\\d{1,78}$",
      "description": "One token"
    },
    "collection": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Collection contract"
    }
  }
}

{
  "title": "NFT transfers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 64,
      "description": "Name, X handle, alias, wallet address or handle"
    },
    "via": {
      "enum": [
        "list",
        "bridge",
        "subaccount",
        "transfer",
        "vault-leader",
        "self-declared",
        "smart-money",
        "smart-money-link"
      ],
      "type": "string",
      "description": "Entities with at least one wallet found this way (`via` of the wallets)"
    },
    "kind": {
      "type": "string",
      "maxLength": 64,
      "description": "Entities: named (people, funds, pseudonyms from public sources), cluster (anonymous smart-money clusters: HyperCore traders selected on their results), all, or a kind it contains (whale, market maker…). Default: all"
    },
    "sort": {
      "enum": [
        "default",
        "wallets",
        "name",
        "pnl"
      ],
      "type": "string",
      "description": "default: the registry order (our research first); wallets: most wallets first; name; pnl: smart-money net PnL first (default default)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Entities (default 20)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "confidence": {
      "enum": [
        "high",
        "medium",
        "low",
        "unrated"
      ],
      "type": "string",
      "description": "Entities with at least one wallet of this confidence"
    }
  }
}

{
  "title": "Named wallets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$",
      "description": "Entity id"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "How a named wallet was found",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$",
      "description": "Entity id"
    },
    "bucket": {
      "enum": [
        "1h",
        "1d"
      ],
      "type": "string",
      "description": "Bucket: 1h (window 7d or 30d) or 1d. Default 1d (default 1d)"
    },
    "window": {
      "enum": [
        "7d",
        "30d",
        "90d",
        "all"
      ],
      "type": "string",
      "description": "UTC days ending today: 7d, 30d, 90d, or all (since `dataStart`). Default 30d (default 30d)"
    }
  }
}

{
  "title": "A named wallet's PnL curve",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "type": "string",
      "pattern": "^[\\w /&.-]{0,40}$",
      "description": "Entities: named (people, funds, pseudonyms from public sources), cluster (anonymous smart-money clusters: HyperCore traders selected on their results), all, or a kind it contains (whale, market maker…). Default: named"
    },
    "sort": {
      "enum": [
        "netPnl",
        "realizedPnl",
        "volume",
        "fills",
        "winRate",
        "openNotional",
        "swaps",
        "transfers",
        "netBuy",
        "holdings",
        "bridges",
        "lastActivity"
      ],
      "type": "string",
      "description": "Sort (per layer, see above; default netPnl / volume)"
    },
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer (default hypercore)"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Rows (default 25)"
    },
    "window": {
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "type": "string",
      "description": "Window (hypercore: 7d by default, EVM layers: 24h)"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    }
  }
}

{
  "title": "Named-wallet leaderboard",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 20,
      "minimum": 0,
      "description": "Largest entities listed per side (default 3)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "One perp market only"
    },
    "kind": {
      "enum": [
        "named",
        "cluster",
        "all"
      ],
      "type": "string",
      "description": "Entities: named (people, funds, pseudonyms from public sources), cluster (anonymous smart-money clusters), all. Default: named (default named)"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Markets, largest gross notional first (default 20)"
    }
  }
}

{
  "title": "Named-wallet positioning per market",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "layer": {
      "enum": [
        "hypercore",
        "hyperevm",
        "elysium"
      ],
      "type": "string",
      "description": "Layer (default hypercore)"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "entity": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$",
      "description": "One entity only"
    },
    "network": {
      "enum": [
        "mainnet",
        "testnet"
      ],
      "type": "string",
      "description": "Elysium network: mainnet or testnet, same answers (testnet USD values null). HyperCore and HyperEVM are always mainnet (default mainnet)"
    },
    "minNotional": {
      "type": "string",
      "pattern": "^\\d{1,15}(\\.\\d{1,6})?$",
      "description": "Smallest USD value (hypercore: px × sz, default 1000; EVM: none by default)"
    }
  }
}

{
  "title": "Named-wallet moves",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sort": {
      "enum": [
        "fees",
        "volume",
        "fills",
        "users",
        "orders"
      ],
      "type": "string",
      "description": "Order, largest first (default fees)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Builders (default 25)"
    },
    "window": {
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "all"
      ],
      "type": "string",
      "description": "Window, whole hours ending with the current one: 24h, 7d, 30d, 90d, or all (since 2025-07-19) (default 30d)"
    }
  }
}

{
  "title": "Builder codes ranked",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "builder"
  ],
  "properties": {
    "window": {
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "all"
      ],
      "type": "string",
      "description": "Window, whole hours ending with the current one: 24h, 7d, 30d, 90d, or all (since 2025-07-19) (default 30d)"
    },
    "builder": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Builder address (0x), as orders name it in `builder.b`"
    }
  }
}

{
  "title": "One builder code",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "builder"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window end (Unix ms, exclusive, default now)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "One market"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window start (Unix ms, default to − 24 h)"
    },
    "user": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "One account"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "status": {
      "type": "string",
      "pattern": "^[A-Za-z]{2,40}$",
      "description": "One status"
    },
    "builder": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Builder address (0x), as orders name it in `builder.b`"
    }
  }
}

{
  "title": "Builder orders",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "builder"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window end (Unix ms, exclusive, default now)"
    },
    "coin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9@#:/._+-]{1,64}$",
      "description": "One market"
    },
    "from": {
      "type": "integer",
      "maximum": 999999999999999,
      "minimum": 0,
      "description": "Window start (Unix ms, default to − 24 h)"
    },
    "user": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "One account"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Rows (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "builder": {
      "type": "string",
      "pattern": "^(0x[0-9a-fA-F]{40}|[A-Za-z0-9][A-Za-z0-9_.-]{0,63}\\.[0-9a-fA-F]{8,64})$",
      "description": "Builder address (0x), as orders name it in `builder.b`"
    }
  }
}

{
  "title": "Builder fills",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url",
    "subscriptions"
  ],
  "properties": {
    "url": {
      "type": "string",
      "example": "https://example.com/femtos",
      "description": "https, port 443 or 8443, a public address"
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "description": "Your label (<= 200 characters)"
    },
    "subscriptions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "channel"
        ],
        "properties": {
          "batch": {
            "enum": [
              "block",
              "none"
            ],
            "type": "string",
            "default": "block",
            "description": "block: the events of one source block per delivery; none: one event per delivery"
          },
          "filter": {
            "anyOf": [
              {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ],
            "description": "The WebSocket filter of the channel. wallet: {address: one, a comma list or an array of up to 100 (0x or named-wallet handles), channel?: event kinds}; hc.positions: min_notional >= 10000 (default 100000)",
            "additionalProperties": true
          },
          "channel": {
            "enum": [
              "bridge.transfers",
              "elysium.bridge",
              "wallet",
              "hc.liquidations",
              "hc.positions",
              "elysium.launches",
              "hyperevm.launches"
            ],
            "type": "string"
          },
          "network": {
            "enum": [
              "mainnet",
              "testnet"
            ],
            "type": "string",
            "description": "Elysium network of the subscription: testnet for the Elysium testnet (elysium.bridge, elysium.launches, the Elysium events of wallet); absent: mainnet. Other channels are always mainnet"
          }
        },
        "description": "A channel and its filter, as on the WebSocket"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "What to deliver"
    }
  }
}

{
  "title": "Create a webhook",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Webhooks (default 50)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    }
  }
}

{
  "title": "Your webhooks",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    }
  }
}

{
  "title": "One webhook",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    },
    "url": {
      "type": "string",
      "example": "https://example.com/femtos",
      "description": "https, port 443 or 8443, a public address"
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "description": "Your label (<= 200 characters)"
    },
    "subscriptions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "channel"
        ],
        "properties": {
          "batch": {
            "enum": [
              "block",
              "none"
            ],
            "type": "string",
            "default": "block",
            "description": "block: the events of one source block per delivery; none: one event per delivery"
          },
          "filter": {
            "anyOf": [
              {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ],
            "description": "The WebSocket filter of the channel. wallet: {address: one, a comma list or an array of up to 100 (0x or named-wallet handles), channel?: event kinds}; hc.positions: min_notional >= 10000 (default 100000)",
            "additionalProperties": true
          },
          "channel": {
            "enum": [
              "bridge.transfers",
              "elysium.bridge",
              "wallet",
              "hc.liquidations",
              "hc.positions",
              "elysium.launches",
              "hyperevm.launches"
            ],
            "type": "string"
          },
          "network": {
            "enum": [
              "mainnet",
              "testnet"
            ],
            "type": "string",
            "description": "Elysium network of the subscription: testnet for the Elysium testnet (elysium.bridge, elysium.launches, the Elysium events of wallet); absent: mainnet. Other channels are always mainnet"
          }
        },
        "description": "A channel and its filter, as on the WebSocket"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "What to deliver"
    }
  }
}

{
  "title": "Change a webhook",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    }
  }
}

{
  "title": "Turn a webhook on again",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    }
  }
}

{
  "title": "Rotate a webhook secret",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    }
  }
}

{
  "title": "Delete a webhook",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    }
  }
}

{
  "title": "Test a webhook",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Deliveries (default 20)"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    },
    "status": {
      "enum": [
        "pending",
        "delivered",
        "dead"
      ],
      "type": "string",
      "description": "Only these"
    }
  }
}

{
  "title": "Webhook deliveries",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "example": "wh_3fJ9xQ2mV8kLp0aZ",
      "pattern": "^wh_[A-Za-z0-9_-]{16}$",
      "description": "Webhook id"
    },
    "msgId": {
      "type": "string",
      "pattern": "^msg_[A-Za-z0-9_-]{27}$",
      "description": "One delivery (its msgId)"
    },
    "since": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Unix ms, within the last 7 days"
    },
    "status": {
      "enum": [
        "dead",
        "all"
      ],
      "type": "string",
      "description": "dead: the dead deliveries; all: the delivered ones too (default dead)"
    }
  }
}

{
  "title": "Replay webhook deliveries",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Your account",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 400,
      "minimum": 1,
      "description": "Days back (default 30)"
    }
  }
}

{
  "title": "Your usage",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Entries (default 50)"
    },
    "usage": {
      "type": "boolean",
      "description": "Include the usage debits"
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{2,160}$",
      "description": "Next page: `next_cursor` of the previous answer"
    }
  }
}

{
  "title": "Your payments and charges",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Your USDC deposits",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Your USDC deposit address",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "usd": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Amount to add (USD): a card session for it, the credits it buys"
    }
  }
}

{
  "title": "How to add credit",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Plans and prices",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "planId"
  ],
  "properties": {
    "planId": {
      "type": "string",
      "example": "starter",
      "description": "Plan id (GET /v1/account/plans `plans.list[].id`)"
    },
    "payWith": {
      "enum": [
        "balance",
        "card"
      ],
      "type": "string",
      "description": "Default: card when cards are offered and monthly, else balance"
    },
    "interval": {
      "enum": [
        "month",
        "year"
      ],
      "type": "string",
      "description": "month (default) or year (12 months prepaid from the balance)"
    }
  }
}

{
  "title": "Subscribe to a plan",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Cancel your plan",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chain",
    "payer"
  ],
  "properties": {
    "usd": {
      "type": "number",
      "maximum": 10000,
      "minimum": 1,
      "description": "A top-up: the amount (USD)"
    },
    "chain": {
      "enum": [
        "base",
        "arbitrum",
        "hyperevm"
      ],
      "type": "string",
      "description": "Network the USDC is paid on: base, arbitrum (Arbitrum One) or hyperevm"
    },
    "payer": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The wallet that signs and pays"
    },
    "planId": {
      "type": "string",
      "example": "starter",
      "description": "A plan to buy (GET /v1/account/plans `plans.list[].id`): the quote is what the balance lacks for it"
    },
    "interval": {
      "enum": [
        "month",
        "year"
      ],
      "type": "string",
      "description": "With planId: month (default) or year"
    }
  }
}

{
  "title": "Pay from your wallet: quote",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chain",
    "authorization",
    "signature"
  ],
  "properties": {
    "usd": {
      "type": "number",
      "maximum": 10000,
      "minimum": 1,
      "description": "A top-up: the amount quoted"
    },
    "chain": {
      "enum": [
        "base",
        "arbitrum",
        "hyperevm"
      ],
      "type": "string",
      "description": "Network the USDC is paid on: base, arbitrum (Arbitrum One) or hyperevm"
    },
    "planId": {
      "type": "string",
      "example": "starter",
      "description": "A plan to buy (GET /v1/account/plans `plans.list[].id`): the quote is what the balance lacks for it"
    },
    "interval": {
      "enum": [
        "month",
        "year"
      ],
      "type": "string",
      "description": "With planId: month (default) or year"
    },
    "signature": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{130}$",
      "description": "The wallet signature of `typedData` (65 bytes, EOA)"
    },
    "authorization": {
      "type": "object",
      "description": "`typedData.message` of the quote: {from, to, value, validAfter, validBefore, nonce}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

{
  "title": "Pay from your wallet",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "capUsd"
  ],
  "properties": {
    "capUsd": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Monthly cap in USD (at most 6 decimals); null: no cap"
    }
  }
}

{
  "title": "Set your spending cap",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "management_secret": {
      "type": "string",
      "pattern": "^fms_[0-9a-f]{64}$",
      "description": "Your management secret (fms_…, answered once at signup): runs the action at once. Also read from the X-Management-Secret header. An account with an email gets a confirmation link by email instead (202)"
    }
  }
}

{
  "title": "Rotate your key",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Freeze your key",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "forfeit_balance": {
      "type": "boolean",
      "description": "Agree to lose the balance left (no refund)"
    },
    "management_secret": {
      "type": "string",
      "pattern": "^fms_[0-9a-f]{64}$",
      "description": "Your management secret (fms_…, answered once at signup): runs the action at once. Also read from the X-Management-Secret header. An account with an email gets a confirmation link by email instead (202)"
    }
  }
}

{
  "title": "Delete your account",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Get a key: challenge",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "agent_name",
    "salt",
    "nonce"
  ],
  "properties": {
    "salt": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "`salt` of GET /v1/account/signup"
    },
    "nonce": {
      "type": "string",
      "pattern": "^[0-9a-zA-Z]{1,32}$",
      "description": "1-32 characters [0-9a-zA-Z] such that SHA-256(\"<salt>:<nonce>\") starts with `difficulty` zero bits"
    },
    "agent_name": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Your agent name (1-64 printable characters, not unique)"
    },
    "owner_email": {
      "type": "string",
      "maxLength": 254,
      "description": "Its operator, for our records (never an account address, never written to)"
    }
  }
}

{
  "title": "Get a key",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet"
  ],
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The wallet that paid with x402"
    }
  }
}

{
  "title": "Recover an x402 account: message",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet",
    "nonce",
    "signature"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "`nonce` of step 1"
    },
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The wallet that paid with x402"
    },
    "signature": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{130}$",
      "description": "personal_sign of `message` (65 bytes)"
    }
  }
}

{
  "title": "Recover an x402 account",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}