API Key Setup
All KittyChain API endpoints require an API key for authentication. Generate and manage your keys from the Dashboard.
Getting Your API Key
1. Log in to your KittLabs account
2. Navigate to Dashboard → API Keys
3. Click "Create API Key" and copy the generated key
API keys start with kk_ prefix. Store your key securely — it is only shown once at creation time.
Authentication
Pass your API key in one of two ways:
Authorization: Bearer kk_your_api_key_here
X-API-Key: kk_your_api_key_here
Base URL
https://kittyhome.pages.dev/api/token/*
https://kittyhome.pages.dev/api/address/*
https://kittyhome.pages.dev/api/transaction/*
Response Format
All endpoints return JSON with a consistent structure:
{
"ok": true,
"data": { ... },
"credits": { "charged": 1, "remaining": 99999 }
}
{
"ok": false,
"error": "Error message",
"code": "ERROR_CODE"
}
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid API key |
INVALID_INPUT | 400 | Missing or invalid request parameters |
INSUFFICIENT_CREDITS | 402 | Not enough credits to complete the request |
UPSTREAM_ERROR | 502 | Upstream data source returned no usable data |
Credits
Each API call consumes credits. Check your balance in the Dashboard.
| Endpoint | Credits |
|---|---|
| Token Search | 1 |
| Token Detail | 2 |
| Token Holders | 1 |
| Token Security | 2 |
| Token Advanced | 2 |
| Token Price | 1 |
| Address Balance | 1 |
| Address Malicious | 2 |
| Address Labels | 2 |
| Address Identity | 10 |
| Address Transfers | 1 |
| Transaction Detail | 1 |