Vectorial Data Terminal: Hyperliquid, Polymarket & yield for AI agents
Self-custodial Hyperliquid perps, Polymarket, staking and yield for AI agents, with a kill switch.
Should I use this
Quality & Safety
Findings (2)
- LOWin list_orders
- LOWin guardian_status
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"terminal": {
"url": "https://terminal.vectorialdata.com/api/mcp"
}
}
}Remote endpoints
https://terminal.vectorialdata.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (73)
π’get_docs
The complete Agent API manual (markdown): auth, trading, limits, withdrawals, error catalog.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_markets
Tradeable markets with live prices and the precision metadata needed to size orders (size_decimals, min_size, price rules, $10 min notional).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_registration_challenge(address)
Step 1 of creating an agent account: get a nonce+message to sign (EIP-191) with the agent's own EVM wallet.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "The agent wallet address (0xβ¦)"
}
},
"required": [
"address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}βͺregister_agent(address, nonce, signature, label)
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.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Your agent wallet address (0xβ¦): the same one you passed to get_registration_challenge"
},
"nonce": {
"type": "string",
"description": "The nonce returned by get_registration_challenge"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the challenge message"
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "A name for this agent, 1β60 characters, shown on your account"
}
},
"required": [
"address",
"nonce",
"signature",
"label"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_account
Your agent account: status, mode (paper|live), scopes, live balances, deposit address, limits.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_positions
Open positions (live: venue truth; paper: from your fills).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_orders(status, limit, before)
Your authoritative order ledger (cursor-paginated). Paper triggers appear as trigger_tp/trigger_sl rows.
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Filter: prepared|submitted|resting|filled|rejected|cancelled|expired",
"type": "string"
},
"limit": {
"description": "Page size, 1β200",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"before": {
"description": "Cursor from a previous page's next_cursor",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_metrics(window, mode)
Your tear-sheet: win rate, net PnL, fees, drawdown, Sharpe, equity curve β computed server-side from the authoritative ledger.
Input Schema
{
"type": "object",
"properties": {
"window": {
"description": "Stats window: 7d, 30d, 90d or all",
"type": "string",
"enum": [
"7d",
"30d",
"90d",
"all"
]
},
"mode": {
"description": "Which ledger to measure: paper or live",
"type": "string",
"enum": [
"paper",
"live"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄place_order(market, side, type, size, risk_usd, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Symbol, e.g. BTC"
},
"side": {
"type": "string",
"enum": [
"buy",
"sell"
],
"description": "buy = go long (or reduce a short); sell = go short (or reduce a long)"
},
"type": {
"type": "string",
"enum": [
"market",
"limit"
],
"description": "market = fills now at a protected price; limit = rests at limit_price"
},
"size": {
"description": "Size in coins, e.g. 0.01 for BTC. Omit it to size by risk_usd + stop_price instead",
"type": "number",
"exclusiveMinimum": 0
},
"risk_usd": {
"description": "Risk-first sizing: dollars at risk to the stop",
"type": "number",
"exclusiveMinimum": 0
},
"stop_price": {
"description": "Required with risk_usd; also becomes the SL",
"type": "number",
"exclusiveMinimum": 0
},
"limit_price": {
"description": "Limit price in USD; required when type is limit",
"type": "number",
"exclusiveMinimum": 0
},
"tp": {
"description": "Take-profit trigger price in USD (optional reduce-only bracket)",
"type": "number",
"exclusiveMinimum": 0
},
"sl": {
"description": "Stop-loss trigger price in USD (optional reduce-only bracket)",
"type": "number",
"exclusiveMinimum": 0
},
"reduce_only": {
"description": "true = this order can only reduce an existing position, never open or flip one",
"type": "boolean"
},
"client_order_id": {
"description": "Idempotency key",
"type": "string"
}
},
"required": [
"market",
"side",
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄submit_order(order_id, signatures)
Execute a prepared LIVE order with your trading key's signatures (one per typed_data, in order).
Input Schema
{
"type": "object",
"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"
}
},
"required": [
"order_id",
"signatures"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄close_position(market, size_pct)
Close an open position (fully or size_pct). Paper executes immediately; live returns typed_data for signing.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Symbol of the open position, e.g. BTC"
},
"size_pct": {
"description": "Percent of the position to close; omit to close all of it",
"type": "number",
"minimum": 1,
"maximum": 100
}
},
"required": [
"market"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘protect_position(market, tp, sl)
Attach post-hoc reduce-only TP/SL triggers to an open position. Paper executes immediately.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "Symbol of the open position, e.g. BTC"
},
"tp": {
"description": "Take-profit trigger price in USD",
"type": "number",
"exclusiveMinimum": 0
},
"sl": {
"description": "Stop-loss trigger price in USD",
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"market"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄cancel_order(order_id)
Cancel a resting order by ledger id. Paper executes immediately.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order_id of a resting order (see list_orders)"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄submit_intent(intent_id, signatures)
Execute a prepared intent (cancel/protect/withdraw) with the wallet's signatures.
Input Schema
{
"type": "object",
"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"
}
},
"required": [
"intent_id",
"signatures"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}βͺlog_decision(reasoning, order_id, model)
Log WHY you traded (your audit trail and future public track record). Pass order_id to correlate.
Input Schema
{
"type": "object",
"properties": {
"reasoning": {
"type": "string",
"maxLength": 20000,
"description": "Why you traded (or didn't), in plain words; kept in your audit trail"
},
"order_id": {
"description": "The order_id this decision belongs to, to correlate them (optional)",
"type": "string"
},
"model": {
"description": "The model or strategy that made the decision (optional)",
"type": "string"
}
},
"required": [
"reasoning"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_limits
Your bounded-autonomy rails (caps, allowlists, pending loosenings).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘update_limits(max_order_notional_usd, max_position_notional_usd, max_daily_loss_usd, asset_allowlist)
Adjust rails. Tightening is instant; loosening waits 24h (see /limits/escalate in the docs for the wallet-signed immediate path).
Input Schema
{
"type": "object",
"properties": {
"max_order_notional_usd": {
"description": "Max USD notional of a single order; null = no cap (loosening waits 24h)",
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"max_position_notional_usd": {
"description": "Max total exposure in USD across perps, predictions and Earn; null = no cap",
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"max_daily_loss_usd": {
"description": "Daily realized-loss breaker in USD (UTC day); null = no cap",
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"asset_allowlist": {
"description": "Markets you may open, e.g. [\"BTC\",\"ETH\"]; null = all. Closing is always allowed",
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘set_mode(mode)
Flip paper β live. Fund the wallet before going live (see get_account.deposit).
Input Schema
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"paper",
"live"
],
"description": "paper = simulated fills, nothing to sign; live = real funds from your trading wallet"
}
},
"required": [
"mode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}βͺkill_switch
Instant pause: every subsequent prepare/submit is rejected until resume_trading (which needs the wallet's signature).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’resume_trading(nonce, signature)
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.
Input Schema
{
"type": "object",
"properties": {
"nonce": {
"description": "Second call only: the nonce returned by the first call",
"type": "string"
},
"signature": {
"description": "EIP-191 signature of the challenge message, by the account wallet",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_withdrawals_config
Money-out policy: mode (disabled|autonomous|human_passkey), strict destinations, guardian link.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_pending_withdrawals
Your withdraw intents and their approval lifecycle (human_passkey). Approved intents include signable actions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘prepare_withdrawal(destination, amount_usd)
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.
Input Schema
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"description": "0x address that receives the USDC; it must already be in your withdrawal allowlist"
},
"amount_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "USDC to withdraw from Hyperliquid"
}
},
"required": [
"destination",
"amount_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’guardian_status
Human guardian link state (human_passkey mode).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}βͺinvite_guardian
Mint a single-use invite (48h) for a human to become this agent's withdrawal guardian. Hand them the accept_url.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_webhooks
Your webhook endpoints (max 5): url, subscribed event types, status, failure counters. Also returns the full event-type catalog.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘create_webhook(url, event_types)
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.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public https endpoint that accepts POSTed JSON events"
},
"event_types": {
"description": "Subset of the catalog from list_webhooks; omit = all",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_webhook(webhook_id)
One webhook + its last 20 delivery attempts (status codes, retries, dead letters) β the delivery debugging surface.
Input Schema
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id (see list_webhooks)"
}
},
"required": [
"webhook_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄delete_webhook(webhook_id)
Remove a webhook endpoint (its queued deliveries are dropped).
Input Schema
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id to delete (see list_webhooks)"
}
},
"required": [
"webhook_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘test_webhook(webhook_id)
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.
Input Schema
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook id to send a test event to (see list_webhooks)"
}
},
"required": [
"webhook_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_copy_leaders
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_copy_status
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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄follow_leader(leader_id, allocation_usd, mode)
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.
Input Schema
{
"type": "object",
"properties": {
"leader_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The leader's numeric id (see list_copy_leaders)"
},
"allocation_usd": {
"type": "number",
"exclusiveMinimum": 0,
"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)"
},
"mode": {
"type": "string",
"enum": [
"paper",
"live"
],
"description": "'live' = real funds from your copy wallet. 'paper' is retired (returns paper_copy_retired)."
}
},
"required": [
"leader_id",
"allocation_usd",
"mode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄unfollow_leader(leader_id)
Stop copying a leader. Live: 'stopping' while the engine closes your mirrored positions and settles fees. Requires the 'copy' scope.
Input Schema
{
"type": "object",
"properties": {
"leader_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The numeric id of the leader you stop copying (see get_copy_status)"
}
},
"required": [
"leader_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘create_copy_wallet(owner_public_key, nonce, signature)
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.
Input Schema
{
"type": "object",
"properties": {
"owner_public_key": {
"type": "string",
"description": "Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key."
},
"nonce": {
"description": "Second call only: the nonce returned by the first call.",
"type": "string"
},
"signature": {
"description": "Second call only: EIP-191 signature of the returned message by your agent wallet.",
"type": "string"
}
},
"required": [
"owner_public_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_trading_wallet
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘create_trading_wallet(owner_public_key, nonce, signature)
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.
Input Schema
{
"type": "object",
"properties": {
"owner_public_key": {
"type": "string",
"description": "Your P-256 PUBLIC key in SPKI form (PEM or base64). Never send the private key."
},
"nonce": {
"description": "Second call only: the nonce returned by the first call.",
"type": "string"
},
"signature": {
"description": "Second call only: EIP-191 signature of the returned message by your agent wallet.",
"type": "string"
}
},
"required": [
"owner_public_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’authorize_trading_key(trading_key_address, trading_key_proof, time, owner_signature)
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.
Input Schema
{
"type": "object",
"properties": {
"trading_key_address": {
"description": "A NEW 0x address whose key you generated to sign orders (not your agent wallet nor the trading wallet)",
"type": "string"
},
"trading_key_proof": {
"description": "EIP-191 signature of trading_key_message by the trading key",
"type": "string"
},
"time": {
"description": "Last call only: the `time` returned by the previous call",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"owner_signature": {
"description": "Last call only: your OWNER key's signature over payload_b64",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄send_trading_funds_home(amount_usd, time, owner_signatures)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "At most 2 decimals (it is exactly what gets signed)."
},
"time": {
"description": "Second call only: the `time` returned by the first call (the nonce you signed)",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"owner_signatures": {
"description": "Second call only: { sendAsset?: sig, usdSend?: sig }",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"amount_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_copy_wallet
Your copy wallet: address to fund, whether it is ready for live copying, and the custody terms.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_scope_challenge(intent)
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.
Input Schema
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"enable_copy",
"enable_withdraw"
],
"description": "enable_copy = gain the copy scope; enable_withdraw = gain the withdraw scope"
}
},
"required": [
"intent"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘escalate_scope(nonce, signature, intent)
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.
Input Schema
{
"type": "object",
"properties": {
"nonce": {
"type": "string",
"description": "The nonce returned by get_scope_challenge"
},
"signature": {
"type": "string",
"description": "EIP-191 signature of the challenge message"
},
"intent": {
"type": "string",
"enum": [
"enable_copy",
"enable_withdraw"
],
"description": "The same intent you passed to get_scope_challenge"
}
},
"required": [
"nonce",
"signature",
"intent"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘rotate_key(scopes)
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.
Input Schema
{
"type": "object",
"properties": {
"scopes": {
"description": "Subset of your current scopes. Omit to keep the same set.",
"type": "array",
"items": {
"type": "string",
"enum": [
"read",
"trade",
"withdraw",
"copy"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_prediction_markets(query, event_slug, tag, limit, offset)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free-text search, e.g. 'fed rates' or 'lakers'",
"type": "string",
"maxLength": 120
},
"event_slug": {
"description": "Return one event by its slug (from an earlier listing)",
"type": "string",
"maxLength": 200
},
"tag": {
"description": "A Polymarket tag slug, e.g. sports, politics, crypto",
"type": "string",
"maxLength": 60
},
"limit": {
"description": "Events per page, 1β50",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "How many events to skip (pagination)",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_prediction_book(token_id)
Live order book of one prediction outcome (best first): best bid/ask, mid, tick size and the top levels with sizes in shares.
Input Schema
{
"type": "object",
"properties": {
"token_id": {
"type": "string",
"description": "The outcome's decimal CLOB token id (from list_prediction_markets)"
}
},
"required": [
"token_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_predictions_account
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}βͺactivate_predictions(activation_id, signatures)
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.
Input Schema
{
"type": "object",
"properties": {
"activation_id": {
"description": "Second call only",
"type": "string"
},
"signatures": {
"description": "Second call only: one 0x⦠signature per action, in order",
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘place_prediction_order(token_id, side, amount_usd, max_spend_usd, shares, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"token_id": {
"type": "string",
"description": "The outcome's CLOB token id (decimal string) from list_prediction_markets"
},
"side": {
"type": "string",
"enum": [
"buy",
"sell"
],
"description": "buy = buy shares of this outcome; sell = sell shares you hold"
},
"amount_usd": {
"description": "BUY only: USD to spend (min $1; fees go on top)",
"type": "number",
"exclusiveMinimum": 0
},
"max_spend_usd": {
"description": "BUY only: cap on the all-in spend, fees included",
"type": "number",
"exclusiveMinimum": 0
},
"shares": {
"description": "SELL only: how many shares to sell",
"type": "number",
"exclusiveMinimum": 0
},
"limit_price": {
"description": "Optional worst price as a probability 0β1 (buy: max, sell: min); it can only tighten the house guard",
"type": "number",
"exclusiveMinimum": 0,
"exclusiveMaximum": 1
},
"client_order_id": {
"description": "Your own id for this order (up to 64 characters)",
"type": "string",
"maxLength": 64
}
},
"required": [
"token_id",
"side"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄submit_prediction_order(order_id, signature)
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).
Input Schema
{
"type": "object",
"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"
}
},
"required": [
"order_id",
"signature"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_prediction_positions
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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘send_predictions_home(amount_usd, all, to_chain)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"description": "USD of predictions cash to send (min $2)",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = send all your predictions cash",
"type": "boolean"
},
"to_chain": {
"description": "Chain where your agent wallet receives native USDC: polygon, arbitrum or base",
"type": "string",
"enum": [
"polygon",
"arbitrum",
"base"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘collect_prediction_winnings(condition_id)
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.
Input Schema
{
"type": "object",
"properties": {
"condition_id": {
"description": "Collect only this market (0x condition id); omit to collect every resolved winner",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄submit_predictions_batch(batch_id, signature)
Execute a prepared send_predictions_home or collect_prediction_winnings batch with your agent wallet's signature (gasless, via Polymarket's relayer).
Input Schema
{
"type": "object",
"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"
}
},
"required": [
"batch_id",
"signature"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_earn
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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’certify_earn(confirm_operator_location)
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.
Input Schema
{
"type": "object",
"properties": {
"confirm_operator_location": {
"description": "true only if the agent's OPERATOR is outside the excluded jurisdictions although this request comes from one",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘earn_hlp_deposit(amount_usd)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "USDC to put into HLP (min $5.03); the 0.55% entry fee is taken from it"
}
},
"required": [
"amount_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘earn_hlp_withdraw(amount_usd, all)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"description": "USD to withdraw from HLP",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = withdraw your whole HLP position",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄buy_hype(amount_usd)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "USDC to spend on HYPE (Hyperliquid's minimum spot order is $10)"
}
},
"required": [
"amount_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄sell_hype(amount_hype, all)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_hype": {
"description": "Spot HYPE to sell",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = sell all your free spot HYPE",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘stake_hype(amount_hype, validator)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_hype": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Spot HYPE to stake; the 0.25% entry fee is kept from it"
},
"validator": {
"type": "string",
"description": "0x validator address"
}
},
"required": [
"amount_hype",
"validator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘delegate_hype(amount_hype, validator)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_hype": {
"type": "number",
"exclusiveMinimum": 0,
"description": "HYPE already in your staking balance to delegate"
},
"validator": {
"type": "string",
"description": "0x address of the validator (see get_earn β products.staking.validators)"
}
},
"required": [
"amount_hype",
"validator"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘unstake_hype(amount_hype, validator)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_hype": {
"type": "number",
"exclusiveMinimum": 0,
"description": "HYPE to unstake"
},
"validator": {
"description": "The validator to undelegate from; omit to only withdraw HYPE already undelegated",
"type": "string"
}
},
"required": [
"amount_hype"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘earn_usdc_deposit(amount_usd, all)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"description": "USDC on Base to lend",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = lend all your USDC on Base except what gas needs",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘earn_usdc_withdraw(amount_usd, all)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"description": "USDC to withdraw from the vault to your USDC on Base",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = withdraw your whole Earn USDC position",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘transfer_spot_perps(amount_usd, to)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"exclusiveMinimum": 0,
"description": "USDC to move"
},
"to": {
"type": "string",
"enum": [
"perps",
"spot"
],
"description": "Where the USDC goes: perps or spot"
}
},
"required": [
"amount_usd",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘move_funds(from, to, amount_usd, all)
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.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"enum": [
"perps",
"predictions",
"earn_usdc"
],
"description": "Account the money leaves: perps (trading wallet), predictions (deposit wallet) or earn_usdc (trading wallet on Base)"
},
"to": {
"type": "string",
"enum": [
"perps",
"predictions",
"earn_usdc"
],
"description": "Account the money goes to (different from `from`)"
},
"amount_usd": {
"description": "USD to move",
"type": "number",
"exclusiveMinimum": 0
},
"all": {
"description": "true = move everything that can be moved",
"type": "boolean"
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄submit_operation(operation_id, signatures, owner_public_key)
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).
Input Schema
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"description": "The operation_id returned by the prepare tool"
},
"signatures": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
},
"description": "One signature per signatures_needed step, in order: base64 P-256 for owner steps, 0x⦠EIP-712 for trading_key steps"
},
"owner_public_key": {
"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.",
"type": "string"
}
},
"required": [
"operation_id",
"signatures"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_operations(limit)
Your last Earn / move operations: what each did, step by step, and how it ended.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "How many recent operations, 1β50",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_live_account
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄propose_live_order(action, coin, side, size_usd, order_type, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"open",
"close",
"protect",
"cancel"
],
"description": "open a position, close (part of) one, protect one with stop/take profit, or cancel an open order"
},
"coin": {
"type": "string",
"description": "Market name exactly as in list_markets or get_live_account (e.g. BTC, ETH, xyz:TSLA)"
},
"side": {
"description": "open only: long or short",
"type": "string",
"enum": [
"long",
"short"
]
},
"size_usd": {
"description": "open only: position size in USD (minimum $10); units are computed at approval with the price then",
"type": "number"
},
"order_type": {
"description": "open only: market (default) or limit (needs limit_price and stop_loss)",
"type": "string",
"enum": [
"market",
"limit"
]
},
"limit_price": {
"description": "open with order_type limit: the entry price",
"type": "number"
},
"stop_loss": {
"description": "open (bracket, required for limit) or protect: stop-loss trigger price",
"type": "number"
},
"take_profit": {
"description": "open (together with stop_loss) or protect: take-profit trigger price",
"type": "number"
},
"leverage": {
"description": "open: REQUIRED, leverage 1β100 within the market's maximum (the person sees it before approving)",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fraction": {
"description": "close only: share of the position to close, 0β1 (default 1 = all)",
"type": "number"
},
"order_id": {
"description": "cancel only: the order_id from get_live_account.open_orders",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"note": {
"description": "Why you propose it, in one or two sentences; the person sees it on the approval screen",
"type": "string",
"maxLength": 280
}
},
"required": [
"action",
"coin"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’get_live_proposal(proposal_id)
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).
Input Schema
{
"type": "object",
"properties": {
"proposal_id": {
"type": "string",
"description": "The proposal_id returned by propose_live_order"
}
},
"required": [
"proposal_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’list_live_proposals
Your last 20 live proposals and their status.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄cancel_live_proposal(proposal_id)
Withdraw a live proposal that is still waiting for the person's approval.
Input Schema
{
"type": "object",
"properties": {
"proposal_id": {
"type": "string",
"description": "The proposal_id to withdraw"
}
},
"required": [
"proposal_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence