API Endpoints

1. Validate Address

Validates if a cryptocurrency address is correctly formatted for the specified blockchain.

Endpoint: POST /v1/validate

Headers:

Content-Type: application/json
x-api-key: your_api_key_here (optional, for Premium tier)

Request Body:

{
  "chain": "BTC",
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
}

Parameter	Type	Required	Description
`chain`	string	Yes	Cryptocurrency ticker symbol (e.g., ETH, BTC, SOL)
`address`	string	Yes	Address to validate

Success Response (200):

{
  "chain": "BTC",
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "valid": true,
  "usage_left": 29
}

Error Responses:

Status	Error	Meaning
400	`Invalid input: 'chain' and 'address' must be strings`	Missing or invalid parameters
400	`Unsupported chain: XYZ`	Chain not supported
403	`Invalid or inactive API key`	Invalid Premium key
429	`Free tier limit exceeded (30/hr)`	Rate limit reached
429	`Hourly rate limit exceeded`	Premium tier limit reached

2. List Supported Chains

Returns all supported cryptocurrency ticker symbols.

Endpoint: GET /v1/chains

Headers: None required

Success Response (200):

{
  "object": "list",
  "count": 124,
  "data": [
    "1INCH", "ADA", "AAVE", "ALGO", "APE", "ARB", "AVAX", "BCH", "BNB", 
    "BTC", "DOGE", "DOT", "ETH", "LTC", "MATIC", "SOL", "TRX", "USDC", 
    "USDT", "XRP", ...
  ]
}

3. Check Usage

Returns your current request usage and remaining quota.

Endpoint: GET /v1/usage

Headers:

x-api-key: your_api_key_here (optional)

Success Response (200):

Free Tier (no API key):

{
  "plan": "free_public",
  "limit": "30/hour",
  "message": "You are using the free public tier via IP address."
}

Premium Tier (with API key):

{
  "plan": "premium",
  "usage": 42,
  "limit": 1000,
  "period": "Hourly"
}