Liquid Agent

它列出的 37 个工具

“只读”和“会改数据”是服务方自己标的。带下划线的参数是必填的。

1. bridge_prepare_payment只读

   Prepare a bridge payment (x402)

   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.

   from to amount ref

2. bridge_quote只读

   Bridge quote (Base to 16 chains, Arc to Base)

   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.

   from to amount ref

3. bridge_referral_earnings只读

   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.

   address

4. bridge_routes只读

   Bridge routes

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

5. bridge_status只读

   Track a bridge

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

   burnTx from

6. cctp_status只读

   Track any Circle CCTP transfer

   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.

   txHash from

7. chain_logs只读

   Decoded EVM event logs (paid, $0.005 per 1,000 blocks)

   PAID $0.005 per started 1,000 blocks: retrieve and decode EVM event logs on Base, Polygon, Arbitrum, Optimism or Avalanche. Adaptive chunking, ordered results and raw fallback. Max 10,000 blocks, 100 logs or 1 MiB output.

   chain address topics fromBlock toBlock abi

8. gas_batch_preflight只读

   Batch Base preflight (paid, $0.005 + $0.002/call)

   PAID $0.005 + $0.002 per additional call (1-20, $0.043 maximum): one block and one settlement for a batch of Base calls. Ordered per-call success or revert, aggregate gas and indicative sponsorship estimate.

   calls

9. gas_decode只读

   Multi-chain transaction decoder (paid, $0.003)

   PAID $0.003: decode a transaction and ordered event logs with your ABI on Base, Polygon, Arbitrum, Optimism or Avalanche. Unknown selectors/events retain raw data with decoded:false. Provider failures are not charged.

   chain txHash abi

10. gas_preflight只读

    Base transaction preflight (paid, $0.005)

    PAID $0.005: simulate an unsigned Base transaction with optional msg.sender. Returns success or a decoded revert, gas estimate and an indicative USDC sponsorship estimate. No signing or broadcast; provider failures are not charged.

    to from data value

11. gas_sponsor_info只读

    Gas sponsor (pay gas in USDC)

    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.

12. leads_count只读

    Local business leads: how many match (free)

    Free. How many local businesses match a category and place, how many have an email at each grade (A/B/C), the top cities, and the exact price of the next page. Run this before leads_search.

    category city county email zip near radiusKm minGrade website booking payments hiring limit offset sample

13. leads_enrich只读

    Bulk lead enrichment (paid, $0.01 per match)

    PAID $0.01 per input that finds a business; misses are free. Send 1-100 websites or US phone numbers. Each match includes full business details, graded email, contact, socials and website tech. One x402 settlement for the exact hit count.

    records

14. leads_lookup只读

    Business lookup: who is this phone number or website? (paid, $0.01)

    PAID over x402 inside this tool call ($0.01 USDC on Base or Arc per lookup that finds a business; no match, no charge): give a US phone number or a website and get the local business behind it: name, address, category, the best email graded A/B/C, a contact name when the email shows one, socials and buying signals. A website only matches when it carries the business's own phone number. Call once without payment to get the x402 PaymentRequired, then again with the signed payment in _meta["x402/payment"].

    phone domain

15. leads_search只读

    Local business leads with checked emails (paid, $0.03 a lead)

    PAID over x402 inside this tool call (USDC on Base or Arc, $0.03 per lead returned, flat, with or without an email; default 3 leads = $0.09; set sample=true for 3 free leads first; the PaymentRequired quotes the exact total; no leads, no charge): local businesses by category and place with a graded email (A/B/C), a contact name when the email shows one, phone, website, socials and buying signals (no website, booking tool, payment system, hiring). Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"].

    category city county email zip near radiusKm minGrade website booking payments hiring limit offset sample

16. leads_tech只读

    Website tech: what a local business site runs on (paid, $0.005)

    PAID over x402 inside this tool call ($0.005 USDC on Base or Arc per lookup that finds a verified site; no match, no charge): give a website or a US phone number and get the site platform (WordPress, Wix, Squarespace, Shopify...), online booking tool (Square Appointments, Vagaro, Calendly, Zocdoc...), payment system (Square, Toast, Clover, Stripe...), hiring and socials, read from the business's own verified website. Call once without payment to get the x402 PaymentRequired, then again with the signed payment in _meta["x402/payment"].

    phone domain

17. liquid_guide只读

    What Liquid Agent offers

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

18. payment_readiness只读

    Can this wallet pay this endpoint?

    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).

    address url method body requirement

19. polymarket_prepare只读

    Prepare a Polymarket price-to-beat call ($0.004)

    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.

    market start

20. polymarket_price_to_beat只读

    Polymarket price to beat (paid, $0.004)

    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.

    market start free

21. shop_info只读

    Partner shop: what it sells (free)

    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

22. shop_search只读

    Gift and collectible search (paid, $0.001)

    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"].

    q max limit

23. stocks_basket只读

    Tokenized stock basket

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

24. stocks_buy只读

    Buy tokenized stocks with USDC

    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.

    vault usdc owner minShares usePermit permitDeadline permitSignature

25. stocks_buy_quote只读

    Stock basket 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).

    usdc

26. stocks_create_vault只读

    Open your own stock 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.

27. stocks_portfolio只读

    Stock portfolio of an address

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

    address

28. stocks_publish_prepare只读

    Prepare a paid portfolio page ($0.01)

    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.

    vault label

29. stocks_rebalance只读

    Rebalance your vault

    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.

    vault

30. stocks_sell只读

    Sell (redeem) basket shares

    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.

    vault shares minUsdcOut inKind

31. stocks_send只读

    Send basket shares to anyone

    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.

    vault to shares

32. stocks_set_weights只读

    Set your stock allocation

    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.

    vault weightsBps

33. stocks_signals只读

    Basket signals (paid, $0.007)

    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"].

    vault

34. stocks_signals_prepare只读

    Prepare a paid signals call ($0.007)

    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.

    vault

35. stocks_vault只读

    Stock vault state

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

    address

36. usdc_balances只读

    USDC balances on every chain

    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.

    address

37. x402_check只读

    x402 debugger

    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.

    url method body requirement payment