API Documentation

Welcome to CryptoChain API — a unified, free REST API to query raw blockchain data from 7+ networks. No API keys. No rate limits for reasonable usage.

🔗 7+ Chains

Bitcoin, Ethereum, Litecoin, Polygon, Dogecoin, Solana, Kaspa

⚡ Fast

Direct integration with fastest available data sources

🔓 No Auth

Public endpoints, no API keys required

📊 JSON

Clean, consistent JSON responses

Pro Tip: Data formats are consistent within each blockchain family (UTXO chains like BTC/LTC/DOGE use satoshi units, EVM chains use wei).

Base URL

https://cryptochain.sh/api

All endpoints follow the pattern: /api/{chain}/{endpoint}

Chain	Code	Unit
Bitcoin	`btc`	Satoshis (1 BTC = 10⁸)
Ethereum	`eth`	Wei (1 ETH = 10¹⁸)
Litecoin	`ltc`	Litoshis (1 LTC = 10⁸)
Polygon	`polygon`	Wei (1 POL = 10¹⁸)
Dogecoin	`doge`	Koinu (1 DOGE = 10⁸)
Solana	`sol`	Lamports (1 SOL = 10⁹)
Kaspa	`kas`	Sompi
Binance Smart Chain	`bsc`	Wei (1 BNB = 10¹⁸)

Error Handling

The API returns standard HTTP status codes with JSON error bodies:

Code	Meaning	Action
`200`	Success	Parse response data
`400`	Bad Request	Check endpoint/parameters
`404`	Not Found	Address/TX doesn't exist
`429`	Rate Limited	Wait and retry
`500`	Server Error	Upstream API issue

                // Error response format
                {
                "error": "Address not found",
                "status": 404
                }
            

Rate Limits

There are no strict rate limits, but please be reasonable:

~10 requests/second is safe
Burst traffic is fine for short periods
For heavy usage, consider caching responses

Note: Some chains (especially Solana RPC) have their own rate limits. If you hit 429 errors, back off and retry.

GET /api/btc/address/:address

Binance Smart Chain (BSC)

Get Address Info

GET /api/bsc/addresses/:address

Returns balance in Wei.

Get Transaction

GET /api/bsc/transactions/:hash

Parameters:

Param	Type	Description
`address`	string	Bitcoin address (Legacy, P2SH, or Bech32)

            // Example: GET /api/btc/address/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

            {
            "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
            "chain_stats": {
            "funded_txo_count": 2817,
            "funded_txo_sum": 7243538294,
            "spent_txo_count": 0,
            "spent_txo_sum": 0,
            "tx_count": 2817
            },
            "mempool_stats": { /* unconfirmed activity */ }
            }

            // 💡 Balance = funded_txo_sum - spent_txo_sum
        

Get UTXOs

Returns all unspent transaction outputs for an address.

GET /api/btc/address/:address/utxo

                [
                {
                "txid": "abc123...",
                "vout": 0,
                "value": 50000,
                "status": { "confirmed": true }
                }
                ]
            

Get Transaction

GET /api/btc/tx/:txid

                {
                "txid": "abc123...",
                "status": {
                "confirmed": true,
                "block_height": 800000,
                "block_time": 1699500000
                },
                "vin": [/* inputs */],
                "vout": [/* outputs */],
                "fee": 12500
                }
            

Get Block Height

GET /api/btc/blocks/tip/height

Returns: 883456 (just the number)

Ethereum (ETH)

Get Address Info

GET /api/eth/address/:address

                {
                "hash": "0x...",
                "coin_balance": "1500000000000000000",
                "token_transfers_count": 42,
                "transactions_count": 156
                }
            

Get Token Balances

GET /api/eth/address/:address/token-balances

Returns array of ERC-20/721/1155 tokens held.

Get Transaction

GET /api/eth/tx/:hash

Returns full transaction with token transfers, gas info, and status.

Litecoin (LTC)

Get Address Info

GET /api/ltc/address/:address

Get Transaction

GET /api/ltc/tx/:txid

Polygon (POL)

Get Address Info

GET /api/polygon/address/:address

Get Token Balances

GET /api/polygon/address/:address/token-balances

Get Transactions

GET /api/polygon/address/:address/transactions

Dogecoin (DOGE)

Get Address Info

GET /api/doge/address/:address

                {
                "address": "DRSqEwcnJX3GZWH9Twtwk8D5ewqdJzi13k",
                "chain_stats": {
                "funded_txo_sum": 19934423333060485281,
                "spent_txo_sum": 19934423333060485281,
                "tx_count": 6509
                },
                "balance": 0
                }
            

Get Transaction

GET /api/doge/tx/:txid

Solana (SOL)

Direct Solana Mainnet RPC integration. Values in Lamports (1 SOL = 10⁹).

Note: Solana public RPC has rate limits. For production apps, consider using a dedicated RPC endpoint.

Get Address Balance

GET /api/sol/address/:address

                {
                "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                "balance": 1500000000,
                "balance_sol": 1.5
                }
            

Get Transaction

GET /api/sol/tx/:signature

Note: Solana signatures are ~88 characters (Base58).

                {
                "blockTime": 1706300000,
                "meta": {
                "err": null,
                "fee": 5000,
                "preBalances": [...],
                "postBalances": [...]
                },
                "transaction": {
                "message": {
                "accountKeys": [...]
                }
                }
                }
            

Kaspa (KAS)

Get Balance

GET /api/kas/addresses/:address/balance