Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: 'Liquid Agent: Money Tools for AI Agents Polymarket API'
version: 1.0.0
description: 'x402 money tools for AI agents: verified local business leads (6.0M businesses in 42 US states, websites proven by the business''s own phone, graded emails, buying signals, $0.03 a lead), a one-signature USDC bridge from Base to 16 chains, the live Polymarket price to beat (BTC, ETH, SOL, XRP on 5m and 15m), a tokenized US stock basket from $1, and gas paid in USDC, plus free USDC and x402 debugging tools and a remote MCP server (31 tools). No account, no API key. Part of Liquid Agent, the money layer for humans and their agents: one USDC balance for yield, payments, and tokenized stocks, for people through the app and for agents over x402. This API lets you buy and invest in tokenized US stocks on-chain from $1: NVIDIA, Apple, Meta and Alphabet. Mint your own vault holding a band-rebalanced stock basket, equal-weight or your custom portfolio, and rebalance or cash out any block. Self-priced NAV (no oracle), in-kind exit, no brokerage account, no project token. Reads are free; transactions return unsigned calldata the agent signs and broadcasts with its own gas.'
contact:
name: Liquid Agent
url: https://api.liquidagent.ai
email: liquidagentai@gmail.com
x-guidance: 'Liquid Agent is the money layer for humans and their agents: one USDC balance for yield, payments, and tokenized stocks, for people through the app and for agents over x402. This API is the agent-facing tokenized-stock index. It lets an agent mint its OWN vault holding a band-rebalanced basket of Coinbase''s tokenized NVDA/META/AAPL/GOOGL on Base (eip155:8453). Reads are FREE; every POST returns an UNSIGNED {to,data,value,chainId} that YOU sign and broadcast with your own gas (the server never signs). Amounts are USDC-6 (2000000 = $2). weightsBps are basis points summing to 10000. FLOW: 1) GET /v1/basket — discover constituents + live prices + fees. 2) GET /v1/quote?usdc=<amount6> — preview shares + mint fee. 3) POST /v1/create-vault — unsigned createVault(); sign+broadcast (you become the sole strategist, the protocol Safe owns it for fees). 4) GET /v1/balance/<your-address> — your new vault address. 5) POST /v1/set-weights {vault,weightsBps:[4]} — optional custom allocation. 6) POST /v1/buy {vault,usdc,permit:true,owner} — EIP-712 permit to sign off-chain, then re-POST with permit:{deadline,signature} for ONE unsigned depositWithPermit tx (no approve; omit permit for legacy approve+deposit). 7) POST /v1/rebalance {vault} — move to your target. 8) GET /v1/vault/<vault> — NAV + weights (self-priced TWAP, no oracle). 9) POST /v1/redeem {vault,shares,inKind?} — exit to USDC or raw tokens (un-trappable, any block). REUSE: create-vault is a ONE-TIME step. To add funds later do NOT create again — GET /v1/balance/<you>, take vaults[0].vault, and POST /v1/buy into that same vault (each buy mints more shares). create-vault always makes a brand-new separate vault. Contracts: factory 0x1B205660780CbC57849019Df2BA64B719b00AEA8, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Broadcast over any Base RPC (e.g. an x402 RPC); deposits swap precompile tokens so pass an explicit gas limit ~3,000,000.'
servers:
- url: https://api.liquidagent.ai
tags:
- name: Polymarket
paths:
/v1/polymarket/btc-5m:
get:
operationId: getV1PolymarketBtc5m
summary: 'Polymarket BTC 5m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 5m BTC window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 5m window (multiple of 300) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/btc-15m:
get:
operationId: getV1PolymarketBtc15m
summary: 'Polymarket BTC 15m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 15m BTC window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 15m window (multiple of 900) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/eth-5m:
get:
operationId: getV1PolymarketEth5m
summary: 'Polymarket ETH 5m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 5m ETH window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 5m window (multiple of 300) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/eth-15m:
get:
operationId: getV1PolymarketEth15m
summary: 'Polymarket ETH 15m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 15m ETH window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 15m window (multiple of 900) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/sol-5m:
get:
operationId: getV1PolymarketSol5m
summary: 'Polymarket SOL 5m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 5m SOL window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 5m window (multiple of 300) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/sol-15m:
get:
operationId: getV1PolymarketSol15m
summary: 'Polymarket SOL 15m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 15m SOL window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 15m window (multiple of 900) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/xrp-5m:
get:
operationId: getV1PolymarketXrp5m
summary: 'Polymarket XRP 5m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 5m XRP window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 5m window (multiple of 300) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
/v1/polymarket/xrp-15m:
get:
operationId: getV1PolymarketXrp15m
summary: 'Polymarket XRP 15m Up/Down: official price to beat, live Chainlink price and…'
tags:
- Polymarket
description: 'PAID: $0.004 USDC per call via x402 (exact scheme, EIP-3009, USDC on Base eip155:8453, Polygon eip155:137 or Arc eip155:5042). Returns the OFFICIAL price to beat for the live 15m XRP window (the 60 s Chainlink TWAP before it starts, matched to every decimal against Polymarket''s published values), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market''s own prices. Polymarket''s public API only shows the price to beat after the window closes. Pass ?start= for a past window''s official settle and outcome. First call free: add ?free=1 for one live answer at no charge (one per agent). You are never charged when it cannot answer. Data, not financial advice.'
security:
- x402: []
parameters:
- name: start
in: query
required: false
schema:
type: string
pattern: ^[0-9]+$
description: Optional. Unix start of a past 15m window (multiple of 900) to get its official settle and outcome. Omit for the live window.
x-payment:
price: '0.004'
currency: USDC
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
scheme: exact
x-payment-info:
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:137
asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
- x402:
scheme: exact
network: eip155:5042
asset: '0x3600000000000000000000000000000000000000'
payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
price:
mode: fixed
currency: USD
amount: '0.004'
responses:
'200':
description: live window (or settled window with ?start=)
content:
application/json:
schema:
type: object
'402':
description: x402 payment required (returns the payment challenge)
content:
application/json:
schema:
type: object
components:
securitySchemes:
siwx:
type: apiKey
in: header
name: SIGN-IN-WITH-X
description: Sign-In with X wallet identity (EIP-4361). Optional; no payment.
x402:
type: http
scheme: x402
description: Pay-per-call via x402 (exact scheme, EIP-3009 USDC on Base eip155:8453 or Polygon eip155:137). Sign a USDC authorization; no account, no key held by the server.
externalDocs:
description: Open-source code examples (JavaScript/viem, Python/web3, curl) + README for the full create/buy/rebalance/exit flow.
url: https://github.com/LiquidAgent/liquidagentx402
x-provenance:
method: harvested
publisher: Liquid Agent
source: https://api.liquidagent.ai/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)