API Documentation
Free access to nation-state crypto threat intelligence. Build compliance tools, research projects, or integrations.
Quick Links
Base URL
api.threats.osmansonmez.com/v1
Authentication
All API requests require an API key. Include it in the X-API-Key header.
GET /v1/threats/overview
curl -H "X-API-Key: YOUR_KEY" [BASE_URL]/threats/overview Get Your Free API Key
Contact api@osmansonmez.com with your use case to receive a free API key.
Rate Limits
| Tier | Requests/Day | Features |
|---|---|---|
| Free | 100 | Read-only, basic data |
| Researcher | 1,000 | + Historical data, batch queries |
| Press | 5,000 | + Bulk export, priority support |
| Enterprise | Unlimited | + Webhooks, SLA, dedicated support |
Endpoints
GET
/v1/threats/overview Get overview of all tracked nation-state threats.
GET
/v1/threats/{nation} Get detailed threat data for a specific nation.
Nations: north-korea, iran, russia
GET
/v1/wallets List all tracked wallets with pagination.
Params: nation, blockchain, limit, offset
GET
/v1/wallets/{address} Get detailed information about a specific wallet.
GET
/v1/sanctions/check/{address} Check if an address is sanctioned or linked to nation-state actors.
POST
/v1/sanctions/batch-check Check multiple addresses in a single request (max 100).
GET
/v1/alerts Get recent threat alerts.
Params: severity, nation, since
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 429 | Rate Limit Exceeded |
| 500 | Internal Server Error |