Developer APIs

API Documentation

Access ETC price data, network statistics, and blockchain information through our REST API endpoints.

Quick Start

// Using fetch
const response = await fetch('https://ethereumclassic.com/api/price');
const data = await response.json();
console.log(`ETC Price: $${data.price}`);

// Using ethers.js for RPC
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider('https://etc.rivet.cloud');
const blockNumber = await provider.getBlockNumber();

REST API Endpoints

GET/api/price

Get current ETC price data including USD price, 24h change, market cap, and volume.

Parameters

Name	Type	Required	Description
currency	string	Optional	Target currency (default: usd)

Response

{
  "price": 25.42,
  "change24h": 3.5,
  "marketCap": 3650000000,
  "volume24h": 185000000,
  "high24h": 26.10,
  "low24h": 24.80,
  "currency": "usd",
  "timestamp": "2024-02-04T12:00:00Z"
}

GET/api/price/history

Get historical price data for ETC over a specified time range.

Parameters

Name	Type	Required	Description
days	number	Optional	Number of days (default: 7, max: 365)
currency	string	Optional	Target currency (default: usd)

Response

{
  "prices": [
    { "timestamp": "2024-01-28T00:00:00Z", "price": 24.10 },
    { "timestamp": "2024-01-29T00:00:00Z", "price": 24.85 },
    ...
  ],
  "currency": "usd"
}

GET/api/network

Get current Ethereum Classic network statistics.

Response

{
  "hashrate": "185.2 TH/s",
  "difficulty": "2.5 PH",
  "blockHeight": 19250000,
  "blockTime": 13.5,
  "blockReward": 2.56,
  "totalSupply": 147500000,
  "timestamp": "2024-02-04T12:00:00Z"
}

GET/api/network/blocks

Get recent blocks from the ETC blockchain.

Parameters

Name	Type	Required	Description
limit	number	Optional	Number of blocks (default: 10, max: 100)

Response

{
  "blocks": [
    {
      "number": 19250000,
      "hash": "0x...",
      "timestamp": "2024-02-04T11:59:45Z",
      "transactions": 45,
      "miner": "0x...",
      "reward": 2.56,
      "gasUsed": 12500000
    },
    ...
  ]
}

Public RPC Endpoints

Use these public RPC endpoints to interact with the Ethereum Classic blockchain directly.

Rivet (ETC)

https://etc.rivet.cloud

High-performance ETC RPC endpoint

Rate limit: 100 req/s

Blockscout RPC

https://etc.blockscout.com/api/eth-rpc

Blockscout-powered RPC endpoint

Rate limit: 50 req/s

ETC Cooperative

https://www.ethercluster.com/etc

Community-operated RPC endpoint

Rate limit: Unlimited

Rate Limits & Best Practices

Rate Limits

100 requests/minute per IP for REST API
Responses include X-RateLimit-* headers
429 status code when limit exceeded

Best Practices

Cache responses when possible (prices update every 60s)
Use batch requests for multiple data points
Implement exponential backoff for retries

Additional Resources

Blockscout API

Full blockchain explorer API with address, transaction, and token data.

Developer Docs

Comprehensive documentation for building on Ethereum Classic.

Developer Tools

SDKs, libraries, and tools for ETC development.