# Polymarket Liquidity API

> Real-time order book depth, spread analysis, and market efficiency scoring for Polymarket prediction markets.

## When to use this API
Use this API when you need to analyze liquidity before placing a trade on Polymarket.
- Before entering a position, check order book depth and spread
- To assess market efficiency and slippage risk
- To get structured liquidity data for trading decisions

## Endpoint
### GET /api/v1/market/{conditionId}
**Paywall**: x402 — $0.005 USDC on Base mainnet.

**Response fields**:
- spread: Bid-ask spread (lower is better)
- efficiency_score: 0-1 (higher means tighter, more efficient market)
- liquidity_usd: Total available liquidity in USD
- bids/asks: Full order book depth

## Machine-readable API spec
- OpenAPI 3.0: https://polymarket-liquidity-api.tatsu77.workers.dev/openapi.json

## Discovery
- x402 metadata: https://polymarket-liquidity-api.tatsu77.workers.dev/.well-known/x402
- llms.txt: https://polymarket-liquidity-api.tatsu77.workers.dev/llms.txt

## Related APIs
- Polymarket Scan API: https://polymarket-scan-api.tatsu77.workers.dev (full market scanner)