API Documentation - Chain Sentinel

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Get your API key from the API Keys page.

Base URL

https://api.chainsentinel.net

Token Endpoints

GET /api/tokens/{address}

Get detailed token analysis including risk score, network metrics, and scam detection.

Example Request

            curl -X GET "https://api.chainsentinel.net/api/tokens/TokenAddress123..." \
  -H "X-API-Key: your_api_key_here"
        

Response

            {
  "address": "TokenAddress123...",
  "name": "Example Token",
  "symbol": "EXT",
  "risk_score": 75.5,
  "risk_level": "HIGH",
  "is_rug": true,
  "confidence": 0.92
}
        

GET /api/tokens

List all detected tokens with pagination and filtering.

Query Parameters

limit - Number of results (default: 20, max: 100)
offset - Pagination offset (default: 0)
risk_level - Filter by risk level (LOW, MEDIUM, HIGH, CRITICAL)

Wallet Endpoints

GET /api/wallets/{address}

Get wallet reputation, scam history, and connection analysis.

GET /api/wallets/{address}/reputation

Get detailed reputation score and history.

Graph Endpoints

GET /api/graph/token/{address}

Get network graph data for token visualization.

GET /api/graph/wallet/{address}

Get network graph data for wallet connections.

Report Endpoints

POST /api/reports/generate/{address}

Generate AI-powered comprehensive scam analysis report.

Request Body

            {
  "language": "en"  // en, ru, es, zh
}
        

Rate Limits

Plan	Daily Limit	Rate
Free	100 requests	10 req/min
Starter	10,000 requests	100 req/min
Pro	100,000 requests	1000 req/min
Enterprise	Unlimited	Custom

Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Resource doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

📚 API Documentation