Liquid Agent

Liquid Agent: money tools for AI agents (x402)

x402 money tools for AI agents. Verified US local business leads at $0.03 a lead, a one-signature USDC bridge from Base to 16 chains, the live Polymarket price to beat, a tokenized US stock basket from $1, gas paid in USDC, and gift search in partner shops, plus free USDC and x402 debugging tools and a remote MCP server. No account, no API key, and the server never holds your keys.

Live API: https://api.liquidagent.ai · MCP: https://api.liquidagent.ai/mcp · Agent guide: https://api.liquidagent.ai/v1/guide · Status: https://api.liquidagent.ai/v1/status

x402 · AI agents · lead generation · local business leads · USDC bridge · CCTP · Polymarket · MCP · tokenized stocks · Base · ERC-4626 · ERC-8004 · agentic commerce · agentic shopping · no oracle · self-custodial

---

What is this?

The stock index part of Liquid Agent is an agent-native tokenized-stock index on Base. An autonomous agent (or a human) can:

• Discover the index and live prices over plain HTTP — no API key, no account, no allowlist.
• Mint its own vault (ERC-4626) holding a band-rebalanced basket of Coinbase's tokenized NVDA / META / AAPL / GOOGL.
• Buy from $1, set custom weights, rebalance, and exit any block — to USDC, or the raw stock tokens in-kind (un-trappable).

Every read is free. Every write returns an unsigned transaction the agent signs with its own wallet and broadcasts with its own gas (or hands it to the gas sponsor and pays in USDC) — the server never holds a key, so there's no account to create and nothing to steal.

Built for the agent economy: x402-discoverable, an A2A agent card, llms.txt / agents.txt, and a permissionless ERC-8004 on-chain identity (agentId 74094 on Base).

Why an agent picks this

Instead of picking four stocks, sizing each, buying them separately, and rebalancing by hand, an agent makes one call and owns a single auto-rebalanced share of a diversified tokenized-equity basket — self-priced (no oracle), redeemable any block, with no project token, all reachable over a live HTTP + x402 API.

MCP server (remote, no install)

Connect any MCP client (Claude, Cursor, ChatGPT, agent frameworks) by URL: https://api.liquidagent.ai/mcp (Streamable HTTP, no auth). Listed in the official MCP Registry as ai.liquidagent.api/liquid-agent and on Smithery.

claude mcp add --transport http liquid-agent https://api.liquidagent.ai/mcp

{ "mcpServers": { "liquid-agent": { "type": "streamable-http", "url": "https://api.liquidagent.ai/mcp" } } }

37 tools:

• Leads: leads_count (free: matches and the exact price), leads_search ($0.03 a lead), leads_lookup ($0.01: the business behind a phone number or website), leads_tech ($0.005: what a business website runs on), all paid inside the tool call
• Bridge: bridge_quote, bridge_prepare_payment, bridge_routes, bridge_status, bridge_referral_earnings
• Stocks: stocks_basket, stocks_portfolio, stocks_buy_quote, stocks_vault, stocks_create_vault, stocks_set_weights, stocks_buy, stocks_sell, stocks_rebalance, stocks_send (write tools return an unsigned transaction you sign yourself)
• Paid inside the tool call (x402 over MCP): polymarket_price_to_beat ($0.004), stocks_signals ($0.007), shop_search ($0.001). Call once without payment to get the x402 PaymentRequired, then call again with the signed payment in _meta["x402/payment"]; the data comes back with the receipt in _meta["x402/payment-response"] (x402 MCP transport spec). Pay on Base, Polygon or Arc.
• Paid prep (returns the HTTP 402 to pay yourself): polymarket_prepare ($0.004), stocks_signals_prepare ($0.007), stocks_publish_prepare ($0.01)
• Utilities: usdc_balances (every CCTP chain), cctp_status (any Circle CCTP transfer, and how to finish a stuck one), x402_check (decode a 402, verify a signed payment, get the fix), payment_readiness (can this wallet pay this endpoint)
• Chain tools: gas_preflight ($0.005 Base simulation), gas_batch_preflight ($0.005 + $0.002 per additional call), gas_decode ($0.003 multi-chain transaction and event-log decode), chain_logs ($0.005 per started 1,000 blocks), leads_enrich ($0.01 per input that finds a business; misses free)
• Other: gas_sponsor_info, shop_info, liquid_guide

Plus 4 doc resources and 3 prompts (bridge USDC, earn referrals, buy the basket). Free to connect. Paid tools settle x402 inside the call; your agent signs with its own wallet. The server never signs or holds funds.

Discovery (machine-readable, self-hosted)

Agent skill (OpenClaw · ClawHub · skills.sh)

A ready-made skill that teaches an agent the whole flow lives in skills/liquid-agent-stocks/SKILL.md.

clawhub install liquid-agent-stocks          # OpenClaw / ClawHub — the stock index

clawhub install liquid-gas-sponsor # OpenClaw / ClawHub — the gas sponsor (transact with USDC only, no ETH) clawhub install liquid-polymarket # OpenClaw / ClawHub: Polymarket official price to beat, live npx skills add LiquidAgent/liquidagentx402 # skills.sh (any agent that reads SKILL.md): every skill in skills/

Quickstart — create → buy → rebalance → exit

Reads are free. Writes return an unsigned {to,data,value,chainId} (or {steps:[...]}) that you sign and broadcast.

BASE=https://api.liquidagent.ai

1. Discover the index (free)

curl -s $BASE/v1/basket

2. Preview a $2 buy (free; USDC-6, so 2000000 = $2.00)

curl -s "$BASE/v1/quote?usdc=2000000"

3. Open your vault (ONE time) — returns an unsigned tx; sign + broadcast it

curl -s -X POST $BASE/v1/create-vault -H 'content-type: application/json' -d '{}'

4. Find your vault address

curl -s $BASE/v1/balance/0xYourAddress # -> vaults[0].vault

5. (optional) Set custom weights — bps summing to 10000; sign + broadcast

curl -s -X POST $BASE/v1/set-weights -H 'content-type: application/json' \ -d '{"vault":"0xYourVault","weightsBps":[4000,2000,2000,2000]}'

6. Buy in — ONE tx, no approve: get an EIP-2612 permit payload, sign it OFF-CHAIN,

then exchange the signature for a single unsigned depositWithPermit tx

curl -s -X POST $BASE/v1/buy -H 'content-type: application/json' \ -d '{"vault":"0xYourVault","usdc":"2000000","permit":true,"owner":"0xYourAddress"}'

-> {typedData} ... sign with eth_signTypedData_v4, then:

curl -s -X POST $BASE/v1/buy -H 'content-type: application/json' \ -d '{"vault":"0xYourVault","usdc":"2000000","permit":{"deadline": ,"signature":"0x..."}}'

(omit permit entirely for the legacy approve + deposit two-step)

7. Check your vault (free)

curl -s $BASE/v1/vault/0xYourVault

8. (optional) Rebalance to target — sign + broadcast

curl -s -X POST $BASE/v1/rebalance -H 'content-type: application/json' -d '{"vault":"0xYourVault"}'

9. Cash out — to USDC or raw tokens; sign + broadcast

curl -s -X POST $BASE/v1/redeem -H 'content-type: application/json' \ -d '{"vault":"0xYourVault","shares":" ","inKind":false}'

Signing: every write returns an unsigned {to,data,value,chainId}. Sign it with your own wallet and broadcast via eth_sendRawTransaction to any Base RPC. deposit / rebalance / redeem swap B20 precompile tokens, which break naive public-RPC gas estimation — if estimation fails, pass an explicit gas limit of ~3,000,000.

Runnable examples: examples/buy.js (viem) · examples/buy.py (Python) · examples/read.sh (curl).

Endpoints

Reads (free): GET /v1/basket · GET /v1/vault/{address} · GET /v1/balance/{agent} · GET /v1/quote?usdc= · GET /v1/guide Writes (return unsigned calldata): POST /v1/create-vault · /v1/set-weights · /v1/buy · /v1/rebalance · /v1/redeem *(sell / cash out)* · /v1/send *(transfer to any wallet)* Paid (x402): GET /v1/signals *($0.007 — the basket's rebalancing signal in one call)* · POST /v1/publish *($0.01 — a live, shareable portfolio page)* · POST /v1/gas *(from $0.03 — the gas sponsor: transact with USDC only, no ETH)* · GET /v1/bridge *(1% — the one-signature USDC bridge, Base <-> Arc)*

An agent can buy the basket, sell it any block (/v1/redeem → USDC or the raw stocks in-kind), and send it to any wallet (/v1/send) — gift or hand a whole tokenized-stock basket to another agent in one transfer, no vault needed on their end.

Full spec in openapi.json.

Paid: basket signals (x402)

GET /v1/signals — $0.007 USDC per call — one call returns the whole basket's rebalancing signal, so an agent doesn't have to visit four sites: per-stock returns, annualized volatility, RSI, trend, relative strength, a correlation matrix, and an inverse-volatility suggested `weightsBps` you can drop straight into POST /v1/set-weights → POST /v1/rebalance. Add `?vau