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:

HTTP Header (Recommended)
Authorization: Bearer kk_your_api_key_here
Alternative Header
X-API-Key: kk_your_api_key_here

Base URL

Endpoint
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:

Success
{ "ok": true, "data": { ... }, "credits": { "charged": 1, "remaining": 99999 } }
Error
{ "ok": false, "error": "Error message", "code": "ERROR_CODE" }

Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid API key
INVALID_INPUT400Missing or invalid request parameters
INSUFFICIENT_CREDITS402Not enough credits to complete the request
UPSTREAM_ERROR502Upstream data source returned no usable data

Credits

Each API call consumes credits. Check your balance in the Dashboard.

EndpointCredits
Token Search1
Token Detail2
Token Holders1
Token Security2
Token Advanced2
Token Price1
Address Balance1
Address Malicious2
Address Labels2
Address Identity10
Address Transfers1
Transaction Detail1