Vectorial Data Terminal: Hyperliquid, Polymarket & yield for AI agents is an MCP server published by com.vectorialdata, hosted at terminal.vectorialdata.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 73 tools, including get_docs, list_markets, get_registration_challenge, register_agent, get_account.
Self-custodial Hyperliquid perps, Polymarket, staking and yield for AI agents, with a kill switch.
39 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The complete Agent API manual (markdown): auth, trading, limits, withdrawals, error catalog.
No parameters.
{
"name": "get_docs",
"description": "The complete Agent API manual (markdown): auth, trading, limits, withdrawals, error catalog.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Read the Agent API manual",
"readOnlyHint": true,
"openWorldHint": false
}
}Tradeable markets with live prices and the precision metadata needed to size orders (size_decimals, min_size, price rules, $10 min notional).
No parameters.
{
"name": "list_markets",
"description": "Tradeable markets with live prices and the precision metadata needed to size orders (size_decimals, min_size, price rules, $10 min notional).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List perps markets",
"readOnlyHint": true,
"openWorldHint": true
}
}Step 1 of creating an agent account: get a nonce+message to sign (EIP-191) with the agent's own EVM wallet.
| Parameter | Type | Description |
|---|---|---|
| address * | string | The agent wallet address (0x…) |
{
"name": "get_registration_challenge",
"description": "Step 1 of creating an agent account: get a nonce+message to sign (EIP-191) with the agent's own EVM wallet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "The agent wallet address (0x…)"
}
}
},
"annotations": {
"title": "Get a registration challenge",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Step 2: register with the signed challenge. Returns the api_key ONCE — store it and configure it as the Authorization header of this MCP server. New accounts start in paper mode.
| Parameter | Type | Description |
|---|---|---|
| label * | string | A name for this agent, 1–60 characters, shown on your account |
| nonce * | string | The nonce returned by get_registration_challenge |
| address * | string | Your agent wallet address (0x…): the same one you passed to get_registration_challenge |
| signature * | string | EIP-191 signature of the challenge message |
{
"name": "register_agent",
"description": "Step 2: register with the signed challenge. Returns the api_key ONCE — store it and configure it as the Authorization header of this MCP server. New accounts start in paper mode.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address",
"nonce",
"signature",
"label"
],
"properties": {
"label": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "A name for this agent, 1–60 characters, shown on your account"
},
"nonce": {
"type": "string",
"description": "The nonce returned by get_registration_challenge"
},
"address": {
"type": "string",
"description": "Your agent wallet address (0x…): the same one you passed to get_registration_challenge"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the challenge message"
}
}
},
"annotations": {
"title": "Register an agent account",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Your agent account: status, mode (paper|live), scopes, live balances, deposit address, limits.
No parameters.
{
"name": "get_account",
"description": "Your agent account: status, mode (paper|live), scopes, live balances, deposit address, limits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your account",
"readOnlyHint": true,
"openWorldHint": true
}
}Open positions (live: venue truth; paper: from your fills).
No parameters.
{
"name": "get_positions",
"description": "Open positions (live: venue truth; paper: from your fills).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get open positions",
"readOnlyHint": true,
"openWorldHint": true
}
}Your authoritative order ledger (cursor-paginated). Paper triggers appear as trigger_tp/trigger_sl rows.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, 1–200 |
| before | string | Cursor from a previous page's next_cursor |
| status | string | Filter: prepared|submitted|resting|filled|rejected|cancelled|expired |
{
"name": "list_orders",
"description": "Your authoritative order ledger (cursor-paginated). Paper triggers appear as trigger_tp/trigger_sl rows.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page size, 1–200"
},
"before": {
"type": "string",
"description": "Cursor from a previous page's next_cursor"
},
"status": {
"type": "string",
"description": "Filter: prepared|submitted|resting|filled|rejected|cancelled|expired"
}
}
},
"annotations": {
"title": "List your orders",
"readOnlyHint": true,
"openWorldHint": true
}
}Your tear-sheet: win rate, net PnL, fees, drawdown, Sharpe, equity curve — computed server-side from the authoritative ledger.
| Parameter | Type | Description |
|---|---|---|
| mode | string | Which ledger to measure: paper or live |
| window | string | Stats window: 7d, 30d, 90d or all |
{
"name": "get_metrics",
"description": "Your tear-sheet: win rate, net PnL, fees, drawdown, Sharpe, equity curve — computed server-side from the authoritative ledger.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"mode": {
"enum": [
"paper",
"live"
],
"type": "string",
"description": "Which ledger to measure: paper or live"
},
"window": {
"enum": [
"7d",
"30d",
"90d",
"all"
],
"type": "string",
"description": "Stats window: 7d, 30d, 90d or all"
}
}
},
"annotations": {
"title": "Get your performance metrics",
"readOnlyHint": true,
"openWorldHint": true
}
}Place an order. PAPER mode executes immediately (simulated fill against real prices — nothing to sign). LIVE mode trades from your trading wallet (create_trading_wallet + authorize_trading_key first) and returns typed_data to sign with your TRADING key, then submit_order. Fees: 0.25% per perps trade, the same everyone pays, settled automatically. Brackets: pass tp/sl. Sizing: explicit size, or risk-first via risk_usd+stop_price (size = risk / |entry−stop|). Min notional $10.
| Parameter | Type | Description |
|---|---|---|
| sl | number | Stop-loss trigger price in USD (optional reduce-only bracket) |
| tp | number | Take-profit trigger price in USD (optional reduce-only bracket) |
| side * | string | buy = go long (or reduce a short); sell = go short (or reduce a long) |
| size | number | Size in coins, e.g. 0.01 for BTC. Omit it to size by risk_usd + stop_price instead |
| type * | string | market = fills now at a protected price; limit = rests at limit_price |
| market * | string | Symbol, e.g. BTC |
| risk_usd | number | Risk-first sizing: dollars at risk to the stop |
| stop_price | number | Required with risk_usd; also becomes the SL |
Execute a prepared LIVE order with your trading key's signatures (one per typed_data, in order).
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order_id returned by place_order |
| signatures * | array | One 0x… EIP-712 signature per actions[i].typed_data from place_order, in order |
{
"name": "submit_order",
"description": "Execute a prepared LIVE order with your trading key's signatures (one per typed_data, in order).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"signatures"
],
"properties": {
"order_id": {
"type": "string",
"description": "The order_id returned by place_order"
},
"signatures": {
"type": "array",
"items": {
"type": "string"
},
"description": "One 0x… EIP-712 signature per actions[i].typed_data from place_order, in order"
}
}
},
"annotations": {
"title": "Execute a signed order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Close an open position (fully or size_pct). Paper executes immediately; live returns typed_data for signing.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Symbol of the open position, e.g. BTC |
| size_pct | number | Percent of the position to close; omit to close all of it |
{
"name": "close_position",
"description": "Close an open position (fully or size_pct). Paper executes immediately; live returns typed_data for signing.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Symbol of the open position, e.g. BTC"
},
"size_pct": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "Percent of the position to close; omit to close all of it"
}
}
},
"annotations": {
"title": "Close a position",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Attach post-hoc reduce-only TP/SL triggers to an open position. Paper executes immediately.
| Parameter | Type | Description |
|---|---|---|
| sl | number | Stop-loss trigger price in USD |
| tp | number | Take-profit trigger price in USD |
| market * | string | Symbol of the open position, e.g. BTC |
{
"name": "protect_position",
"description": "Attach post-hoc reduce-only TP/SL triggers to an open position. Paper executes immediately.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"market"
],
"properties": {
"sl": {
"type": "number",
"description": "Stop-loss trigger price in USD",
"exclusiveMinimum": 0
},
"tp": {
"type": "number",
"description": "Take-profit trigger price in USD",
"exclusiveMinimum": 0
},
"market": {
"type": "string",
"description": "Symbol of the open position, e.g. BTC"
}
}
},
"annotations": {
"title": "Add take-profit / stop-loss",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Cancel a resting order by ledger id. Paper executes immediately.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order_id of a resting order (see list_orders) |
{
"name": "cancel_order",
"description": "Cancel a resting order by ledger id. Paper executes immediately.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"description": "The order_id of a resting order (see list_orders)"
}
}
},
"annotations": {
"title": "Cancel a resting order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Execute a prepared intent (cancel/protect/withdraw) with the wallet's signatures.
| Parameter | Type | Description |
|---|---|---|
| intent_id * | string | The intent_id returned by close_position, protect_position, cancel_order or prepare_withdrawal |
| signatures * | array | One 0x… EIP-712 signature per actions[i].typed_data of the intent, in order |
{
"name": "submit_intent",
"description": "Execute a prepared intent (cancel/protect/withdraw) with the wallet's signatures.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"intent_id",
"signatures"
],
"properties": {
"intent_id": {
"type": "string",
"description": "The intent_id returned by close_position, protect_position, cancel_order or prepare_withdrawal"
},
"signatures": {
"type": "array",
"items": {
"type": "string"
},
"description": "One 0x… EIP-712 signature per actions[i].typed_data of the intent, in order"
}
}
},
"annotations": {
"title": "Execute a signed intent",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Log WHY you traded (your audit trail and future public track record). Pass order_id to correlate.
| Parameter | Type | Description |
|---|---|---|
| model | string | The model or strategy that made the decision (optional) |
| order_id | string | The order_id this decision belongs to, to correlate them (optional) |
| reasoning * | string | Why you traded (or didn't), in plain words; kept in your audit trail |
{
"name": "log_decision",
"description": "Log WHY you traded (your audit trail and future public track record). Pass order_id to correlate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reasoning"
],
"properties": {
"model": {
"type": "string",
"description": "The model or strategy that made the decision (optional)"
},
"order_id": {
"type": "string",
"description": "The order_id this decision belongs to, to correlate them (optional)"
},
"reasoning": {
"type": "string",
"maxLength": 20000,
"description": "Why you traded (or didn't), in plain words; kept in your audit trail"
}
}
},
"annotations": {
"title": "Log a trading decision",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Your bounded-autonomy rails (caps, allowlists, pending loosenings).
No parameters.
{
"name": "get_limits",
"description": "Your bounded-autonomy rails (caps, allowlists, pending loosenings).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your safety limits",
"readOnlyHint": true,
"openWorldHint": true
}
}Adjust rails. Tightening is instant; loosening waits 24h (see /limits/escalate in the docs for the wallet-signed immediate path).
| Parameter | Type | Description |
|---|---|---|
| asset_allowlist | any | Markets you may open, e.g. ["BTC","ETH"]; null = all. Closing is always allowed |
| max_daily_loss_usd | any | Daily realized-loss breaker in USD (UTC day); null = no cap |
| max_order_notional_usd | any | Max USD notional of a single order; null = no cap (loosening waits 24h) |
| max_position_notional_usd | any | Max total exposure in USD across perps, predictions and Earn; null = no cap |
{
"name": "update_limits",
"description": "Adjust rails. Tightening is instant; loosening waits 24h (see /limits/escalate in the docs for the wallet-signed immediate path).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"asset_allowlist": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Markets you may open, e.g. [\"BTC\",\"ETH\"]; null = all. Closing is always allowed"
},
"max_daily_loss_usd": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Daily realized-loss breaker in USD (UTC day); null = no cap"
},
"max_order_notional_usd": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Max USD notional of a single order; null = no cap (loosening waits 24h)"
},
"max_position_notional_usd": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Max total exposure in USD across perps, predictions and Earn; null = no cap"
}
}
},
"annotations": {
"title": "Update your safety limits",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Flip paper ↔ live. Fund the wallet before going live (see get_account.deposit).
| Parameter | Type | Description |
|---|---|---|
| mode * | string | paper = simulated fills, nothing to sign; live = real funds from your trading wallet |
{
"name": "set_mode",
"description": "Flip paper ↔ live. Fund the wallet before going live (see get_account.deposit).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"paper",
"live"
],
"type": "string",
"description": "paper = simulated fills, nothing to sign; live = real funds from your trading wallet"
}
}
},
"annotations": {
"title": "Switch paper / live",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Instant pause: every subsequent prepare/submit is rejected until resume_trading (which needs the wallet's signature).
No parameters.
{
"name": "kill_switch",
"description": "Instant pause: every subsequent prepare/submit is rejected until resume_trading (which needs the wallet's signature).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Pause all trading (kill switch)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Reactivate after kill_switch. Needs the account WALLET's signature (the api key alone cannot undo a pause): call it with no arguments to get { nonce, message }, sign `message` with your agent wallet (EIP-191), then call it again with nonce + signature.
| Parameter | Type | Description |
|---|---|---|
| nonce | string | Second call only: the nonce returned by the first call |
| signature | string | EIP-191 signature of the challenge message, by the account wallet |
{
"name": "resume_trading",
"description": "Reactivate after kill_switch. Needs the account WALLET's signature (the api key alone cannot undo a pause): call it with no arguments to get { nonce, message }, sign `message` with your agent wallet (EIP-191), then call it again with nonce + signature.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"nonce": {
"type": "string",
"description": "Second call only: the nonce returned by the first call"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the challenge message, by the account wallet"
}
}
},
"annotations": {
"title": "Resume trading (wallet-signed)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Money-out policy: mode (disabled|autonomous|human_passkey), strict destinations, guardian link.
No parameters.
{
"name": "get_withdrawals_config",
"description": "Money-out policy: mode (disabled|autonomous|human_passkey), strict destinations, guardian link.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the withdrawal policy",
"readOnlyHint": true,
"openWorldHint": true
}
}Your withdraw intents and their approval lifecycle (human_passkey). Approved intents include signable actions.
No parameters.
{
"name": "list_pending_withdrawals",
"description": "Your withdraw intents and their approval lifecycle (human_passkey). Approved intents include signable actions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List pending withdrawals",
"readOnlyHint": true,
"openWorldHint": true
}
}Prepare a withdrawal (USDC → Arbitrum). Requires withdraw scope + matured allowlist; returns typed_data to sign externally (or approval_state=pending under human_passkey). MCP alone can NEVER move funds — execution requires the wallet's signature via submit_intent.
| Parameter | Type | Description |
|---|---|---|
| amount_usd * | number | USDC to withdraw from Hyperliquid |
| destination * | string | 0x address that receives the USDC; it must already be in your withdrawal allowlist |
{
"name": "prepare_withdrawal",
"description": "Prepare a withdrawal (USDC → Arbitrum). Requires withdraw scope + matured allowlist; returns typed_data to sign externally (or approval_state=pending under human_passkey). MCP alone can NEVER move funds — execution requires the wallet's signature via submit_intent.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"destination",
"amount_usd"
],
"properties": {
"amount_usd": {
"type": "number",
"description": "USDC to withdraw from Hyperliquid",
"exclusiveMinimum": 0
},
"destination": {
"type": "string",
"description": "0x address that receives the USDC; it must already be in your withdrawal allowlist"
}
}
},
"annotations": {
"title": "Prepare a withdrawal",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Human guardian link state (human_passkey mode).
No parameters.
{
"name": "guardian_status",
"description": "Human guardian link state (human_passkey mode).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the human guardian status",
"readOnlyHint": true,
"openWorldHint": true
}
}Mint a single-use invite (48h) for a human to become this agent's withdrawal guardian. Hand them the accept_url.
No parameters.
{
"name": "invite_guardian",
"description": "Mint a single-use invite (48h) for a human to become this agent's withdrawal guardian. Hand them the accept_url.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Invite a human guardian",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Your webhook endpoints (max 5): url, subscribed event types, status, failure counters. Also returns the full event-type catalog.
No parameters.
{
"name": "list_webhooks",
"description": "Your webhook endpoints (max 5): url, subscribed event types, status, failure counters. Also returns the full event-type catalog.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true,
"openWorldHint": true
}
}Register a webhook endpoint (public https). Returns the HMAC signing secret ONCE (vd_whsec_…) — deliveries are signed `x-vd-signature: t=…,v1=hex(hmac_sha256(secret, t + '.' + body))`, at-least-once, dedupe by event id. Omit event_types to receive everything.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Public https endpoint that accepts POSTed JSON events |
| event_types | array | Subset of the catalog from list_webhooks; omit = all |
{
"name": "create_webhook",
"description": "Register a webhook endpoint (public https). Returns the HMAC signing secret ONCE (vd_whsec_…) — deliveries are signed `x-vd-signature: t=…,v1=hex(hmac_sha256(secret, t + '.' + body))`, at-least-once, dedupe by event id. Omit event_types to receive everything.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Public https endpoint that accepts POSTed JSON events"
},
"event_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Subset of the catalog from list_webhooks; omit = all"
}
}
},
"annotations": {
"title": "Create a webhook",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}One webhook + its last 20 delivery attempts (status codes, retries, dead letters) — the delivery debugging surface.
| Parameter | Type | Description |
|---|---|---|
| webhook_id * | string | The webhook id (see list_webhooks) |
{
"name": "get_webhook",
"description": "One webhook + its last 20 delivery attempts (status codes, retries, dead letters) — the delivery debugging surface.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id (see list_webhooks)"
}
}
},
"annotations": {
"title": "Get a webhook",
"readOnlyHint": true,
"openWorldHint": true
}
}Remove a webhook endpoint (its queued deliveries are dropped).
| Parameter | Type | Description |
|---|---|---|
| webhook_id * | string | The webhook id to delete (see list_webhooks) |
{
"name": "delete_webhook",
"description": "Remove a webhook endpoint (its queued deliveries are dropped).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id to delete (see list_webhooks)"
}
}
},
"annotations": {
"title": "Delete a webhook",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Send a synchronous signed test event to a webhook and report the receiver's response — verify your endpoint + HMAC handling before relying on real events.
| Parameter | Type | Description |
|---|---|---|
| webhook_id * | string | The webhook id to send a test event to (see list_webhooks) |
{
"name": "test_webhook",
"description": "Send a synchronous signed test event to a webhook and report the receiver's response — verify your endpoint + HMAC handling before relying on real events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id to send a test event to (see list_webhooks)"
}
}
},
"annotations": {
"title": "Send a test webhook event",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Strategies available to copy, with the SAME numbers a human sees, as a DAILY snapshot (UTC: the same object all day): time-weighted return net of fees (immune to the leader's deposits and withdrawals — never a return on capital), max drawdown, Sharpe, trade count and the leader's terms. Read max_drawdown_pct before ranking by return — the best return is often the one that hurt most.
No parameters.
{
"name": "list_copy_leaders",
"description": "Strategies available to copy, with the SAME numbers a human sees, as a DAILY snapshot (UTC: the same object all day): time-weighted return net of fees (immune to the leader's deposits and withdrawals — never a return on capital), max drawdown, Sharpe, trade count and the leader's terms. Read max_drawdown_pct before ranking by return — the best return is often the one that hurt most.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List strategies you can copy",
"readOnlyHint": true,
"openWorldHint": true
}
}What this agent is copying, per leader. Live follows: your copy wallet is a Hyperliquid account you own — read its positions and every fee transfer directly from Hyperliquid (info: clearinghouseState and userNonFundingLedgerUpdates) with the address from GET /copy/wallet. get_positions reads your agent wallet, not the copy wallet. A retired paper follow shows only its status (result: null, retired.code = paper_copy_retired).
No parameters.
{
"name": "get_copy_status",
"description": "What this agent is copying, per leader. Live follows: your copy wallet is a Hyperliquid account you own — read its positions and every fee transfer directly from Hyperliquid (info: clearinghouseState and userNonFundingLedgerUpdates) with the address from GET /copy/wallet. get_positions reads your agent wallet, not the copy wallet. A retired paper follow shows only its status (result: null, retired.code = paper_copy_retired).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your copy-trading status",
"readOnlyHint": true,
"openWorldHint": true
}
}Start copying a leader with real funds: mode 'live' mirrors from your copy wallet — create and fund it first with create_copy_wallet. Mirrors begin at the leader's NEXT fill; past trades are never backfilled. Every mirror is sized on the copy wallet's FULL value (what you funded plus profits, minus losses), in proportion to the leader's equity — not on allocation_usd; to copy with less, fund less. Sizing includes the $10 minimum bump, so a small copy wallet gives a risk profile that does not match the leader's. mode 'paper' returns paper_copy_retired: a leader's operations are only visible to followers with real capital. Requires the 'copy' scope.
| Parameter | Type | Description |
|---|---|---|
| mode * | string | 'live' = real funds from your copy wallet. 'paper' is retired (returns paper_copy_retired). |
| leader_id * | integer | The leader's numeric id (see list_copy_leaders) |
| allocation_usd * | number | Recorded with the follow. Mirrors size on the copy wallet's full value, not on this number (the wallet must hold the leader's minimum) |
{
"name": "follow_leader",
"description": "Start copying a leader with real funds: mode 'live' mirrors from your copy wallet — create and fund it first with create_copy_wallet. Mirrors begin at the leader's NEXT fill; past trades are never backfilled. Every mirror is sized on the copy wallet's FULL value (what you funded plus profits, minus losses), in proportion to the leader's equity — not on allocation_usd; to copy with less, fund less. Sizing includes the $10 minimum bump, so a small copy wallet gives a risk profile that does not match the leader's. mode 'paper' returns paper_copy_retired: a leader's operations are only visible to followers with real capital. Requires the 'copy' scope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"leader_id",
"allocation_usd",
"mode"
],
"properties": {
"mode": {
"enum": [
"paper",
"live"
],
"type": "string",
"description": "'live' = real funds from your copy wallet. 'paper' is retired (returns paper_copy_retired)."
},
"leader_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The leader's numeric id (see list_copy_leaders)",
"exclusiveMinimum": 0
},
"allocation_usd": {
"type": "number",
"description": "Recorded with the follow. Mirrors size on the copy wallet's full value, not on this number (the wallet must hold the leader's minimum)",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Copy a leader with real funds",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Stop copying a leader. Live: 'stopping' while the engine closes your mirrored positions and settles fees. Requires the 'copy' scope.
| Parameter | Type | Description |
|---|---|---|
| leader_id * | integer | The numeric id of the leader you stop copying (see get_copy_status) |
{
"name": "unfollow_leader",
"description": "Stop copying a leader. Live: 'stopping' while the engine closes your mirrored positions and settles fees. Requires the 'copy' scope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"leader_id"
],
"properties": {
"leader_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The numeric id of the leader you stop copying (see get_copy_status)",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Stop copying a leader",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Create the copy wallet needed for LIVE copying. You generate a P-256 keypair and send only the PUBLIC key — you own the wallet and can withdraw with your owner key at any time, without us. Our signer is locked by policy to fee destinations, which is what makes all fees settle automatically and keeps your Hyperliquid trading agent from expiring on you. Requires the 'copy' scope. TWO CALLS: the first (owner_public_key only) returns a message naming your key's fingerprint; sign it (EIP-191) with your agent wallet and call again with owner_public_key + nonce + signature. An API key alone can never bind an owner key.
| Parameter | Type | Description |
|---|---|---|
| nonce | string | Second call only: the nonce returned by the first call. |
| signature | string | Second call only: EIP-191 signature of the returned message by your agent wallet. |
| owner_public_key * | string | Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key. |
{
"name": "create_copy_wallet",
"description": "Create the copy wallet needed for LIVE copying. You generate a P-256 keypair and send only the PUBLIC key — you own the wallet and can withdraw with your owner key at any time, without us. Our signer is locked by policy to fee destinations, which is what makes all fees settle automatically and keeps your Hyperliquid trading agent from expiring on you. Requires the 'copy' scope. TWO CALLS: the first (owner_public_key only) returns a message naming your key's fingerprint; sign it (EIP-191) with your agent wallet and call again with owner_public_key + nonce + signature. An API key alone can never bind an owner key.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner_public_key"
],
"properties": {
"nonce": {
"type": "string",
"description": "Second call only: the nonce returned by the first call."
},
"signature": {
"type": "string",
"description": "Second call only: EIP-191 signature of the returned message by your agent wallet."
},
"owner_public_key": {
"type": "string",
"description": "Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key."
}
}
},
"annotations": {
"title": "Create your copy wallet",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Your trading wallet — the Hyperliquid account LIVE orders trade from: address and balances, trading key status (and when to renew it), how to fund it, fees (0.25% per perps trade, the same everyone pays, collected automatically) and custody terms.
No parameters.
{
"name": "get_trading_wallet",
"description": "Your trading wallet — the Hyperliquid account LIVE orders trade from: address and balances, trading key status (and when to renew it), how to fund it, fees (0.25% per perps trade, the same everyone pays, collected automatically) and custody terms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your trading wallet",
"readOnlyHint": true,
"openWorldHint": true
}
}Create your trading wallet (required for LIVE trading; your agent wallet must have nothing open). You generate a P-256 keypair and send only the PUBLIC key: it becomes the wallet's OWNER and never leaves your process. Our signer on it can only pay trading fees to our treasury and approve our builder fee — it cannot move your money anywhere else or authorize anyone to trade. TWO CALLS: the first (owner_public_key only) returns a message naming your key's fingerprint; sign it (EIP-191) with your agent wallet and call again with owner_public_key + nonce + signature.
| Parameter | Type | Description |
|---|---|---|
| nonce | string | Second call only: the nonce returned by the first call. |
| signature | string | Second call only: EIP-191 signature of the returned message by your agent wallet. |
| owner_public_key * | string | Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key. |
{
"name": "create_trading_wallet",
"description": "Create your trading wallet (required for LIVE trading; your agent wallet must have nothing open). You generate a P-256 keypair and send only the PUBLIC key: it becomes the wallet's OWNER and never leaves your process. Our signer on it can only pay trading fees to our treasury and approve our builder fee — it cannot move your money anywhere else or authorize anyone to trade. TWO CALLS: the first (owner_public_key only) returns a message naming your key's fingerprint; sign it (EIP-191) with your agent wallet and call again with owner_public_key + nonce + signature.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"owner_public_key"
],
"properties": {
"nonce": {
"type": "string",
"description": "Second call only: the nonce returned by the first call."
},
"signature": {
"type": "string",
"description": "Second call only: EIP-191 signature of the returned message by your agent wallet."
},
"owner_public_key": {
"type": "string",
"description": "Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key."
}
}
},
"annotations": {
"title": "Create your trading wallet",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Authorize the key that signs your LIVE orders. Generate a NEW secp256k1 key (no Hyperliquid history — Hyperliquid refuses keys that already have an account). Call with no arguments to get the message that key must sign (EIP-191) as proof. Fund the trading wallet first. Then call with trading_key_address + trading_key_proof: you get payload_b64 (the exact Privy request as canonical JSON) and a `verify` list — decode it and check every field against YOUR records (your saved privy_wallet_id, your trading key) BEFORE signing it with your OWNER P-256 key (ECDSA P-256 over SHA-256, DER, base64). Call a third time adding time + owner_signature. Valid 180 days; repeat to renew or rotate.
| Parameter | Type | Description |
|---|---|---|
| time | integer | Last call only: the `time` returned by the previous call |
| owner_signature | string | Last call only: your OWNER key's signature over payload_b64 |
| trading_key_proof | string | EIP-191 signature of trading_key_message by the trading key |
| trading_key_address | string | A NEW 0x address whose key you generated to sign orders (not your agent wallet nor the trading wallet) |
{
"name": "authorize_trading_key",
"description": "Authorize the key that signs your LIVE orders. Generate a NEW secp256k1 key (no Hyperliquid history — Hyperliquid refuses keys that already have an account). Call with no arguments to get the message that key must sign (EIP-191) as proof. Fund the trading wallet first. Then call with trading_key_address + trading_key_proof: you get payload_b64 (the exact Privy request as canonical JSON) and a `verify` list — decode it and check every field against YOUR records (your saved privy_wallet_id, your trading key) BEFORE signing it with your OWNER P-256 key (ECDSA P-256 over SHA-256, DER, base64). Call a third time adding time + owner_signature. Valid 180 days; repeat to renew or rotate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Last call only: the `time` returned by the previous call"
},
"owner_signature": {
"type": "string",
"description": "Last call only: your OWNER key's signature over payload_b64"
},
"trading_key_proof": {
"type": "string",
"description": "EIP-191 signature of trading_key_message by the trading key"
},
"trading_key_address": {
"type": "string",
"description": "A NEW 0x address whose key you generated to sign orders (not your agent wallet nor the trading wallet)"
}
}
},
"annotations": {
"title": "Authorize a trading key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Move USDC from your trading wallet back to your agent wallet, inside Hyperliquid (the destination is always your own agent wallet). Pending trading fees are collected first. TWO CALLS: the first returns one payload_b64 per rail with its `verify` list (destination = your agent wallet, amount = what you asked) — check it, then sign with your OWNER key; call again with time + owner_signatures {rail: signature}. Without an API key (e.g. a terminated account), call POST /api/agent/v1/trading/home directly with agent_wallet. To leave Hyperliquid, withdraw from your agent wallet as usual.
| Parameter | Type | Description |
|---|---|---|
| time | integer | Second call only: the `time` returned by the first call (the nonce you signed) |
| amount_usd * | number | At most 2 decimals (it is exactly what gets signed). |
| owner_signatures | object | Second call only: { sendAsset?: sig, usdSend?: sig } |
{
"name": "send_trading_funds_home",
"description": "Move USDC from your trading wallet back to your agent wallet, inside Hyperliquid (the destination is always your own agent wallet). Pending trading fees are collected first. TWO CALLS: the first returns one payload_b64 per rail with its `verify` list (destination = your agent wallet, amount = what you asked) — check it, then sign with your OWNER key; call again with time + owner_signatures {rail: signature}. Without an API key (e.g. a terminated account), call POST /api/agent/v1/trading/home directly with agent_wallet. To leave Hyperliquid, withdraw from your agent wallet as usual.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_usd"
],
"properties": {
"time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Second call only: the `time` returned by the first call (the nonce you signed)"
},
"amount_usd": {
"type": "number",
"description": "At most 2 decimals (it is exactly what gets signed).",
"exclusiveMinimum": 0
},
"owner_signatures": {
"type": "object",
"description": "Second call only: { sendAsset?: sig, usdSend?: sig }",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
}
},
"annotations": {
"title": "Send trading funds to your agent wallet",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Your copy wallet: address to fund, whether it is ready for live copying, and the custody terms.
No parameters.
{
"name": "get_copy_wallet",
"description": "Your copy wallet: address to fund, whether it is ready for live copying, and the custody terms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your copy wallet",
"readOnlyHint": true,
"openWorldHint": true
}
}Step 1 of gaining a new scope ('copy' to follow leaders, 'withdraw' to move funds). Returns a message to sign with your agent wallet. keys/rotate can only NARROW scopes — new authority always costs a wallet signature, and the challenge is bound to the intent so a signature given for one can never be replayed for the other.
| Parameter | Type | Description |
|---|---|---|
| intent * | string | enable_copy = gain the copy scope; enable_withdraw = gain the withdraw scope |
{
"name": "get_scope_challenge",
"description": "Step 1 of gaining a new scope ('copy' to follow leaders, 'withdraw' to move funds). Returns a message to sign with your agent wallet. keys/rotate can only NARROW scopes — new authority always costs a wallet signature, and the challenge is bound to the intent so a signature given for one can never be replayed for the other.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"intent"
],
"properties": {
"intent": {
"enum": [
"enable_copy",
"enable_withdraw"
],
"type": "string",
"description": "enable_copy = gain the copy scope; enable_withdraw = gain the withdraw scope"
}
}
},
"annotations": {
"title": "Get a scope challenge",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Step 2: submit the signature from get_scope_challenge and receive a NEW api key carrying the scope. Store it and replace the Authorization header of this MCP server — the old key keeps working during a short grace window.
| Parameter | Type | Description |
|---|---|---|
| nonce * | string | The nonce returned by get_scope_challenge |
| intent * | string | The same intent you passed to get_scope_challenge |
| signature * | string | EIP-191 signature of the challenge message |
{
"name": "escalate_scope",
"description": "Step 2: submit the signature from get_scope_challenge and receive a NEW api key carrying the scope. Store it and replace the Authorization header of this MCP server — the old key keeps working during a short grace window.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"nonce",
"signature",
"intent"
],
"properties": {
"nonce": {
"type": "string",
"description": "The nonce returned by get_scope_challenge"
},
"intent": {
"enum": [
"enable_copy",
"enable_withdraw"
],
"type": "string",
"description": "The same intent you passed to get_scope_challenge"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the challenge message"
}
}
},
"annotations": {
"title": "Gain a new scope (wallet-signed)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Mint a fresh api key, optionally NARROWING its scopes. Cannot add authority — use get_scope_challenge + escalate_scope for that. Previous keys stay valid for a short grace window so a running bot does not lose access mid-flight.
| Parameter | Type | Description |
|---|---|---|
| scopes | array | Subset of your current scopes. Omit to keep the same set. |
{
"name": "rotate_key",
"description": "Mint a fresh api key, optionally NARROWING its scopes. Cannot add authority — use get_scope_challenge + escalate_scope for that. Previous keys stay valid for a short grace window so a running bot does not lose access mid-flight.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scopes": {
"type": "array",
"items": {
"enum": [
"read",
"trade",
"withdraw",
"copy"
],
"type": "string"
},
"description": "Subset of your current scopes. Omit to keep the same set."
}
}
},
"annotations": {
"title": "Rotate your API key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Prediction markets you can trade now (Polymarket): events with their markets and, per outcome, the CLOB token_id you trade and its price (a probability 0–1 = USD per share; a winning share pays $1). Default: by 24h volume. Optional: query (search), event_slug (one event), tag (a Gamma tag slug, e.g. sports, politics, crypto), limit (≤50), offset.
| Parameter | Type | Description |
|---|---|---|
| tag | string | A Polymarket tag slug, e.g. sports, politics, crypto |
| limit | integer | Events per page, 1–50 |
| query | string | Free-text search, e.g. 'fed rates' or 'lakers' |
| offset | integer | How many events to skip (pagination) |
| event_slug | string | Return one event by its slug (from an earlier listing) |
{
"name": "list_prediction_markets",
"description": "Prediction markets you can trade now (Polymarket): events with their markets and, per outcome, the CLOB token_id you trade and its price (a probability 0–1 = USD per share; a winning share pays $1). Default: by 24h volume. Optional: query (search), event_slug (one event), tag (a Gamma tag slug, e.g. sports, politics, crypto), limit (≤50), offset.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"maxLength": 60,
"description": "A Polymarket tag slug, e.g. sports, politics, crypto"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Events per page, 1–50"
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Free-text search, e.g. 'fed rates' or 'lakers'"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "How many events to skip (pagination)"
},
"event_slug": {
"type": "string",
"maxLength": 200,
"description": "Return one event by its slug (from an earlier listing)"
}
}
},
"annotations": {
"title": "List prediction markets",
"readOnlyHint": true,
"openWorldHint": true
}
}Live order book of one prediction outcome (best first): best bid/ask, mid, tick size and the top levels with sizes in shares.
| Parameter | Type | Description |
|---|---|---|
| token_id * | string | The outcome's decimal CLOB token id (from list_prediction_markets) |
{
"name": "get_prediction_book",
"description": "Live order book of one prediction outcome (best first): best bid/ask, mid, tick size and the top levels with sizes in shares.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"token_id"
],
"properties": {
"token_id": {
"type": "string",
"description": "The outcome's decimal CLOB token id (from list_prediction_markets)"
}
}
},
"annotations": {
"title": "Get a prediction order book",
"readOnlyHint": true,
"openWorldHint": true
}
}Your predictions account: your deposit wallet (a Polymarket smart wallet only your agent wallet controls), activation steps, cash (pUSD = USD), WHERE TO DEPOSIT (any supported chain; lands as pUSD in minutes), anything pending and the last relayer transaction.
No parameters.
{
"name": "get_predictions_account",
"description": "Your predictions account: your deposit wallet (a Polymarket smart wallet only your agent wallet controls), activation steps, cash (pUSD = USD), WHERE TO DEPOSIT (any supported chain; lands as pUSD in minutes), anything pending and the last relayer transaction.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your predictions account",
"readOnlyHint": true,
"openWorldHint": true
}
}Enable prediction markets (once, gasless). Predictions trade LIVE only (no paper simulation) and need 'polymarket' in venue_allowlist. TWO CALLS: the first (no arguments) deploys your deposit wallet and returns actions[] — sign each typed_data (EIP-712) with your AGENT wallet, in order (ClobAuth links your Polymarket CLOB account; the approvals batch lets your wallet buy, sell and collect). Then call again with activation_id + signatures within 10 minutes. Nothing here moves money.
| Parameter | Type | Description |
|---|---|---|
| signatures | array | Second call only: one 0x… signature per action, in order |
| activation_id | string | Second call only |
{
"name": "activate_predictions",
"description": "Enable prediction markets (once, gasless). Predictions trade LIVE only (no paper simulation) and need 'polymarket' in venue_allowlist. TWO CALLS: the first (no arguments) deploys your deposit wallet and returns actions[] — sign each typed_data (EIP-712) with your AGENT wallet, in order (ClobAuth links your Polymarket CLOB account; the approvals batch lets your wallet buy, sell and collect). Then call again with activation_id + signatures within 10 minutes. Nothing here moves money.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"signatures": {
"type": "array",
"items": {
"type": "string"
},
"description": "Second call only: one 0x… signature per action, in order"
},
"activation_id": {
"type": "string",
"description": "Second call only"
}
}
},
"annotations": {
"title": "Activate prediction markets",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Buy or sell a prediction outcome with a fill-or-kill market order (fills entirely at a protected price or nothing happens). BUY: amount_usd (min $1; Polymarket's taker fee and our builder fee go on top — the same everyone pays; max_spend_usd caps the all-in spend). SELL: shares. Optional limit_price (BUY: max, SELL: min) — the house price guard still applies, the stricter wins. Returns typed_data: sign it with your AGENT wallet (EIP-712), then submit_prediction_order within 60s. Your caps (order size, account exposure, daily loss) count perps and predictions together; sells only reduce and skip them.
| Parameter | Type | Description |
|---|---|---|
| side * | string | buy = buy shares of this outcome; sell = sell shares you hold |
| shares | number | SELL only: how many shares to sell |
| token_id * | string | The outcome's CLOB token id (decimal string) from list_prediction_markets |
| amount_usd | number | BUY only: USD to spend (min $1; fees go on top) |
| limit_price | number | Optional worst price as a probability 0–1 (buy: max, sell: min); it can only tighten the house guard |
| max_spend_usd | number | BUY only: cap on the all-in spend, fees included |
| client_order_id | string | Your own id for this order (up to 64 characters) |
Execute a prepared prediction order with your agent wallet's signature over its typed_data. Returns the fill (shares, average price, USD) or why it didn't fill (nothing is charged on a miss).
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The order_id returned by place_prediction_order |
| signature * | string | 0x… EIP-712 signature by your agent wallet |
{
"name": "submit_prediction_order",
"description": "Execute a prepared prediction order with your agent wallet's signature over its typed_data. Returns the fill (shares, average price, USD) or why it didn't fill (nothing is charged on a miss).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"signature"
],
"properties": {
"order_id": {
"type": "string",
"description": "The order_id returned by place_prediction_order"
},
"signature": {
"type": "string",
"description": "0x… EIP-712 signature by your agent wallet"
}
}
},
"annotations": {
"title": "Execute a signed prediction order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Your open prediction positions (Polymarket's numbers): shares, average and current price, cost, value, P&L, and whether a resolved winner is waiting to be collected (collectable).
No parameters.
{
"name": "get_prediction_positions",
"description": "Your open prediction positions (Polymarket's numbers): shares, average and current price, cost, value, P&L, and whether a resolved winner is waiting to be collected (collectable).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get your prediction positions",
"readOnlyHint": true,
"openWorldHint": true
}
}Move predictions cash back to YOUR agent wallet as native USDC (polygon, arbitrum or base; min $2) through Polymarket's bridge — the destination is always your own agent wallet. Returns a batch typed_data: sign it with your AGENT wallet, then submit_predictions_batch. Works while paused; without an API key call POST /api/agent/v1/predictions/home directly with agent_wallet.
| Parameter | Type | Description |
|---|---|---|
| all | boolean | true = send all your predictions cash |
| to_chain | string | Chain where your agent wallet receives native USDC: polygon, arbitrum or base |
| amount_usd | number | USD of predictions cash to send (min $2) |
{
"name": "send_predictions_home",
"description": "Move predictions cash back to YOUR agent wallet as native USDC (polygon, arbitrum or base; min $2) through Polymarket's bridge — the destination is always your own agent wallet. Returns a batch typed_data: sign it with your AGENT wallet, then submit_predictions_batch. Works while paused; without an API key call POST /api/agent/v1/predictions/home directly with agent_wallet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"all": {
"type": "boolean",
"description": "true = send all your predictions cash"
},
"to_chain": {
"enum": [
"polygon",
"arbitrum",
"base"
],
"type": "string",
"description": "Chain where your agent wallet receives native USDC: polygon, arbitrum or base"
},
"amount_usd": {
"type": "number",
"description": "USD of predictions cash to send (min $2)",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare sending predictions cash home",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Collect resolved WINNING positions into your predictions cash (Polymarket usually does this automatically at resolution; use this if get_prediction_positions shows collectable: true). Optional condition_id. Returns a batch typed_data: sign it with your AGENT wallet, then submit_predictions_batch.
| Parameter | Type | Description |
|---|---|---|
| condition_id | string | Collect only this market (0x condition id); omit to collect every resolved winner |
{
"name": "collect_prediction_winnings",
"description": "Collect resolved WINNING positions into your predictions cash (Polymarket usually does this automatically at resolution; use this if get_prediction_positions shows collectable: true). Optional condition_id. Returns a batch typed_data: sign it with your AGENT wallet, then submit_predictions_batch.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"condition_id": {
"type": "string",
"description": "Collect only this market (0x condition id); omit to collect every resolved winner"
}
}
},
"annotations": {
"title": "Prepare collecting winnings",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Execute a prepared send_predictions_home or collect_prediction_winnings batch with your agent wallet's signature (gasless, via Polymarket's relayer).
| Parameter | Type | Description |
|---|---|---|
| batch_id * | string | The batch_id returned by send_predictions_home, collect_prediction_winnings or move_funds |
| signature * | string | 0x… EIP-712 signature by your agent wallet |
{
"name": "submit_predictions_batch",
"description": "Execute a prepared send_predictions_home or collect_prediction_winnings batch with your agent wallet's signature (gasless, via Polymarket's relayer).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"batch_id",
"signature"
],
"properties": {
"batch_id": {
"type": "string",
"description": "The batch_id returned by send_predictions_home, collect_prediction_winnings or move_funds"
},
"signature": {
"type": "string",
"description": "0x… EIP-712 signature by your agent wallet"
}
}
},
"annotations": {
"title": "Execute a signed predictions batch",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Earn for agents: HLP (Hyperliquid's market-making vault), HYPE staking and USDC lending — rates, fees, lockups and validators; whether you can enter (live, 'earn' in venue_allowlist, certification); your trading wallet's balances and Earn positions. Everything runs from your trading wallet (create_trading_wallet first).
No parameters.
{
"name": "get_earn",
"description": "Earn for agents: HLP (Hyperliquid's market-making vault), HYPE staking and USDC lending — rates, fees, lockups and validators; whether you can enter (live, 'earn' in venue_allowlist, certification); your trading wallet's balances and Earn positions. Everything runs from your trading wallet (create_trading_wallet first).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get Earn products and positions",
"readOnlyHint": true,
"openWorldHint": true
}
}One-time Earn eligibility certification (valid 1 year): the agent's OPERATOR certifies it is not in an excluded jurisdiction (read get_earn → certification_text first). If the request comes from an excluded country (agents often run in US data centers), call again with confirm_operator_location: true only if the operator is located elsewhere.
| Parameter | Type | Description |
|---|---|---|
| confirm_operator_location | boolean | true only if the agent's OPERATOR is outside the excluded jurisdictions although this request comes from one |
{
"name": "certify_earn",
"description": "One-time Earn eligibility certification (valid 1 year): the agent's OPERATOR certifies it is not in an excluded jurisdiction (read get_earn → certification_text first). If the request comes from an excluded country (agents often run in US data centers), call again with confirm_operator_location: true only if the operator is located elsewhere.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"confirm_operator_location": {
"type": "boolean",
"description": "true only if the agent's OPERATOR is outside the excluded jurisdictions although this request comes from one"
}
}
},
"annotations": {
"title": "Certify Earn eligibility",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Deposit USDC from your trading wallet into HLP. Entry fee 0.55% (collected after the deposit lands), min $5.03, 4-day lockup; counts toward your exposure cap. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| amount_usd * | number | USDC to put into HLP (min $5.03); the 0.55% entry fee is taken from it |
{
"name": "earn_hlp_deposit",
"description": "Deposit USDC from your trading wallet into HLP. Entry fee 0.55% (collected after the deposit lands), min $5.03, 4-day lockup; counts toward your exposure cap. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_usd"
],
"properties": {
"amount_usd": {
"type": "number",
"description": "USDC to put into HLP (min $5.03); the 0.55% entry fee is taken from it",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare an HLP deposit",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Withdraw from HLP back to your trading wallet (free; after the 4-day lockup). Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| all | boolean | true = withdraw your whole HLP position |
| amount_usd | number | USD to withdraw from HLP |
{
"name": "earn_hlp_withdraw",
"description": "Withdraw from HLP back to your trading wallet (free; after the 4-day lockup). Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"all": {
"type": "boolean",
"description": "true = withdraw your whole HLP position"
},
"amount_usd": {
"type": "number",
"description": "USD to withdraw from HLP",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare an HLP withdrawal",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Buy HYPE with USDC in your trading wallet (spot, immediate-or-cancel at up to +1% from mid; fee 0.25% in USDC; Hyperliquid's minimum order is $10). The outcome says how much HYPE arrived — stake it with stake_hype. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| amount_usd * | number | USDC to spend on HYPE (Hyperliquid's minimum spot order is $10) |
{
"name": "buy_hype",
"description": "Buy HYPE with USDC in your trading wallet (spot, immediate-or-cancel at up to +1% from mid; fee 0.25% in USDC; Hyperliquid's minimum order is $10). The outcome says how much HYPE arrived — stake it with stake_hype. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_usd"
],
"properties": {
"amount_usd": {
"type": "number",
"description": "USDC to spend on HYPE (Hyperliquid's minimum spot order is $10)",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare a HYPE purchase",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Sell spot HYPE for USDC in your trading wallet (immediate-or-cancel at no less than -1% from mid; the same spot sell fee everyone pays). Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| all | boolean | true = sell all your free spot HYPE |
| amount_hype | number | Spot HYPE to sell |
{
"name": "sell_hype",
"description": "Sell spot HYPE for USDC in your trading wallet (immediate-or-cancel at no less than -1% from mid; the same spot sell fee everyone pays). Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"all": {
"type": "boolean",
"description": "true = sell all your free spot HYPE"
},
"amount_hype": {
"type": "number",
"description": "Spot HYPE to sell",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare a HYPE sale",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Stake spot HYPE with a validator (get_earn → products.staking.validators, neutral order). Entry fee 0.25% in HYPE; rewards are paid daily on the delegation. Two owner steps: into the staking balance, then delegate. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| validator * | string | 0x validator address |
| amount_hype * | number | Spot HYPE to stake; the 0.25% entry fee is kept from it |
{
"name": "stake_hype",
"description": "Stake spot HYPE with a validator (get_earn → products.staking.validators, neutral order). Entry fee 0.25% in HYPE; rewards are paid daily on the delegation. Two owner steps: into the staking balance, then delegate. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_hype",
"validator"
],
"properties": {
"validator": {
"type": "string",
"description": "0x validator address"
},
"amount_hype": {
"type": "number",
"description": "Spot HYPE to stake; the 0.25% entry fee is kept from it",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare staking HYPE",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Delegate HYPE that is already in your staking balance (free): finishes a stake whose delegation didn't go through, or re-delegates after an undelegate. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| validator * | string | 0x address of the validator (see get_earn → products.staking.validators) |
| amount_hype * | number | HYPE already in your staking balance to delegate |
{
"name": "delegate_hype",
"description": "Delegate HYPE that is already in your staking balance (free): finishes a stake whose delegation didn't go through, or re-delegates after an undelegate. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_hype",
"validator"
],
"properties": {
"validator": {
"type": "string",
"description": "0x address of the validator (see get_earn → products.staking.validators)"
},
"amount_hype": {
"type": "number",
"description": "HYPE already in your staking balance to delegate",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare delegating HYPE",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Unstake HYPE (free): with validator, undelegate it first (a delegation is locked 1 day); then Hyperliquid's 7-day withdrawal to spot starts. Without validator, only the withdrawal of HYPE already undelegated. Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| validator | string | The validator to undelegate from; omit to only withdraw HYPE already undelegated |
| amount_hype * | number | HYPE to unstake |
{
"name": "unstake_hype",
"description": "Unstake HYPE (free): with validator, undelegate it first (a delegation is locked 1 day); then Hyperliquid's 7-day withdrawal to spot starts. Without validator, only the withdrawal of HYPE already undelegated. Works while paused. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_hype"
],
"properties": {
"validator": {
"type": "string",
"description": "The validator to undelegate from; omit to only withdraw HYPE already undelegated"
},
"amount_hype": {
"type": "number",
"description": "HYPE to unstake",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare unstaking HYPE",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Lend USDC on Base in our Earn USDC vault (Morpho, Gauntlet USDC Prime) from your trading wallet's address on Base — move USDC there first with move_funds perps → earn_usdc. No entry fee; the vault keeps 20% of the yield. Owner-signed Base transactions (gas ~1¢ in USDC): submit_operation needs owner_public_key. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| all | boolean | true = lend all your USDC on Base except what gas needs |
| amount_usd | number | USDC on Base to lend |
{
"name": "earn_usdc_deposit",
"description": "Lend USDC on Base in our Earn USDC vault (Morpho, Gauntlet USDC Prime) from your trading wallet's address on Base — move USDC there first with move_funds perps → earn_usdc. No entry fee; the vault keeps 20% of the yield. Owner-signed Base transactions (gas ~1¢ in USDC): submit_operation needs owner_public_key. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"all": {
"type": "boolean",
"description": "true = lend all your USDC on Base except what gas needs"
},
"amount_usd": {
"type": "number",
"description": "USDC on Base to lend",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare lending USDC",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Withdraw from the Earn USDC vault to your USDC on Base (free; then move_funds earn_usdc → perps to trade with it). Works while paused. submit_operation needs owner_public_key. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| all | boolean | true = withdraw your whole Earn USDC position |
| amount_usd | number | USDC to withdraw from the vault to your USDC on Base |
{
"name": "earn_usdc_withdraw",
"description": "Withdraw from the Earn USDC vault to your USDC on Base (free; then move_funds earn_usdc → perps to trade with it). Works while paused. submit_operation needs owner_public_key. Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"all": {
"type": "boolean",
"description": "true = withdraw your whole Earn USDC position"
},
"amount_usd": {
"type": "number",
"description": "USDC to withdraw from the vault to your USDC on Base",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare withdrawing lent USDC",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Move USDC between spot and perps inside your trading wallet (classic accounts only; free). Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Where the USDC goes: perps or spot |
| amount_usd * | number | USDC to move |
{
"name": "transfer_spot_perps",
"description": "Move USDC between spot and perps inside your trading wallet (classic accounts only; free). Returns operation_id + signatures_needed[]: sign EACH step with the signer it names — 'owner' = your OWNER P-256 key over payload_b64 (decode it and check every `verify` line against YOUR records first), 'trading_key' = your trading key over typed_data (EIP-712) — then submit_operation within 5 minutes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_usd",
"to"
],
"properties": {
"to": {
"enum": [
"perps",
"spot"
],
"type": "string",
"description": "Where the USDC goes: perps or spot"
},
"amount_usd": {
"type": "number",
"description": "USDC to move",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare a spot ↔ perps transfer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Move money between YOUR accounts, in any direction: perps (trading wallet on Hyperliquid), predictions (your Polymarket deposit wallet) and earn_usdc (your trading wallet's USDC on Base). No fee of ours (Circle/Polymarket bridge fees shown in the summary). Moves from perps or earn_usdc return an operation for submit_operation (from earn_usdc: owner-signed Base transactions → pass owner_public_key); moves from predictions return a predictions batch: sign it with your AGENT wallet and call submit_predictions_batch.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Account the money goes to (different from `from`) |
| all | boolean | true = move everything that can be moved |
| from * | string | Account the money leaves: perps (trading wallet), predictions (deposit wallet) or earn_usdc (trading wallet on Base) |
| amount_usd | number | USD to move |
{
"name": "move_funds",
"description": "Move money between YOUR accounts, in any direction: perps (trading wallet on Hyperliquid), predictions (your Polymarket deposit wallet) and earn_usdc (your trading wallet's USDC on Base). No fee of ours (Circle/Polymarket bridge fees shown in the summary). Moves from perps or earn_usdc return an operation for submit_operation (from earn_usdc: owner-signed Base transactions → pass owner_public_key); moves from predictions return a predictions batch: sign it with your AGENT wallet and call submit_predictions_batch.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"enum": [
"perps",
"predictions",
"earn_usdc"
],
"type": "string",
"description": "Account the money goes to (different from `from`)"
},
"all": {
"type": "boolean",
"description": "true = move everything that can be moved"
},
"from": {
"enum": [
"perps",
"predictions",
"earn_usdc"
],
"type": "string",
"description": "Account the money leaves: perps (trading wallet), predictions (deposit wallet) or earn_usdc (trading wallet on Base)"
},
"amount_usd": {
"type": "number",
"description": "USD to move",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare moving money between your accounts",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Execute a prepared Earn / move operation with your signatures, one per step and in order (owner steps: base64 P-256 signature over payload_b64; trading_key steps: 0x… EIP-712 signature). All signatures are checked before the first step runs. Returns each step's result; status 'uncertain' means check get_earn before retrying. If this call times out, the operation may still be finishing: check list_operations ('executing' = still running; don't prepare it again until it ends).
| Parameter | Type | Description |
|---|---|---|
| signatures * | array | One signature per signatures_needed step, in order: base64 P-256 for owner steps, 0x… EIP-712 for trading_key steps |
| operation_id * | string | The operation_id returned by the prepare tool |
| owner_public_key | string | Your OWNER P-256 public key (SPKI PEM or base64). Required when the operation has Base transactions; every owner signature is then checked before anything is sent. |
{
"name": "submit_operation",
"description": "Execute a prepared Earn / move operation with your signatures, one per step and in order (owner steps: base64 P-256 signature over payload_b64; trading_key steps: 0x… EIP-712 signature). All signatures are checked before the first step runs. Returns each step's result; status 'uncertain' means check get_earn before retrying. If this call times out, the operation may still be finishing: check list_operations ('executing' = still running; don't prepare it again until it ends).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"signatures"
],
"properties": {
"signatures": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "One signature per signatures_needed step, in order: base64 P-256 for owner steps, 0x… EIP-712 for trading_key steps"
},
"operation_id": {
"type": "string",
"description": "The operation_id returned by the prepare tool"
},
"owner_public_key": {
"type": "string",
"description": "Your OWNER P-256 public key (SPKI PEM or base64). Required when the operation has Base transactions; every owner signature is then checked before anything is sent."
}
}
},
"annotations": {
"title": "Execute a signed Earn / move operation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Your last Earn / move operations: what each did, step by step, and how it ended.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many recent operations, 1–50 |
{
"name": "list_operations",
"description": "Your last Earn / move operations: what each did, step by step, and how it ended.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many recent operations, 1–50"
}
}
},
"annotations": {
"title": "List your Earn / move operations",
"readOnlyHint": true,
"openWorldHint": true
}
}Connected AI apps with the 'live' permission: the person's REAL Terminal account on Hyperliquid — balance, open positions (all markets, including HIP-3) and open orders with their order_id. Read-only.
No parameters.
{
"name": "get_live_account",
"description": "Connected AI apps with the 'live' permission: the person's REAL Terminal account on Hyperliquid — balance, open positions (all markets, including HIP-3) and open orders with their order_id. Read-only.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Your Terminal account (live)",
"readOnlyHint": true,
"openWorldHint": true
}
}Connected AI apps with the 'live' permission: PROPOSE a real-money order on the person's Terminal account. Nothing is sent: the person gets a notification on their devices and approves it in the Terminal (approve_url, expires in 15 minutes), then it goes through the same path as their trade ticket, with the same fees and checks. Always give the person approve_url and wait; then call get_live_proposal. Actions: open (market — fills up to 5% from the price at approval — or limit with stop_loss, within 5% of the market if it crosses; stop_loss + take_profit go together as one bracket; leverage required), close (a fraction or all of a position), protect (stop and/or take profit on an open position), cancel (an open order by order_id from get_live_account). Your agent's limits apply (max_order_notional_usd, asset_allowlist).
| Parameter | Type | Description |
|---|---|---|
| coin * | string | Market name exactly as in list_markets or get_live_account (e.g. BTC, ETH, xyz:TSLA) |
| note | string | Why you propose it, in one or two sentences; the person sees it on the approval screen |
| side | string | open only: long or short |
| action * | string | open a position, close (part of) one, protect one with stop/take profit, or cancel an open order |
| fraction | number | close only: share of the position to close, 0–1 (default 1 = all) |
| leverage | integer | open: REQUIRED, leverage 1–100 within the market's maximum (the person sees it before approving) |
| order_id | integer |
What happened to a live proposal: pending (waiting for the person), executed (with the fill or the resting order_id), failed, rejected, cancelled, expired or uncertain (no answer in time: check get_live_account).
| Parameter | Type | Description |
|---|---|---|
| proposal_id * | string | The proposal_id returned by propose_live_order |
{
"name": "get_live_proposal",
"description": "What happened to a live proposal: pending (waiting for the person), executed (with the fill or the resting order_id), failed, rejected, cancelled, expired or uncertain (no answer in time: check get_live_account).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"proposal_id": {
"type": "string",
"description": "The proposal_id returned by propose_live_order"
}
}
},
"annotations": {
"title": "Check a live proposal",
"readOnlyHint": true,
"openWorldHint": true
}
}Your last 20 live proposals and their status.
No parameters.
{
"name": "list_live_proposals",
"description": "Your last 20 live proposals and their status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List your live proposals",
"readOnlyHint": true,
"openWorldHint": true
}
}Withdraw a live proposal that is still waiting for the person's approval.
| Parameter | Type | Description |
|---|---|---|
| proposal_id * | string | The proposal_id to withdraw |
{
"name": "cancel_live_proposal",
"description": "Withdraw a live proposal that is still waiting for the person's approval.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"proposal_id": {
"type": "string",
"description": "The proposal_id to withdraw"
}
}
},
"annotations": {
"title": "Withdraw a live proposal",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}VectorialData Terminal — non-custodial brokerage for AIs (Hyperliquid perps + Polymarket prediction markets + Earn). New accounts start in PAPER mode: a full simulation against real prices where nothing needs signing — you can trade end-to-end with these tools alone. Flow: register (or bring an api key via the Authorization header) → list_markets → place_order → get_positions / get_metrics. CONNECTED FROM AN AI APP (Claude, ChatGPT…) with a Terminal sign-in? Then your account is the person's own agent account: paper trading with the usual tools, no registration and nothing to sign. REAL MONEY works differently: with the 'live' permission you can see the person's Terminal account (get_live_account) and PROPOSE real orders on it (propose_live_order). Nothing is sent until the person approves it in the Terminal: always give them approve_url, then check get_live_proposal. You can never move, deposit or withdraw money. Deposits, prediction markets and Earn are not available to a connected app (connected_app_paper_only). After kill_switch, the person resumes at https://terminal.vectorialdata.com/agents/connections. Every order is validated against server-side safety rails (notional caps, daily-loss breaker, kill switch). LIVE mode is non-custodial: prepare tools return EIP-712 typed_data that must be signed by the agent's own wallet OUTSIDE this MCP server; nothing here can move real funds by itself. You can also COPY a human strategy: list_copy_leaders (each leader's public stats, a daily UTC snapshot) → follow_leader with mode 'live', which mirrors with real funds from a copy wallet you own (create_copy_wallet) — and unlike orders, live copy needs no signature from you: our signer is policy-locked to fee destinations. A leader's operations and open positions are only visible to followers copying with real capital, so there is no paper copy (mode 'paper' returns paper_copy_retired). PREDICTION MARKETS (Polymarket, live only): list_prediction_markets → activate_predictions (once: two signatures, gasless) → fund your deposit wallet (get_predictions_account.deposit) → place_prediction_order + submit_prediction_order → get_prediction_positions → send_predictions_home. Your deposit wallet is controlled only by your agent wallet; every order is signed by it. EARN + MOVING MONEY (live, from your trading wallet): get_earn → certify_earn (once) → earn_hlp_deposit / buy_hype + stake_hype / earn_usdc_deposit → submit_operation; exits (earn_hlp_withdraw, unstake_hype, sell_hype, earn_usdc_withdraw) work while paused. move_funds moves perps ↔ predictions ↔ earn_usdc. Every step is signed by your own keys (owner or trading key); fees are the same everyone pays. Full docs: the get_docs tool.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| limit_price |
| number |
| Limit price in USD; required when type is limit |
| reduce_only | boolean | true = this order can only reduce an existing position, never open or flip one |
| client_order_id | string | Idempotency key |
{
"name": "place_order",
"description": "Place an order. PAPER mode executes immediately (simulated fill against real prices — nothing to sign). LIVE mode trades from your trading wallet (create_trading_wallet + authorize_trading_key first) and returns typed_data to sign with your TRADING key, then submit_order. Fees: 0.25% per perps trade, the same everyone pays, settled automatically. Brackets: pass tp/sl. Sizing: explicit size, or risk-first via risk_usd+stop_price (size = risk / |entry−stop|). Min notional $10.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"market",
"side",
"type"
],
"properties": {
"sl": {
"type": "number",
"description": "Stop-loss trigger price in USD (optional reduce-only bracket)",
"exclusiveMinimum": 0
},
"tp": {
"type": "number",
"description": "Take-profit trigger price in USD (optional reduce-only bracket)",
"exclusiveMinimum": 0
},
"side": {
"enum": [
"buy",
"sell"
],
"type": "string",
"description": "buy = go long (or reduce a short); sell = go short (or reduce a long)"
},
"size": {
"type": "number",
"description": "Size in coins, e.g. 0.01 for BTC. Omit it to size by risk_usd + stop_price instead",
"exclusiveMinimum": 0
},
"type": {
"enum": [
"market",
"limit"
],
"type": "string",
"description": "market = fills now at a protected price; limit = rests at limit_price"
},
"market": {
"type": "string",
"description": "Symbol, e.g. BTC"
},
"risk_usd": {
"type": "number",
"description": "Risk-first sizing: dollars at risk to the stop",
"exclusiveMinimum": 0
},
"stop_price": {
"type": "number",
"description": "Required with risk_usd; also becomes the SL",
"exclusiveMinimum": 0
},
"limit_price": {
"type": "number",
"description": "Limit price in USD; required when type is limit",
"exclusiveMinimum": 0
},
"reduce_only": {
"type": "boolean",
"description": "true = this order can only reduce an existing position, never open or flip one"
},
"client_order_id": {
"type": "string",
"description": "Idempotency key"
}
}
},
"annotations": {
"title": "Place a perps order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "place_prediction_order",
"description": "Buy or sell a prediction outcome with a fill-or-kill market order (fills entirely at a protected price or nothing happens). BUY: amount_usd (min $1; Polymarket's taker fee and our builder fee go on top — the same everyone pays; max_spend_usd caps the all-in spend). SELL: shares. Optional limit_price (BUY: max, SELL: min) — the house price guard still applies, the stricter wins. Returns typed_data: sign it with your AGENT wallet (EIP-712), then submit_prediction_order within 60s. Your caps (order size, account exposure, daily loss) count perps and predictions together; sells only reduce and skip them.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"token_id",
"side"
],
"properties": {
"side": {
"enum": [
"buy",
"sell"
],
"type": "string",
"description": "buy = buy shares of this outcome; sell = sell shares you hold"
},
"shares": {
"type": "number",
"description": "SELL only: how many shares to sell",
"exclusiveMinimum": 0
},
"token_id": {
"type": "string",
"description": "The outcome's CLOB token id (decimal string) from list_prediction_markets"
},
"amount_usd": {
"type": "number",
"description": "BUY only: USD to spend (min $1; fees go on top)",
"exclusiveMinimum": 0
},
"limit_price": {
"type": "number",
"description": "Optional worst price as a probability 0–1 (buy: max, sell: min); it can only tighten the house guard",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0
},
"max_spend_usd": {
"type": "number",
"description": "BUY only: cap on the all-in spend, fees included",
"exclusiveMinimum": 0
},
"client_order_id": {
"type": "string",
"maxLength": 64,
"description": "Your own id for this order (up to 64 characters)"
}
}
},
"annotations": {
"title": "Prepare a prediction order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| cancel only: the order_id from get_live_account.open_orders |
| size_usd | number | open only: position size in USD (minimum $10); units are computed at approval with the price then |
| stop_loss | number | open (bracket, required for limit) or protect: stop-loss trigger price |
| order_type | string | open only: market (default) or limit (needs limit_price and stop_loss) |
| limit_price | number | open with order_type limit: the entry price |
| take_profit | number | open (together with stop_loss) or protect: take-profit trigger price |
{
"name": "propose_live_order",
"description": "Connected AI apps with the 'live' permission: PROPOSE a real-money order on the person's Terminal account. Nothing is sent: the person gets a notification on their devices and approves it in the Terminal (approve_url, expires in 15 minutes), then it goes through the same path as their trade ticket, with the same fees and checks. Always give the person approve_url and wait; then call get_live_proposal. Actions: open (market — fills up to 5% from the price at approval — or limit with stop_loss, within 5% of the market if it crosses; stop_loss + take_profit go together as one bracket; leverage required), close (a fraction or all of a position), protect (stop and/or take profit on an open position), cancel (an open order by order_id from get_live_account). Your agent's limits apply (max_order_notional_usd, asset_allowlist).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"action",
"coin"
],
"properties": {
"coin": {
"type": "string",
"description": "Market name exactly as in list_markets or get_live_account (e.g. BTC, ETH, xyz:TSLA)"
},
"note": {
"type": "string",
"maxLength": 280,
"description": "Why you propose it, in one or two sentences; the person sees it on the approval screen"
},
"side": {
"enum": [
"long",
"short"
],
"type": "string",
"description": "open only: long or short"
},
"action": {
"enum": [
"open",
"close",
"protect",
"cancel"
],
"type": "string",
"description": "open a position, close (part of) one, protect one with stop/take profit, or cancel an open order"
},
"fraction": {
"type": "number",
"description": "close only: share of the position to close, 0–1 (default 1 = all)"
},
"leverage": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "open: REQUIRED, leverage 1–100 within the market's maximum (the person sees it before approving)"
},
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "cancel only: the order_id from get_live_account.open_orders"
},
"size_usd": {
"type": "number",
"description": "open only: position size in USD (minimum $10); units are computed at approval with the price then"
},
"stop_loss": {
"type": "number",
"description": "open (bracket, required for limit) or protect: stop-loss trigger price"
},
"order_type": {
"enum": [
"market",
"limit"
],
"type": "string",
"description": "open only: market (default) or limit (needs limit_price and stop_loss)"
},
"limit_price": {
"type": "number",
"description": "open with order_type limit: the entry price"
},
"take_profit": {
"type": "number",
"description": "open (together with stop_loss) or protect: take-profit trigger price"
}
}
},
"annotations": {
"title": "Propose a real order for the person to approve",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}