CryptoLens API

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

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

{
  "success": true,
  "plan": "developer",
  "data": {
    "address": "0xYOUR_WALLET_ADDRESS_HERE",
    "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"
}

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

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

{
  "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"
}

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

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

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

Market fear & greed index and sentiment signals.

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

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

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

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

{
  "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"
}

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

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

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

HMRC-compliant UK CGT computation: full Section 104 pool, same-day rule, 30-day bed-and-breakfast rule, annual exempt amount per year, and the 30 Oct 2024 rate split. Same engine that produces the SA108 schedule on the dashboard.

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

{
  "success": true,
  "plan": "business",
  "data": {
    "address": "0xYOUR...",
    "chain": "eth",
    "taxYear": "2025/26",
    "engine": "hmrc",
    "summary": {
      "totalProceeds": 42100.00,
      "totalCosts": 38540.00,
      "totalGains": 4360.00,
      "totalLosses": 800.00,
      "netGain": 3560.00,
      "annualExemption": 3000,
      "taxableGain": 560.00,
      "estimateIfBasicRate": 100.80,
      "estimateIfHigherRate": 134.40,
      "taxBasicRate": 100.80,
      "taxHigherRate": 134.40
    },
    "disposalCount": 47,
    "section104Pools": [
      { "token": "ETH", "quantity": 0.85, "costGBP": 1700.00, "averageCost": 2000.00 }
    ],
    "methodology": {
      "rules": [
        { "rule": "Same-day matching", "citation": "TCGA 1992 s.105(1)(b)" },
        { "rule": "30-day bed-and-breakfast", "citation": "TCGA 1992 s.106A" },
        { "rule": "Section 104 pool", "citation": "TCGA 1992 s.104" }
      ]
    }
  }
}

Paginated transaction history for a wallet. Same source as /portfolio but exposes the tx array directly with pagination headers, so you don't have to load the full holdings response just to walk a tx list.

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/transactions?address=0xYOUR...&chain=eth&page=1&pageSize=50"

{
  "success": true,
  "plan": "developer",
  "data": {
    "address": "0xYOUR...",
    "chain": "eth",
    "transactions": [
      {
        "hash": "0xabc...",
        "type": "send",
        "tokenSymbol": "USDC",
        "value": "1000.50",
        "timestamp": 1736159420000,
        "valueGBP": 790.40
      }
    ],
    "pagination": { "page": 1, "pageSize": 50, "totalPages": 7, "totalCount": 342 }
  }
}

Biggest fumbles for a wallet — disposals where the user sold before all-time-high. Returns the cost-of-regret in GBP per token, sorted by biggest fumble first. CryptoLens signature feature.

curl -H "x-api-key: clk_your_key" \
  "https://cryptolens.uk/api/v1/fumbles?address=0xYOUR...&chain=eth&limit=5"

{
  "success": true,
  "plan": "pro",
  "data": {
    "address": "0xYOUR...",
    "chain": "eth",
    "totalFumbleGBP": 124800.50,
    "biggestFumble": {
      "token": "Shiba Inu",
      "symbol": "SHIB",
      "soldOn": "2021-04-12",
      "soldAt": 0.000004,
      "ath": 0.00007,
      "amount": 1500000000,
      "costOfRegretGBP": 99000.00
    },
    "fumbles": [ /* … */ ]
  }
}

Bulk historical price lookup — returns GBP price for each (token, date) request with the source that priced it (CoinGecko / DefiLlama / GeckoTerminal / Birdeye / DexScreener). Tax-tooling primitive used by anyone building their own portfolio dashboard.

curl -X POST -H "x-api-key: clk_your_key" -H "Content-Type: application/json" \
  -d '{"requests":[{"tokenId":"bitcoin","date":"2024-12-15"},{"tokenId":"ethereum","date":"2024-12-15"}]}' \
  "https://cryptolens.uk/api/v1/historical-prices"

{
  "success": true,
  "plan": "developer",
  "data": {
    "prices": [
      { "tokenId": "bitcoin", "date": "2024-12-15", "priceGBP": 79412.30, "source": "coingecko", "cached": false },
      { "tokenId": "ethereum", "date": "2024-12-15", "priceGBP": 3120.45, "source": "coingecko", "cached": false }
    ],
    "total": 2,
    "cached": 0
  }
}