Polymarket API endpoint
Returns the liquidity-rewards details of one Polymarket market by condition id: the question, daily reward rate, rewards minimum size and maximum spread, each reward configuration with its start and end dates and rate per day, total configured rewards, 24-hour volume and outcome token prices. A condition id with no rewards row returns `404`.
/polymarket/rewards/market/{condition_id}Path parameters:
condition_id: required Polymarket market condition id.Notable response behavior:
404 when no rewards row exists for the condition id.| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| token_id | 2 | |
| outcome | 2 | “Yes” and 1 other value |
| price | 2 | 0.03 to 0.97, median 0.03 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| condition_id (path) | string | Yes | Polymarket market condition id | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/polymarket/rewards/market/0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
"count": 1,
"market": {
"condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
"question": "Call of Duty: Paris Gentle Mates vs OpTic Texas - Game 4 Winner",
"market_slug": "codmw-par-tex-2026-06-07-game4",
"daily_reward_rate": 5,
"rewards_min_size": 500,
"rewards_max_spread": 2.5
}
}
}Request schema
No body schema
Response schema
#/definitions/polymarket.rewardsMarketResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | polymarket.RewardsMarketResponse | No | ||||
| data.condition_id | string | No | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | Condition id of the market that was requested. | ||
| data.count | integer | No | 1 | Number of reward markets returned. | ||
| data.fetched_at | string | No | 2026-06-07T11:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.market | object | No | Rewards details of the market. | |||
| data.market.condition_id | string | No | 0x2d293b8d8141edcc3317f6e677a01623dc482e7fe8eb4c4e207c9a0987c37d22 | Condition id that identifies the market on Polymarket. | ||
| data.market.daily_reward_rate | number | No | 10.00036 | Daily reward rate offered for the market. | ||
| data.market.earning_percentage | number | No | 0 | Earning percentage Polymarket shows for the market. | ||
| data.market.earnings | array | No | Reward earnings records for the market, as Polymarket returns them. | |||
| data.market.event_id | string | No | 568951 | Polymarket id of the event the market belongs to. | ||
| data.market.event_slug | string | No | sc2-hero-cure-2026-06-07 | URL slug of the event the market belongs to. | ||
| data.market.event_url | string | No | https://polymarket.com/event/sc2-hero-cure-2026-06-07 | Link to the event on polymarket.com. | ||
| data.market.image_url | string | No | URL of the market's image. | |||
| data.market.maker_address | string | No | 0x0000000000000000000000000000000000000000 | Maker address Polymarket reports for the market's rewards. | ||
| data.market.market_competitiveness | number | No | 2.83 | Competitiveness score Polymarket shows for the market's rewards. | ||
| data.market.market_id | string | No | 2461586 | Polymarket market id. | ||
| data.market.market_slug | string | No | sc2-hero-cure-2026-06-07 | URL slug of the market. | ||
| data.market.market_url | string | No | https://polymarket.com/event/sc2-hero-cure-2026-06-07/sc2-hero-cure-2026-06-07 | Link to the market on polymarket.com. | ||
| data.market.question | string | No | StarCraft II: herO vs Cure (BO7) - Global StarCraft II League Playoffs | Question the market asks. | ||
| data.market.rewards_config | array | No | Reward programs configured for the market, one item per program. | |||
| data.market.rewards_config[].asset_address | string | No | 0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB | Contract address of the token paid out as the reward. | ||
| data.market.rewards_config[].end_date | string | No | 2500-12-31 | Date the reward program ends, in YYYY-MM-DD. | ||
| data.market.rewards_config[].id | integer | No | 0 | Id of the reward program configuration. | ||
| data.market.rewards_config[].rate_per_day | number | No | 10.00036 | Reward amount paid per day. | ||
| data.market.rewards_config[].start_date | string | No | 2026-06-07 | Date the reward program starts, in YYYY-MM-DD. | ||
| data.market.rewards_config[].total_rewards | number | No | 0 | Total reward amount configured for the program. | ||
| data.market.rewards_max_spread | number | No | 4.5 | Maximum spread an order can have and still qualify for rewards. | ||
| data.market.rewards_min_size | number | No | 50 | Minimum order size that qualifies for rewards. | ||
| data.market.spread | number | No | 0.01 | Current spread of the market. | ||
| data.market.tokens | array | No | Outcome tokens of the market with their prices, one item per outcome. | |||
| data.market.tokens[].outcome | string | No | herO | Name of the outcome the token represents. | ||
| data.market.tokens[].price | number | No | 0.995 | Current price of the outcome token. | ||
| data.market.tokens[].token_id | string | No | 49033998602764986470838384384660931821099068366428064235699748485619139146655 | Token id of the outcome. | ||
| data.market.total_configured_rewards | number | No | 0 | Total rewards configured for the market. | ||
| data.market.volume_24h | number | No | 79.9901 | Trading volume of the market over the last 24 hours. | ||
| data.source_url | string | No | https://clob.polymarket.com/rewards/markets/0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327?sponsored=true | URL the data was read from. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/polymarket/rewards/market/0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327" \
-H "x-api-key: $CRAWLORA_API_KEY"