Skip to main content

​
Overview

Retrieve real-time price and market data for a cryptocurrency by its smart contract address.

​
Usage

coinpaprika-cli contract-ticker <platform_id> <address>

​
Arguments

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

​
Options

​
--output
string
default:"table"
Output format: table or json
​
--raw
boolean
default:"false"
JSON output without _meta wrapper (for scripts/piping)

​
Examples

​
Get USDT ticker (Ethereum)

coinpaprika-cli contract-ticker eth-ethereum 0xdac17f958d2ee523a2206206994597c13d831ec7

​
Get token data on BSC

coinpaprika-cli contract-ticker bnb-binance-coin 0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d

​
JSON output for automation

coinpaprika-cli contract-ticker eth-ethereum 0xdac17f958d2ee523a2206206994597c13d831ec7 \
  --output json --raw

​
Response Fields

​
id
string
CoinPaprika coin ID
​
name
string
Token name
​
symbol
string
Token symbol
​
rank
number
Market cap rank
​
circulating_supply
number
Circulating supply
​
total_supply
number
Total supply
​
max_supply
number
Maximum supply
​
quotes
object
Price data in various currencies (USD by default)

​
API Endpoint

GET https://api.coinpaprika.com/v1/contracts/{platform_id}/{address}

contracts

List contracts on a platform

contract-history

Get historical data by contract (Starter+)

​
Notes

  • Contract addresses are case-insensitive but typically lowercase
  • Works with any ERC-20, BEP-20, or similar token standard
  • Data updates every ~10 minutes on free tier
  • Returns 404 if contract is not tracked by CoinPaprika

Build docs developers (and LLMs) love

Get started for freeTalk to us