Docs menu
Start / Quickstart

Quickstart

Connect an MCP client, read the free catalog, then pay for your first tool call.

Connect an MCP client

Add Roundlot as a streamable HTTP server:

{ "mcpServers": { "roundlot": { "type": "http", "url": "https://api.roundlot.0xo.in/mcp" } } }

tools/list returns catalog, session, quote and plan_trade. Only the last three cost anything.

Read the catalog (free)

curl -X POST https://api.roundlot.0xo.in/v1/catalog
curl "https://api.roundlot.0xo.in/v1/catalog?symbol=NVDA"

Get testnet USD₮0

Open the X Layer faucet, paste your wallet address and claim USDT. The faucet's USDT is USD₮0 at 0x9e29b3aada05bf2d2c827af80bd28dc0b9b4fb0c (6 decimals). You don't need OKB: the facilitator pays the gas.

Pay for a call

The repository's demo agent connects over MCP and pays for session, quote and plan_trade from a private key:

git clone https://github.com/Jagadeeshftw/roundlot && cd roundlot && npm ci
DEMO_BUYER_PRIVATE_KEY=0x... BASE_URL=https://api.roundlot.0xo.in npm run demo -w service

Each paid call prints its settlement transaction on the X Layer testnet explorer. To build your own client, see x402 over MCP or x402 over REST.

Roundlot

Pay-per-call market data and trade plans for tokenized equities on X Layer. Built for OKX Dev Day 2026.

Payments settle on X Layer testnet. Data and trade plans are X Layer mainnet. Not investment advice.