API Reference

CryptoLens API

Query wallet portfolios, analyze holdings, and integrate crypto insights into your applications.

Introduction

The CryptoLens API allows you to programmatically access our portfolio analysis engine. Scan wallets for tokens, analyze holdings, get trending tokens, and retrieve leaderboard data.

Base URL: https://cryptolens.uk/api/v1

Authentication: Bearer token in Authorization header

Rate Limits: Depends on your plan (Pro: 60 req/min, Premium Plus: 300 req/min)

Authentication

Include your API key in the Authorization header as a Bearer token.

Authorization: Bearer cl_live_xxxxxxxxxxxxxxxxxx

Generate your API keys from your account dashboard.

Rate Limits

Plan	Requests/min	API Keys
Pro	60	3
Premium Plus	300	10

Rate limit status is returned in response headers. If you exceed the limit, you'll receive a 429 (Too Many Requests) response.

Endpoints

GET/portfolio

Analyze a wallet's portfolio across all holdings. Returns token balances, values, and portfolio metrics.

Query Parameters

addressrequired

Wallet address (0x... format for EVM)

chainoptional

Blockchain: eth (default), bsc, sol

Example Request

curl -H "Authorization: Bearer cl_live_xxx" \
  "https://cryptolens.uk/api/v1/portfolio?address=0x1234...&chain=eth"

Example Response

{
  "address": "0x1234...",
  "chain": "eth",
  "totalValue": 15234.50,
  "tokenCount": 12,
  "tokens": [
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "balance": "2.5",
      "value": 5000.00,
      "percentage": 32.8
    },
    ...
  ]
}

Ready to integrate?

Get your API key and start building.

Get API Key