# API Documentation

Kaizen AI offers robust APIs for developers and analysts to integrate scoring, intelligence, and alert systems into their own tools or dashboards.

#### REST API Endpoints

RESTful services are available for:

* Token scoring and analytics
* Wallet attribution
* Contract risk analysis
* Live alert streaming

**Example:**

```
GET /api/v1/score/{tokenAddress}
GET /api/v1/wallet/{walletAddress}/intel
```

#### GraphQL Schema

GraphQL endpoints enable selective querying of nested data structures, such as:

* Kaizen Score + factors
* Social signal breakdown
* Historical project data

**Benefits:**

* Precision data selection
* Lower payloads
* Ideal for dashboards and UI clients

#### Authentication Methods

Kaizen API supports:

* API Key Authentication (JWT-style tokens)
* OAuth2 support (for enterprise integrations)

#### Rate Limiting

To ensure fair access and platform stability:

* 60 req/min (free tier)
* 300 req/min (enterprise tier)
* Burst protection via token bucket system

#### Response Formats

* JSON (default)
* CSV (for batch data)
* WebSocket stream (for real-time alerts)
