Skip to main content

​
Overview

List blockchain platforms that support smart contracts and query contract information by address. This is essential for tracking tokens on platforms like Ethereum, BNB Chain, and Polygon.

​
Commands

​
List Platforms

Get a list of all supported blockchain platforms: 
coinpaprika-cli platforms

​
List Contracts

Get contracts deployed on a specific platform: 
coinpaprika-cli contracts <platform_id> [OPTIONS]

​
Contract Ticker

Get ticker data for a specific contract address: 
coinpaprika-cli contract-ticker <platform_id> <address>

​
Contract History

Get historical ticker data for a contract [PAID: Starter+]: 
coinpaprika-cli contract-history <platform_id> <address> [OPTIONS]

​
List Platforms

​
Options

​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

coinpaprika-cli platforms
coinpaprika-cli platforms --output json

​
Response

[
  "eth-ethereum",
  "bnb-binance-coin",
  "matic-polygon",
  "avax-avalanche",
  "ftm-fantom",
  "sol-solana"
]

​
List Contracts

​
Arguments

​
platform_id
string
required
Platform ID (e.g., eth-ethereum, bnb-binance-coin)

​
Options

​
limit
number
default:"50"
Maximum number of contracts to return
​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

coinpaprika-cli contracts eth-ethereum --limit 20
coinpaprika-cli contracts bnb-binance-coin --limit 50 --output json
coinpaprika-cli contracts matic-polygon

​
Response

[
  {
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "type": "ERC20",
    "id": "usdt-tether",
    "active": true
  },
  {
    "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "type": "ERC20",
    "id": "usdc-usd-coin",
    "active": true
  }
]

​
Contract Ticker

​
Arguments

​
platform_id
string
required
Platform ID (e.g., eth-ethereum)
​
address
string
required
Smart contract address (e.g., 0xdac17f958d2ee523a2206206994597c13d831ec7)

​
Options

​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

​
Get USDT contract ticker on Ethereum

coinpaprika-cli contract-ticker eth-ethereum 0xdac17f958d2ee523a2206206994597c13d831ec7

​
Get USDC contract ticker

coinpaprika-cli contract-ticker eth-ethereum 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

​
Get token data as JSON

coinpaprika-cli contract-ticker bnb-binance-coin 0xe9e7cea3dedca5984780bafc599bd69add087d56 --output json

​
Response

{
  "id": "usdt-tether",
  "name": "Tether",
  "symbol": "USDT",
  "rank": 3,
  "circulating_supply": 95000000000,
  "total_supply": 95000000000,
  "max_supply": null,
  "beta_value": 0.12,
  "first_data_at": "2015-02-25T00:00:00Z",
  "last_updated": "2024-01-02T15:30:00Z",
  "quotes": {
    "USD": {
      "price": 1.0,
      "volume_24h": 45000000000,
      "volume_24h_change_24h": 5.2,
      "market_cap": 95000000000,
      "market_cap_change_24h": 0.1,
      "percent_change_24h": 0.02,
      "percent_change_7d": -0.01,
      "percent_change_30d": 0.03,
      "percent_change_1y": 0.15,
      "ath_price": 1.32,
      "ath_date": "2015-03-02T00:00:00Z",
      "percent_from_price_ath": -24.2
    }
  }
}

​
Contract History [PAID]

This command requires a paid plan (Starter or higher). See coinpaprika-cli plans for details.

​
Arguments

​
platform_id
string
required
Platform ID (e.g., eth-ethereum)
​
address
string
required
Smart contract address

​
Options

​
start
string
required
Start date in ISO format (e.g., 2024-01-01)
​
end
string
End date in ISO format (defaults to now)
​
interval
string
default:"24h"
Time interval: 5m, 15m, 30m, 1h, 6h, 12h, 24h
​
limit
number
default:"50"
Maximum number of data points to return
​
output
string
default:"table"
Output format: table or json
​
raw
boolean
default:"false"
Output raw JSON without metadata wrapper

​
Examples

coinpaprika-cli contract-history eth-ethereum 0xdac17f958d2ee523a2206206994597c13d831ec7 --start 2024-01-01
coinpaprika-cli contract-history eth-ethereum 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 --start 2024-01-01 --interval 1h --limit 100

​
Response

[
  {
    "timestamp": "2024-01-01T00:00:00Z",
    "price": 1.0001,
    "volume_24h": 42000000000,
    "market_cap": 94500000000
  },
  {
    "timestamp": "2024-01-02T00:00:00Z",
    "price": 1.0002,
    "volume_24h": 45000000000,
    "market_cap": 95000000000
  }
]

​
Response Fields

​
Contract Object

​
address
string
Smart contract address on the blockchain
​
type
string
Contract standard (e.g., ERC20, BEP20, SPL)
​
id
string
CoinPaprika coin ID for this contract
​
active
boolean
Whether the contract is currently active

​
Contract Ticker Fields

See the ticker command documentation for full field descriptions.

​
Common Platform IDs

  • eth-ethereum - Ethereum (ERC20 tokens)
  • bnb-binance-coin - BNB Chain (BEP20 tokens)
  • matic-polygon - Polygon
  • avax-avalanche - Avalanche C-Chain
  • ftm-fantom - Fantom
  • sol-solana - Solana (SPL tokens)
  • arb-arbitrum - Arbitrum
  • op-optimism - Optimism

​
Notes

  • Contract addresses are case-insensitive but typically shown in lowercase
  • ERC20 is the most common token standard on Ethereum
  • The same token may have contracts on multiple platforms (multi-chain)
  • Historical contract data requires a paid plan
  • Available on free tier (except contract history)
  • ticker - Get ticker data by coin ID
  • coins - List all coins
  • search - Search for tokens

Build docs developers (and LLMs) love

Get started for freeTalk to us