Etherdrake
211 lines
7.6 KiB
Markdown
211 lines
7.6 KiB
Markdown
> ## Documentation Index
|
|
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
|
> Use this file to discover all available pages before exploring further.
|
|
|
|
# Geographic Restrictions
|
|
|
|
> Check geographic restrictions before placing orders on the Polymarket API
|
|
|
|
Polymarket restricts order placement from certain geographic locations due to regulatory requirements and compliance with international sanctions. Before placing orders, builders should verify the location.
|
|
|
|
<Warning>
|
|
Orders submitted from blocked regions will be rejected. Implement geoblock
|
|
checks in your application to provide users with appropriate feedback before
|
|
they attempt to trade.
|
|
</Warning>
|
|
|
|
***
|
|
|
|
## Geoblock Endpoint
|
|
|
|
Check the geographic eligibility of the requesting IP address:
|
|
|
|
```bash theme={null}
|
|
GET https://polymarket.com/api/geoblock
|
|
```
|
|
|
|
<Note>This endpoint is on `polymarket.com`, not the API servers.</Note>
|
|
|
|
### Response
|
|
|
|
```json theme={null}
|
|
{
|
|
"blocked": true,
|
|
"ip": "203.0.113.42",
|
|
"country": "US",
|
|
"region": "NY"
|
|
}
|
|
```
|
|
|
|
| Field | Type | Description |
|
|
| --------- | ------- | ----------------------------------------------- |
|
|
| `blocked` | boolean | Whether the user is blocked from placing orders |
|
|
| `ip` | string | Detected IP address |
|
|
| `country` | string | ISO 3166-1 alpha-2 country code |
|
|
| `region` | string | Region/state code |
|
|
|
|
***
|
|
|
|
## Blocked Countries
|
|
|
|
The following countries are restricted from placing orders on Polymarket. Countries marked as **close-only** can close existing positions but cannot open new ones. Countries marked as **frontend UI restricted** are blocked only on the Polymarket frontend; the API itself is not restricted:
|
|
|
|
| Country Code | Country Name | Status |
|
|
| ------------ | ------------------------------------ | ---------------------- |
|
|
| AU | Australia | Blocked |
|
|
| BE | Belgium | Blocked |
|
|
| BY | Belarus | Blocked |
|
|
| BI | Burundi | Blocked |
|
|
| CF | Central African Republic | Blocked |
|
|
| CD | Congo (Kinshasa) | Blocked |
|
|
| CU | Cuba | Blocked |
|
|
| DE | Germany | Blocked |
|
|
| ET | Ethiopia | Blocked |
|
|
| FR | France | Blocked |
|
|
| GB | United Kingdom | Blocked |
|
|
| IR | Iran | Blocked |
|
|
| IQ | Iraq | Blocked |
|
|
| IT | Italy | Blocked |
|
|
| JP | Japan | Frontend UI restricted |
|
|
| KP | North Korea | Blocked |
|
|
| LB | Lebanon | Blocked |
|
|
| LY | Libya | Blocked |
|
|
| MM | Myanmar | Blocked |
|
|
| NI | Nicaragua | Blocked |
|
|
| NL | Netherlands | Blocked |
|
|
| PL | Poland | Close-only |
|
|
| RU | Russia | Blocked |
|
|
| SG | Singapore | Close-only |
|
|
| SO | Somalia | Blocked |
|
|
| SS | South Sudan | Blocked |
|
|
| SD | Sudan | Blocked |
|
|
| SY | Syria | Blocked |
|
|
| TH | Thailand | Close-only |
|
|
| TW | Taiwan | Close-only |
|
|
| UM | United States Minor Outlying Islands | Blocked |
|
|
| US | United States | Blocked |
|
|
| VE | Venezuela | Blocked |
|
|
| YE | Yemen | Blocked |
|
|
| ZW | Zimbabwe | Blocked |
|
|
|
|
***
|
|
|
|
## Blocked Regions
|
|
|
|
In addition to fully blocked countries, the following specific regions within otherwise accessible countries are also restricted:
|
|
|
|
| Country | Region | Region Code |
|
|
| ------------ | ------- | ----------- |
|
|
| Canada (CA) | Ontario | ON |
|
|
| Ukraine (UA) | Crimea | 43 |
|
|
| Ukraine (UA) | Donetsk | 14 |
|
|
| Ukraine (UA) | Luhansk | 09 |
|
|
|
|
***
|
|
|
|
## Blocking Logic
|
|
|
|
The geoblocking system includes:
|
|
|
|
1. **OFAC-Sanctioned Countries**: Countries sanctioned by the U.S. Office of Foreign Assets Control (OFAC)
|
|
2. **Additional Regulatory Restrictions**: Countries added for specific regulatory compliance reasons
|
|
|
|
***
|
|
|
|
## Server Infrastructure
|
|
|
|
* **Primary Servers**: eu-west-2
|
|
* **Closest Non-Georestricted Region**: eu-west-1
|
|
|
|
***
|
|
|
|
## Usage Examples
|
|
|
|
<Tabs>
|
|
<Tab title="TypeScript">
|
|
```typescript theme={null}
|
|
interface GeoblockResponse {
|
|
blocked: boolean;
|
|
ip: string;
|
|
country: string;
|
|
region: string;
|
|
}
|
|
|
|
async function checkGeoblock(): Promise<GeoblockResponse> {
|
|
const response = await fetch("https://polymarket.com/api/geoblock");
|
|
return response.json();
|
|
}
|
|
|
|
// Usage
|
|
const geo = await checkGeoblock();
|
|
|
|
if (geo.blocked) {
|
|
console.log(`Trading not available in ${geo.country}`);
|
|
} else {
|
|
console.log("Trading available");
|
|
}
|
|
```
|
|
</Tab>
|
|
|
|
<Tab title="Python">
|
|
```python theme={null}
|
|
import requests
|
|
|
|
def check_geoblock() -> dict:
|
|
response = requests.get("https://polymarket.com/api/geoblock")
|
|
return response.json()
|
|
|
|
# Usage
|
|
geo = check_geoblock()
|
|
|
|
if geo["blocked"]:
|
|
print(f"Trading not available in {geo['country']}")
|
|
else:
|
|
print("Trading available")
|
|
```
|
|
</Tab>
|
|
|
|
<Tab title="Rust">
|
|
```rust theme={null}
|
|
use polymarket_client_sdk_v2::clob::{Client, Config};
|
|
|
|
let client = Client::new("https://clob.polymarket.com", Config::default())?;
|
|
let geo = client.check_geoblock().await?;
|
|
|
|
if geo.blocked {
|
|
println!("Trading not available in {}", geo.country);
|
|
} else {
|
|
println!("Trading available");
|
|
}
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
***
|
|
|
|
## Why These Restrictions
|
|
|
|
Geographic restrictions are implemented to ensure compliance with:
|
|
|
|
* International sanctions and embargoes
|
|
* Local financial regulations
|
|
* Gambling and prediction market laws
|
|
* Anti-money laundering (AML) requirements
|
|
* Know Your Customer (KYC) regulations
|
|
|
|
If you believe you are incorrectly restricted or have questions about geographic availability, please contact [Polymarket Support](https://polymarket.com/support).
|
|
|
|
***
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Authentication" icon="key" href="/api-reference/authentication">
|
|
Learn how to authenticate trading requests.
|
|
</Card>
|
|
|
|
<Card title="Place Orders" icon="plus" href="/trading/quickstart">
|
|
Start placing orders (from eligible regions).
|
|
</Card>
|
|
</CardGroup>
|