Liquid Agent

Endpoints (15 live)

• GET /v1/signals — One call: the whole basket's rebalancing signal (returns, volatility, RSI, trend, relative strength, correlation) plus an inverse-volatility target-weight signal for NVDA/META/AAPL/GOOGL. Decide weights, then execute via the free /v1/set-weights + /v1/rebalance. Aggregated data, not investment advice. (0.007 USDC on Base)
• GET /v1/polymarket/xrp-5m — Polymarket XRP 5m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/eth-15m — Polymarket ETH 15m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/xrp-15m — Polymarket XRP 15m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• POST /v1/gas — Gas sponsorship for one ERC-4337 user operation on Base (EntryPoint v0.8). Price = max($0.03, 1.3× the op's gas cap); this is the floor — send your user operation to get the exact quote. Bodies this URL accepts: {sender, calls[, redelegate:true]} (plain wallet, EIP-7702) | {userOperation} unsigned (any EntryPoint v0.8 smart account, bring your own operation) | JSON-RPC ERC-7677. Then POST the signed operation back here; we submit it. GET this URL?docs=1 for details. Quote valid 600s. (0.03 USDC on Base)
• GET /v1/shop/mintandmarquee/search — Search Mint & Marquee for gifts and collectibles: products that match what the person wants, under their budget, with price, photo, a short description and a link to buy. Custom 3D printed collectibles and gifts: figurines, statues, keychains, bag tags and branded merch. Soccer, anime, crypto, hypebeast and ancient-art collections. (0.001 USDC on Base)
• GET /v1/polymarket/btc-5m — Polymarket BTC 5m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/sol-5m — Polymarket SOL 5m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/btc-15m — Polymarket BTC 15m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/sol-15m — Polymarket SOL 15m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• GET /v1/polymarket/eth-5m — Polymarket ETH 5m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the 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 the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice. (0.004 USDC on Base)
• POST /v1/gas/solana — Sponsor 2 instruction(s) as fee payer: 1518840 lamports (1 account creates) (0.1998 USDC on Solana)
• GET /v1/bridge — The one-signature USDC bridge for x402 agents. Bridge USDC from Base to Arc: receive exactly 1 USDC at your own address, all fees included. Add ref=<your address> to earn 20% of the fee. Routes: Base to Arc, Arbitrum, OP Mainnet, Polygon, Avalanche, Unichain, Linea, World Chain, Sonic, Monad, Sei, Ink, HyperEVM, XDC, Plume or Codex, and Arc to Base; pick one with ?to=<chain>. (1.036098 USDC on Base)
• GET /v1/gas/solana — Solana gas sponsorship: post a transaction with the sponsor as fee payer, pay the quoted USDC, get it back co-signed. This is the floor price; a real transaction gets its exact quote. (0.03 USDC on Solana)
• POST /v1/publish — Publish a live, shareable portfolio page for a vault — holdings, allocation, live prices and signals — for 24 hours. Flat $0.25 USDC; re-publish to keep it alive. Returns a viewUrl your user opens with no wallet. (0.01 USDC on Base)

MCP tools (28)

Liquid Agent https://api.liquidagent.ai/mcp

• bridge_prepare_payment — 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.
• bridge_quote — Free. Exact price to move USDC with the Liquid Bridge (Base to Arc, Arbitrum, OP, Polygon, Avalanche, Unichain, Linea, World Chain, Sonic, Monad, Sei, Ink, HyperEVM, XDC, Plume, Codex; or Arc to Base): what you pay, what you receive (exactly `amount`), the fee breakdown and the ETA. No payment, no wallet needed.
• bridge_referral_earnings — 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.
• bridge_routes — Free. Every Liquid Bridge route with its live price for 1 USDC and whether it is open.
• bridge_status — Free. Circle attestation and mint state for a bridge, by its burn transaction hash (returned by the bridge call).
• cctp_status — 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.
• gas_sponsor_info — 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.
• liquid_guide — Free. Overview of every Liquid Agent service for agents (bridge, stocks, signals, gas sponsor), prices and where the full docs are.
• payment_readiness — 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).
• polymarket_prepare — Returns the x402 payment request for Polymarket crypto Up/Down data (BTC, ETH, SOL, XRP; 5m and 15m; $0.004 USDC on Base, Polygon or Arc): 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. First call free: add ?free=1 to the URL for one live answer at no charge (one per agent). Pay it with your own x402 client. This tool does not pay.
• polymarket_price_to_beat — PAID over x402 inside this tool call ($0.004 USDC on Base, Polygon or Arc): the OFFICIAL Polymarket price to beat for the live BTC, ETH, SOL or XRP 5m/15m Up/Down window (matched to every decimal against Polymarket), the live Chainlink price and its distance, seconds left, token ids and market prices. Call it once without payment to get the x402 PaymentRequired; your x402 wallet signs it and you call again with the payment in _meta["x402/payment"]. Set free=true for one free answer per agent.
• shop_info — Free. What the Mint & Marquee partner shop sells (custom 3D printed figurines, statues, keychains, bag tags; soccer, anime, crypto collections), its product count and price range, and how to search it.
• shop_search — PAID over x402 inside this tool call ($0.001 USDC on Arc, Base or Polygon): search the Mint & Marquee partner shop for gifts and collectibles. Returns products with price, photo, a short description and a link to buy. Show the person each product with its link, then the foundWith line once. Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].
• stocks_basket — Free. The on-chain tokenized US stock index on Base (NVDA, META, AAPL, GOOGL): live prices, fees, how to buy from $1.
• stocks_buy — 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.
• stocks_buy_quote — Free. Preview buying the tokenized stock basket: shares you would get and the fee for a USDC amount (USDC 6 decimals: "2000000" = $2).
• stocks_create_vault — 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.
• stocks_portfolio — Free. Everything an address owns in the tokenized stock basket: each vault, its shares and current USD value.
• stocks_publish_prepare — 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.
• stocks_rebalance — 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.
• stocks_sell — 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.
• stocks_send — 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.
• stocks_set_weights — 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.
• stocks_signals — PAID over x402 inside this tool call ($0.007 USDC on Base, Polygon or Arc): the whole stock basket's rebalancing signal in one call (returns, volatility, RSI, trend, relative strength and inverse-volatility target weights for NVDA, META, AAPL, GOOGL). Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].
• stocks_signals_prepare — Returns the x402 payment request for basket signals ($0.007 USDC on Base, Polygon or Arc): 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.
• stocks_vault — Free. A basket vault's value (NAV), holdings, current vs target weights and whether it needs rebalancing.
• usdc_balances — 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.
• x402_check — 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.