---
title: "Prediction markets"
description: "Returns prediction-market probabilities and trading volumes for a country. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/osint/getCountryPredictions/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# Prediction markets

Returns prediction-market probabilities and trading volumes for a country. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/osint/countries/{countryCode}/predictions`

- Operation ID: `getCountryPredictions`
- Required scopes: `osint:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `countryCode` | path | string | Yes | ISO 3166-1 alpha-2 country code |
| `limit` | query | integer | No | Maximum number of predictions to return |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `format` | query | `json`, `ndjson` | No | `json` uses the resource envelope. `ndjson` streams one canonical row per line. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Prediction markets for the country | `CountryPredictionMarketListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `CountryPredictionMarket` |  |
| `data[].source` | string | Prediction market platform |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].marketId` | string | Prediction market identifier |
| `data[].title` | string | Market question/title |
| `data[].probability` | number | Current probability (0-1) |
| `data[].volume` | number | Trading volume |
| `data[].liquidity` | number or null | Market liquidity (null if unavailable) |
| `data[].outcomes[]` | array of `PredictionOutcome` | Typed outcome labels with normalized fractional probabilities. |
| `data[].probabilityBasis` | string |  |
| `data[].volumeMeasurement` | `ProviderReportedMeasurement` |  |
| `data[].liquidityMeasurement` | `ProviderReportedMeasurement` |  |
| `data[].slug` | string or null | URL-friendly market slug (null if unavailable) |
| `data[].polymarketUrl` | string (uri) | Polymarket URL for this market |
| `data[].endDate` | string (date-time) | Market resolution date |
| `meta` | object |  |
| `meta.page` | `PublicPageMeta` |  |
| `meta.countryCode` | string |  |
| `meta.count` | integer |  |
| `meta.limit` | integer |  |
| `meta.hasMore` | boolean | Whether more results are available beyond the current limit |
