Liquid Agent

Free. Exact price to move USDC between Base and Arc with the Liquid Bridge: what you pay, what you receive (exactly `amount`), the fee breakdown and the ETA. No payment, no wallet needed.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Chain you pay on. Omit to pick the live route to `to` (base -> arc, arc -> base).",
      "type": "string",
      "enum": [
        "base",
        "arc"
      ]
    },
    "to": {
      "type": "string",
      "enum": [
        "arc",
        "base"
      ],
      "description": "Chain you receive on."
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d{1,6})?$",
      "description": "USDC to RECEIVE on the destination, e.g. \"1\" or \"25.5\". Minimum 1."
    },
    "ref": {
      "description": "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "required": [
    "to",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Chain you pay on"
    },
    "to": {
      "type": "string",
      "description": "Chain you receive on"
    },
    "receive": {
      "type": "string",
      "description": "USDC you receive, exactly the requested amount"
    },
    "pay": {
      "type": "string",
      "description": "USDC you pay, all fees included"
    },
    "recipient": {
      "type": "string",
      "description": "Who receives: the payer's own address"
    },
    "breakdown": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Fee breakdown: Circle network fee, Liquid fee, gas"
    },
    "allInCost": {
      "type": "string",
      "description": "Total cost in USDC"
    },
    "allInPct": {
      "type": "string",
      "description": "Total cost as a percentage"
    },
    "etaSeconds": {
      "type": "number",
      "description": "Typical delivery time"
    },
    "payTo": {
      "type": "string",
      "description": "Bridge contract that receives the x402 payment"
    },
    "network": {
      "type": "string",
      "description": "x402 network of the payment (CAIP-2)"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Returns the exact x402 payment request for a bridge (network, asset, payTo contract, amount, EIP-712 domain) and the URL to call. Pay it with your own x402 client: sign one EIP-3009 authorization and repeat the GET with the PAYMENT-SIGNATURE header. You receive exactly `amount` at your own address on the destination. This tool does not pay or sign anything.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Chain you pay on. Omit to pick the live route to `to` (base -> arc, arc -> base).",
      "type": "string",
      "enum": [
        "base",
        "arc"
      ]
    },
    "to": {
      "type": "string",
      "enum": [
        "arc",
        "base"
      ],
      "description": "Chain you receive on."
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+(\\.\\d{1,6})?$",
      "description": "USDC to RECEIVE on the destination, e.g. \"1\" or \"25.5\". Minimum 1."
    },
    "ref": {
      "description": "Optional referrer address: earns 20% of Liquid's fee. Omit if you have none.",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "required": [
    "to",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to call with the PAYMENT-SIGNATURE header"
    },
    "method": {
      "type": "string",
      "description": "HTTP method"
    },
    "x402": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "The x402 payment request (accepts: scheme, network, asset, payTo, amount, EIP-712 domain)"
    },
    "quote": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "The quote behind the price"
    },
    "howToPay": {
      "type": "array",
      "items": {},
      "description": "Step-by-step signing instructions"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Every Liquid Bridge route with its live price for 1 USDC and whether it is open.

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

{
  "type": "object",
  "properties": {
    "routes": {
      "type": "array",
      "items": {},
      "description": "Each route: from, to, live price for 1 USDC, open or not"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Circle attestation and mint state for a bridge, by its burn transaction hash (returned by the bridge call).

{
  "type": "object",
  "properties": {
    "burnTx": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "Burn transaction hash from the bridge response."
    },
    "from": {
      "description": "Source chain, if known.",
      "type": "string",
      "enum": [
        "base",
        "arc"
      ]
    }
  },
  "required": [
    "burnTx"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "burnTx": {
      "type": "string",
      "description": "Burn transaction hash"
    },
    "from": {
      "type": "string",
      "description": "Source chain"
    },
    "state": {
      "type": "string",
      "description": "waiting | attested | minted | delayed"
    },
    "circleStatus": {
      "type": "string",
      "description": "Circle attestation status"
    },
    "forwardState": {
      "type": "string",
      "description": "Circle Forwarding state"
    },
    "mintTx": {
      "type": "string",
      "description": "Mint transaction on the destination, once minted"
    },
    "feeExecuted": {
      "type": "string",
      "description": "Circle fee actually charged"
    },
    "delayReason": {
      "description": "Why it is delayed, if it is",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Unclaimed Liquid Bridge referral earnings for an address on each chain, and how they are paid out. Earn by adding ref=<your address> to bridge calls: 20% of Liquid's fee.

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

{
  "type": "object",
  "properties": {
    "referrer": {
      "type": "string",
      "description": "Referrer address"
    },
    "earnings": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Unclaimed earnings per chain"
    },
    "payout": {
      "type": "string",
      "description": "How and when earnings are paid"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. The on-chain tokenized US stock index on Base (NVDA, META, AAPL, GOOGL): live prices, fees, how to buy from $1.

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

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol name"
    },
    "tagline": {
      "type": "string",
      "description": "One-line summary"
    },
    "chain": {
      "type": "string",
      "description": "Chain"
    },
    "chainId": {
      "type": "number",
      "description": "Chain id"
    },
    "usdc": {
      "type": "string",
      "description": "USDC address"
    },
    "factory": {
      "type": "string",
      "description": "Vault factory address"
    },
    "fees": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Fees"
    },
    "minDepositUsdc": {
      "type": "string",
      "description": "Minimum deposit (USDC, 6 decimals)"
    },
    "constituents": {
      "type": "array",
      "items": {},
      "description": "Stocks in the basket with live prices"
    },
    "totalVaults": {
      "type": "number",
      "description": "Vaults created"
    },
    "flow": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "How to buy and exit"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Preview buying the tokenized stock basket: shares you would get and the fee for a USDC amount (USDC 6 decimals: "2000000" = $2).

{
  "type": "object",
  "properties": {
    "usdc": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Amount in USDC-6, e.g. \"2000000\" for $2."
    }
  },
  "required": [
    "usdc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "usdcIn": {
      "type": "string",
      "description": "USDC in (6 decimals)"
    },
    "mintFeeUsdc": {
      "type": "string",
      "description": "Mint fee (6 decimals)"
    },
    "netUsdc": {
      "type": "string",
      "description": "USDC invested after the fee"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. A basket vault's value (NAV), holdings, current vs target weights and whether it needs rebalancing.

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

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "description": "Vault address"
    },
    "owner": {
      "type": "string",
      "description": "Owner"
    },
    "strategist": {
      "type": "string",
      "description": "Strategist"
    },
    "navUsdc": {
      "type": "string",
      "description": "Net asset value (USDC, 6 decimals)"
    },
    "nav": {
      "type": "number",
      "description": "NAV in dollars"
    },
    "totalSupply": {
      "type": "string",
      "description": "Shares outstanding"
    },
    "weightsBps": {
      "type": "array",
      "items": {},
      "description": "Target weights in basis points"
    },
    "constituents": {
      "type": "array",
      "items": {},
      "description": "Holdings with current weights"
    },
    "rebalanceNeeded": {
      "type": "boolean",
      "description": "True when weights drifted past the band"
    },
    "rebalanceBandBps": {
      "type": "number",
      "description": "Rebalance band"
    },
    "mintFeeBps": {
      "type": "number",
      "description": "Mint fee"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Everything an address owns in the tokenized stock basket: each vault, its shares and current USD value.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Wallet address to look up."
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "description": "Address"
    },
    "vaultCount": {
      "type": "number",
      "description": "Vaults held"
    },
    "vaults": {
      "type": "array",
      "items": {},
      "description": "Each vault: address, shares, value in USDC"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Opens your own vault for the tokenized US stock basket (NVDA, META, AAPL, GOOGL), controlled only by you. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds. After it confirms, find the vault with stocks_portfolio.

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

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Sets your vault's target allocation across the 4 stocks in basis points (sum 10000), e.g. [4000, 3000, 2000, 1000]. Default is equal weight. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your vault address."
    },
    "weightsBps": {
      "minItems": 4,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 10000
      },
      "description": "4 weights in basis points summing to 10000, in the basket's constituent order (see stocks_basket)."
    }
  },
  "required": [
    "vault",
    "weightsBps"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Invest USDC into your vault from $1 (USDC 6 decimals: "1000000" = $1). Easiest: set usePermit=true with owner, sign the returned typedData off-chain (free), then call again with permitDeadline + permitSignature to get ONE deposit transaction. Without a permit you get two transactions (approve, then deposit). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your vault address."
    },
    "usdc": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "USDC to invest, 6 decimals, minimum \"1000000\" ($1)."
    },
    "owner": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your wallet address (required with usePermit)."
    },
    "minShares": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Optional slippage floor: minimum shares to receive."
    },
    "usePermit": {
      "description": "true = return an EIP-2612 permit to sign first (no approve transaction).",
      "type": "boolean"
    },
    "permitDeadline": {
      "description": "Deadline from the permit you signed (second call).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "permitSignature": {
      "description": "Your signature of the permit typedData (second call).",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]+$"
    }
  },
  "required": [
    "vault",
    "usdc"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Cash out: redeem basket shares to USDC, or take the raw stock tokens in-kind (works any block, no vault needed, anyone holding shares can sell). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Vault whose shares you hold."
    },
    "shares": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Shares to redeem (18 decimals; see stocks_portfolio)."
    },
    "minUsdcOut": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Optional slippage floor in USDC-6."
    },
    "inKind": {
      "description": "true = receive the 4 stock tokens instead of USDC.",
      "type": "boolean"
    }
  },
  "required": [
    "vault",
    "shares"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Brings your vault back to its target weights (check stocks_vault: rebalanceNeeded). Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your vault address."
    }
  },
  "required": [
    "vault"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Transfer your tokenized stock basket shares to any wallet or another agent; they can hold, sell or forward them, no vault needed. Returns an UNSIGNED transaction {to, data, value, chainId} on Base; nothing happens until you sign it with your own wallet and broadcast it. Liquid never holds keys or funds.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Vault whose shares you hold."
    },
    "to": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Recipient address."
    },
    "shares": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Shares to send (18 decimals)."
    }
  },
  "required": [
    "vault",
    "to",
    "shares"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "number",
      "description": "Chain id (8453 = Base)"
    },
    "to": {
      "type": "string",
      "description": "Contract to call"
    },
    "data": {
      "type": "string",
      "description": "Calldata, sign and broadcast as-is"
    },
    "value": {
      "type": "string",
      "description": "Native value, always 0"
    },
    "steps": {
      "type": "array",
      "items": {},
      "description": "When two transactions are needed (approve, then deposit), sign and send them in order"
    },
    "mode": {
      "type": "string",
      "description": "permit: sign typedData first"
    },
    "typedData": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "EIP-712 permit to sign off-chain (free, no gas)"
    },
    "next": {
      "type": "string",
      "description": "What to do next"
    },
    "after": {
      "type": "string",
      "description": "What to do after it confirms"
    },
    "attribution": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "ERC-8021 builder attribution suffix info"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Returns the x402 payment request for basket signals ($0.005 USDC on Base or Polygon): rebalancing signal, momentum and suggested weights for NVDA/META/AAPL/GOOGL in one call. Pay it with your own x402 client. This tool does not pay.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Optional vault to tailor the signal to."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to call with the PAYMENT-SIGNATURE header"
    },
    "method": {
      "type": "string",
      "description": "HTTP method"
    },
    "body": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "JSON body to send, for POST"
    },
    "x402": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
    },
    "alternatives": {
      "type": "array",
      "items": {},
      "description": "Other accepted networks"
    },
    "howToPay": {
      "type": "array",
      "items": {},
      "description": "Step-by-step signing instructions"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Returns the x402 payment request for Polymarket crypto Up/Down data (BTC, ETH, SOL, XRP; 5m and 15m; $0.002 USDC on Base or Polygon): the OFFICIAL price to beat for the live 5m or 15m window (matched to the cent against Polymarket's results), the live Chainlink price and its distance from the price to beat, seconds left, token ids and market prices. Pass start (unix) for a past window's official outcome. Pay it with your own x402 client. This tool does not pay.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "enum": [
        "btc-5m",
        "btc-15m",
        "eth-5m",
        "eth-15m",
        "sol-5m",
        "sol-15m",
        "xrp-5m",
        "xrp-15m"
      ],
      "description": "Which market: <asset>-<timeframe>."
    },
    "start": {
      "description": "Optional unix start of a past window.",
      "type": "string",
      "pattern": "^\\d+$"
    }
  },
  "required": [
    "market"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to call with the PAYMENT-SIGNATURE header"
    },
    "method": {
      "type": "string",
      "description": "HTTP method"
    },
    "body": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "JSON body to send, for POST"
    },
    "x402": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
    },
    "alternatives": {
      "type": "array",
      "items": {},
      "description": "Other accepted networks"
    },
    "howToPay": {
      "type": "array",
      "items": {},
      "description": "Step-by-step signing instructions"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Returns the x402 payment request to publish a live, shareable portfolio page for a vault for 24 hours ($0.01 USDC on Base or Polygon). Pay it with your own x402 client. This tool does not pay.

{
  "type": "object",
  "properties": {
    "vault": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Vault to publish."
    },
    "label": {
      "description": "Optional page title.",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "vault"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to call with the PAYMENT-SIGNATURE header"
    },
    "method": {
      "type": "string",
      "description": "HTTP method"
    },
    "body": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "JSON body to send, for POST"
    },
    "x402": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "The x402 payment request (scheme, network, asset, payTo, amount, EIP-712 domain)"
    },
    "alternatives": {
      "type": "array",
      "items": {},
      "description": "Other accepted networks"
    },
    "howToPay": {
      "type": "array",
      "items": {},
      "description": "Step-by-step signing instructions"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. USDC balance (and native gas balance) of an address on every CCTP chain at once: Ethereum, Avalanche, OP Mainnet, Arbitrum, Base, Polygon PoS, Unichain, Linea, Sonic, World Chain, Arc. Use it before paying or bridging to see where your money is.

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

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address"
    },
    "totalUsdc": {
      "type": "string",
      "description": "USDC across all chains"
    },
    "chains": {
      "type": "array",
      "items": {},
      "description": "Per chain: USDC and native gas balance"
    },
    "hints": {
      "type": "array",
      "items": {},
      "description": "What to do next"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Status of ANY Circle CCTP v2 USDC transfer (not only Liquid's) by its burn transaction hash: attestation, whether it was minted on the destination, and exactly how to finish a stuck one (receiveMessage with the message and attestation). Chains: Ethereum, Avalanche, OP Mainnet, Arbitrum, Base, Polygon PoS, Unichain, Linea, Sonic, World Chain, Arc.

{
  "type": "object",
  "properties": {
    "txHash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "Burn transaction hash on the source chain."
    },
    "from": {
      "description": "Source chain, if known (faster).",
      "type": "string",
      "enum": [
        "ethereum",
        "avalanche",
        "optimism",
        "arbitrum",
        "base",
        "polygon",
        "unichain",
        "linea",
        "sonic",
        "worldchain",
        "arc"
      ]
    }
  },
  "required": [
    "txHash"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "txHash": {
      "type": "string",
      "description": "Burn transaction"
    },
    "found": {
      "type": "boolean",
      "description": "Circle has a message for it"
    },
    "state": {
      "type": "string",
      "description": "not_found | pending_attestation | attested | minted"
    },
    "sourceChain": {
      "type": "string",
      "description": "Source chain"
    },
    "destinationChain": {
      "type": "string",
      "description": "Destination chain"
    },
    "amountUsdc": {
      "type": "string",
      "description": "Amount burned"
    },
    "feeExecutedUsdc": {
      "type": "string",
      "description": "Circle fee charged"
    },
    "mintRecipient": {
      "type": "string",
      "description": "Who receives"
    },
    "mintTx": {
      "type": "string",
      "description": "Mint transaction when forwarded"
    },
    "forwarding": {
      "type": "boolean",
      "description": "Uses Circle Forwarding"
    },
    "nextStep": {
      "type": "string",
      "description": "What to do now"
    },
    "receiveMessage": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "When attested but not minted: contract, message and attestation to finish it yourself"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Decode any x402 payment request (from a URL, a PAYMENT-REQUIRED header or a 402 body) into plain English with warnings, and optionally verify a signed payment (PAYMENT-SIGNATURE / X-PAYMENT header) the way a facilitator would: recipient, amount, time window, EIP-712 signature against the token's real domain, nonce reuse and balance. Every failed check comes with the fix.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "The paid endpoint URL (https). It is called once, without payment, to read its 402.",
      "type": "string",
      "format": "uri"
    },
    "method": {
      "description": "HTTP method for url (default GET).",
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ]
    },
    "body": {
      "description": "JSON body for a POST url.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "requirement": {
      "description": "Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.",
      "type": "string",
      "maxLength": 20000
    },
    "payment": {
      "description": "Optional signed payment header value to verify.",
      "type": "string",
      "maxLength": 20000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "requirement": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Decoded payment request: options in plain English, warnings"
    },
    "verification": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "If a payment was given: each facilitator check, pass/fail, and the fix"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. One call to know if a wallet can pay an x402 endpoint right now: reads the endpoint's 402, checks the wallet's balance on each accepted network, and if it cannot pay, returns the cheapest fix (e.g. move USDC from the chain where it sits, with the exact bridge_quote arguments).

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The paying wallet."
    },
    "url": {
      "description": "The paid endpoint URL (https). It is called once, without payment, to read its 402.",
      "type": "string",
      "format": "uri"
    },
    "method": {
      "description": "HTTP method for url (default GET).",
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ]
    },
    "body": {
      "description": "JSON body for a POST url.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "requirement": {
      "description": "Instead of url: the PAYMENT-REQUIRED header value (base64) or the 402 JSON body.",
      "type": "string",
      "maxLength": 20000
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Payer"
    },
    "ready": {
      "type": "boolean",
      "description": "Can pay right now"
    },
    "options": {
      "type": "array",
      "items": {},
      "description": "Each payment option with balance and whether it is enough"
    },
    "fix": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Cheapest step to become able to pay"
    },
    "note": {
      "type": "string",
      "description": "Notes"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. How to send a transaction on Base, Polygon or Solana with a wallet that holds USDC but no ETH/POL/SOL: the x402-paid gas sponsor, its price rule (from $0.03) and lanes.

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

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "Service name"
    },
    "what": {
      "type": "string",
      "description": "What it does"
    },
    "price": {
      "type": "string",
      "description": "Price rule"
    },
    "enabled": {
      "type": "boolean",
      "description": "Live or not"
    },
    "endpoint": {
      "type": "string",
      "description": "Paid endpoint"
    },
    "chains": {
      "type": "array",
      "items": {},
      "description": "Supported chains"
    },
    "flow": {
      "type": "array",
      "items": {},
      "description": "Steps"
    },
    "docs": {
      "type": "string",
      "description": "Docs URL"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Free. Overview of every Liquid Agent service for agents (bridge, stocks, signals, gas sponsor), prices and where the full docs are.

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

{
  "type": "object",
  "properties": {
    "services": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Every service with price, tools and docs"
    },
    "referral": {
      "type": "string",
      "description": "How referrals earn"
    },
    "discovery": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Machine-readable discovery URLs"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}