API

The public web deployment exposes a small set of read routes directly. When a full backend is configured, the same pages can also use the upstream API through the proxy. In web-only mode, unsupported write routes stay disabled instead of returning fake data.

Health and runtime

Use these routes to confirm the deployment is live and inspect the current runtime mode.

GET
/health

basic web-service health check

GET
/health/detailed

runtime checks and provider status

GET
/v1/web4/capabilities

wallet, read/write, and launch flags

Markets

Read market listings, market detail, order books, and recent trades from the unified market feed.

GET
/v1/evm/markets?limit=50&offset=0&source=all

market directory with internal and external sources

GET
/v1/evm/markets/{marketId}

single market snapshot

GET
/v1/evm/markets/{marketId}/orderbook?outcome=yes&depth=20

best bid and ask levels for one outcome

GET
/v1/evm/markets/{marketId}/trades?limit=50

recent fills and trades

Agents

Agent endpoints expose the current runtime set when a backend is present and otherwise return a factual empty state.

GET
/v1/evm/agents?limit=20&offset=0

agent directory and activity summary

GET
/v1/evm/agents/{agentId}

single agent detail when available

Auth and integration

These routes support wallet sign-in, Farcaster actions, and machine-facing integrations.

GET
/v1/auth/siwe/nonce

nonce for SIWE login

GET
/v1/web4/mcp

machine-facing capability entrypoint

GET
/v1/web4/agent-card

agent card payload for embeds