API Reference

CryptoLens API

7 endpoints for portfolio data, gas prices, trending tokens, market sentiment, live prices, wallet analysis, and UK tax estimates.

Getting started

The CryptoLens API gives you programmatic access to the same data that powers the site. Scan wallets across 8 blockchains, pull live prices, check gas fees, and estimate UK tax liability — all via simple REST calls.

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

Authentication: API key via x-api-key header or Authorization: Bearer

Format: All responses are JSON with the envelope { success, plan, data, timestamp }

Rate limits

Plan	Price	Requests/min	API keys	Endpoints
Pro	£4.99/mo	600	3	All 7
Developer	£19.99/mo	2,000	5	All 7
Business	£49.99/mo	6,000	25	All 7

Rate limit status is returned in response headers. If you exceed the limit, you'll receive a 429 response with a retryAfter field.

Authentication

Include your API key in every request via the x-api-key header:

curl -H "x-api-key: clk_your_api_key_here" \
  "https://cryptolens.uk/api/v1/portfolio?address=0x1234..."

Generate your API keys from your account dashboard.

Endpoints

All endpoints are under /api/v1

GET/portfolio GET/gas GET/trending GET/sentiment GET/prices GET/wallet-age GET/tax

GET/portfolio

Scan a wallet and return token balances, values, and portfolio metrics across all supported chains.

Parameters

addressrequired

Wallet address (0x... for EVM, base58 for Solana)

chainoptional

Blockchain: eth, bsc, polygon, arbitrum, optimism, base, avalanche, sol. Omit to scan all EVM chains.

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/portfolio?address=0xd8dA...&chain=eth"

Example response

{
  "success": true,
  "plan": "developer",
  "data": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chain": "eth",
    "nativeBalance": "2.5 ETH",
    "nativeSymbol": "ETH",
    "totalValue": 15234.50,
    "totalTokens": 12,
    "tokens": [
      { "symbol": "ETH", "name": "Ethereum", "balance": "2.5", "value": 5000.00, "percentage": 32.8 }
    ]
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/gas

Live gas prices across all 8 supported blockchains — Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, Avalanche, and Solana.

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/gas"

Example response

{
  "success": true,
  "plan": "developer",
  "data": {
    "chains": {
      "eth": { "low": 8, "standard": 12, "fast": 18, "unit": "gwei" },
      "polygon": { "low": 25, "standard": 30, "fast": 45, "unit": "gwei" },
      "sol": { "priorityFee": 0.00005, "unit": "SOL" }
    },
    "timestamp": "2026-04-18T12:00:00.000Z"
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/trending

Trending tokens by volume, price change, and market activity. Includes top gainers and losers.

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/trending"

Example response

{
  "success": true,
  "plan": "developer",
  "data": {
    "trending": [
      { "symbol": "PEPE", "name": "Pepe", "price": 0.0000082, "change24h": 24.5 }
    ]
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/sentiment

Market fear & greed index and sentiment signals.

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/sentiment"

Example response

{
  "success": true,
  "plan": "pro",
  "data": {
    "score": 72,
    "label": "Greed",
    "previous": 65
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/prices

Current prices for specified coins in GBP and USD, with 24h change and market cap data. Powered by CoinGecko.

Parameters

idsrequired

Comma-separated CoinGecko IDs: bitcoin,ethereum,solana (max 50)

vs_currenciesoptional

Comma-separated currencies (default: gbp,usd)

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/prices?ids=bitcoin,ethereum,solana"

Example response

{
  "success": true,
  "plan": "developer",
  "data": {
    "bitcoin": { "gbp": 51234.00, "usd": 64123.00, "gbp_24h_change": 2.1 },
    "ethereum": { "gbp": 2456.00, "usd": 3078.00, "gbp_24h_change": -0.8 },
    "solana": { "gbp": 112.50, "usd": 140.90, "gbp_24h_change": 5.3 }
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/wallet-age

Check when a wallet made its first transaction and how old it is.

Parameters

addressrequired

Wallet address (0x... for EVM)

chainoptional

Blockchain (default: eth)

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/wallet-age?address=0xd8dA..."

Example response

{
  "success": true,
  "plan": "pro",
  "data": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "firstTransaction": "2015-08-07T00:00:00.000Z",
    "ageDays": 3907,
    "ageLabel": "10 years, 8 months",
    "totalTransactions": 1247
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

GET/tax

Scan a wallet and compute a UK Capital Gains Tax estimate. Uses £3,000 annual exemption (2024/25 onwards), 18% basic rate, 24% higher rate.

Parameters

addressrequired

Wallet address

chainoptional

Blockchain (default: eth)

Example request

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/tax?address=0xd8dA...&chain=eth"

Example response

{
  "success": true,
  "plan": "developer",
  "data": {
    "address": "0xd8dA...",
    "chain": "eth",
    "tax": {
      "estimatedGainLoss": 8500.00,
      "annualExemption": 3000,
      "taxableGain": 5500.00,
      "estimatedTaxBasicRate": 550.00,
      "estimatedTaxHigherRate": 1100.00,
      "holdingsValue": 15234.50,
      "transactionsAnalysed": 342,
      "taxYear": "2026/27",
      "disclaimer": "Estimate only. Consult a tax professional."
    }
  },
  "timestamp": "2026-04-18T12:00:00.000Z"
}

Ready to integrate?

7 endpoints, 600+ req/min on Pro, 2,000 on Developer. Get your key and start building.

Get API Key