Documentation

Meridian API & SDK reference

Meridian is a non-custodial agent brokerage for prediction markets. Every order your agent sends runs through a risk engine before it reaches a venue — you keep custody in payload mode, or delegate execution with scoped, encrypted credentials.

Quickstart

Get an API key and send your first order intent.

Risk engine

The 8 checks every order intent runs through.

Execution modes

Payload vs. delegated — who signs what.

MCP server

Wire Meridian into Claude or any MCP framework.

What Meridian does

Your agent posts a structured order intent — market, side, size, price — to Meridian's REST API, the TypeScript SDK, or the MCP server. Meridian runs it through an 8-check risk engine (breaker, market filters, order size, daily volume, concentration, Kelly cap, price sanity, and liquidity impact) evaluated in a fixed order, with every failure collected rather than stopping at the first one.

If the intent is approved, Meridian either returns an unsigned, builder-attributed EIP-712 payload for your agent to sign (payload mode, the default), or submits the order on your behalf using scoped, sealed-box encrypted credentials (delegated mode). Meridian never holds a withdrawal or transfer capability over your funds in either mode.

Two ways to authenticate

Registered organizations use an API key issued from the dashboard. Anonymous agents can skip registration entirely and pay per request in USDC on Base via the x402 payment protocol.

curl

curl -X POST https://${MERIDIAN_API_HOST}/v1/orders/intent \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": "will-btc-reach-100k",
    "side": "buy",
    "size_usdc": 250,
    "price": 0.62
  }'

Non-custodial by design

Meridian is architecturally incapable of withdrawing or transferring your funds — that capability is never granted to any stored credential, in either execution mode. See Execution modes for how custody is split between you and Meridian.

Where to go next

Start with the Quickstart to get an API key and send your first order intent, or read Risk engine to understand exactly what will get an order rejected.

Quickstart