--- title: "Get Polymarket market liquidity by slug" method: GET path: "/polymarket/market/slug/{slug}/liquidity" tags: ["Polymarket"] --- # Get Polymarket market liquidity by slug `GET /polymarket/market/slug/{slug}/liquidity` ## Request - Base URL: `https://api.crawlora.net/api/v1` - URL: `https://api.crawlora.net/api/v1/polymarket/market/slug/{slug}/liquidity` - Auth: API key in header `x-api-key` Returns a public market liquidity snapshot that joins market detail with public CLOB market data when token ids are available. This endpoint is not a trading endpoint and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication. ## Path parameters - `slug` string, required ## Headers - `x-api-key` string, required ## Response `200` OK - PolymarketMarketLiquidityResponseDoc - `code` integer - `data` PolymarketMarketLiquidityResponse - `clob_market` PolymarketClobMarketSummary - `accepting_order_timestamp` string: Timestamp from which the market accepts orders. - `accepting_orders` boolean: `true` when the market currently accepts orders. - `active` boolean: `true` when the market is active. - `archived` boolean: `true` when the market is archived. - `closed` boolean: `true` when the market is closed. - `condition_id` string: Condition id that identifies the market on Polymarket. - `description` string: Market description, including its resolution rules as Polymarket shows them. - `enable_order_book` boolean: `true` when the order book is enabled for the market. - `end_date` string: Date and time the market is scheduled to end (ISO 8601). - `game_start_time` string: Start time of the game the market is about (ISO 8601). Omitted when not provided. - `icon_url` string: URL of the market's icon image. - `image_url` string: URL of the market's main image. - `is_50_50_outcome` boolean: `true` when the market is flagged as resolving 50-50. - `maker_base_fee` integer: Base fee charged to makers on the market. - `market_slug` string: URL slug of the market. - `market_url` string: Link to the market on polymarket.com. - `minimum_order_size` number: Smallest order size the market accepts. - `minimum_tick_size` number: Smallest price increment the market accepts. - `neg_risk` boolean: `true` when the market is part of a negative-risk group of linked outcomes. - `neg_risk_market_id` string: Id of the negative-risk group the market belongs to. - `neg_risk_request_id` string: Request id of the negative-risk group the market belongs to. - `notifications_enabled` boolean: `true` when notifications are enabled for the market. - `question` string: Question the market asks. - `question_id` string: Id of the question the market resolves. - `rewards` PolymarketClobRewardsSummary - `max_spread` number: Maximum spread an order can have and still qualify for rewards. - `min_size` number: Minimum order size that qualifies for rewards. - `rates` PolymarketClobRewardRate[]: Daily reward rates, one item per reward asset. - `asset_address` string: Contract address of the token paid out as the reward. - `rewards_daily_rate` number: Reward amount paid per day in this asset. - `seconds_delay` integer: Delay applied to orders on the market, in seconds. - `tags` string[]: Tag labels attached to the market. - `taker_base_fee` integer: Base fee charged to takers on the market. - `tokens` PolymarketClobTokenSummary[]: Outcome tokens of the market, one item per outcome. - `outcome` string: Name of the outcome the token represents. - `price` number: Current price of the outcome token. - `token_id` string: Token id of the outcome. - `winner` boolean: `true` when this outcome won the resolved market. - `condition_id` string: Condition id of the market that was requested. - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339). - `id` string: Polymarket market id that was requested. - `market` PolymarketMarketSummary - `active` boolean: `true` when the market is active. - `best_ask` number: Lowest ask price currently offered on the market. - `best_bid` number: Highest bid price currently offered on the market. - `closed` boolean: `true` when the market is closed. - `condition_id` string: Condition id that identifies the market on Polymarket. - `end_date` string: Date and time the market is scheduled to end (ISO 8601). - `id` string: Polymarket market id. - `last_trade_price` number: Price of the most recent trade on the market. - `liquidity` number: Liquidity Polymarket reports for the market. - `outcomes` PolymarketOutcomePricePoint[]: Outcomes of the market with their current prices, one item per outcome. - `best_ask` number: Lowest ask price currently offered for the outcome. - `best_bid` number: Highest bid price currently offered for the outcome. - `last_trade_price` number: Price of the most recent trade on the outcome. - `liquidity` number: Liquidity Polymarket reports for the outcome. - `market_id` string: Polymarket id of the market the outcome belongs to. - `market_slug` string: URL slug of the market the outcome belongs to. - `outcome` string: Name of the outcome, for example `Yes`. - `price` number: Current price of the outcome. - `question` string: Question of the market the outcome belongs to. - `volume` number: Trading volume Polymarket reports for the outcome. - `question` string: Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`. - `slug` string: URL slug of the market. - `token_ids` string[]: Token ids of the market outcomes, in the same order as `outcomes`. - `url` string: Link to the market on polymarket.com. - `volume` number: Total trading volume of the market. - `volume_24h` number: Trading volume of the market over the last 24 hours. - `slug` string: URL slug of the market that was requested. - `source_urls` string[]: URLs the data was read from. - `tokens` PolymarketMarketLiquidityTokenSummary[]: Liquidity figures for each outcome token of the market. - `ask_depth` number: Total size of all ask levels in the token's order book. - `bid_depth` number: Total size of all bid levels in the token's order book. - `buy_price` number: Price quoted for buying one share of the outcome. - `clob_price` number: Outcome price taken from the order-book market data. - `gamma_price` number: Outcome price taken from the market listing. - `last_trade_price` number: Price of the most recent trade on the token. - `midpoint` number: Midpoint between the best bid and best ask for the token. - `orderbook_best_ask` number: Lowest ask price in the token's order book. - `orderbook_best_bid` number: Highest bid price in the token's order book. - `orderbook_spread` number: Best ask price minus best bid price in the token's order book. - `outcome` string: Name of the outcome the token represents, for example `Yes`. - `sell_price` number: Price quoted for selling one share of the outcome. - `spread` number: Spread Polymarket reports for the token. - `token_id` string: Token id of the outcome. Use it with the order book and price endpoints. - `msg` string ## Other responses - `400`: Bad Request - `404`: Not Found - `429`: Too Many Requests - `503`: Service Unavailable --- [API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)