v0.1.0-beta

OpenAPI 3.1.0

Coin Data by Token Address

Felo API Support

MIT

Server

https://openapi.felo.ai

Client Libraries

Shell Curl

CoinGecko

Cryptocurrency prices, market data and historical series.

CoinGecko Operations

get/v1/beta/coingecko/coins/{id}/contract/{contract_address}

Coin Data by Token Address

A full coin profile looked up by contract address instead of CoinGecko id. id is the asset platform and contract_address the token; both are required and there are no other parameters. Returns the same shape as get_coingecko_coins_id — description, links, image, categories, platforms, detail_platforms, market_cap_rank, a market_data block and an embedded tickers array — plus contract_address itself. Use it to identify an unknown token from an address. If only the current price is needed, get_coingecko_simple_token_price_id is far lighter.

Path Parameters

id
Type: string
required

Asset platform ID (e.g., ethereum). Refers to the /asset_platforms list on CoinGecko.
contract_address
Type: string
required

The contract address of the token.

Responses

200
Type: object · CoinsContractAddress

Get current data for a coin.
additional_notices
Type: array string[]

additional notices

asset_platform_id
Type: string

coin asset platform ID

block_time_in_minutes
Type: number

blockchain block time in minutes

categories
Type: array string[]

coin categories

community_data
Type: object

coin community data

facebook_likes
Type: number nullable

coin facebook likes

reddit_accounts_active_48h
Type: number

coin reddit active accounts in 48 hours

reddit_average_comments_48h
Type: number

coin reddit average comments in 48 hours

reddit_average_posts_48h
Type: number

coin reddit average posts in 48 hours

reddit_subscribers
Type: number

coin reddit subscribers

telegram_channel_user_count
Type: number nullable

coin telegram channel user count

contract_address
Type: string

coin contract address

country_origin
Type: string

coin country of origin

description
Type: object

coin description

propertyName
Type: string
detail_platforms
Type: object

detailed coin asset platform and contract address

propertyName
Type: object
contract_address
Type: string
decimal_place
Type: number nullable
developer_data
Type: object

coin developer data

closed_issues
Type: number

coin repository closed issues

code_additions_deletions_4_weeks
Type: object

coin code additions and deletions in 4 weeks

additions
Type: number nullable
deletions
Type: number nullable
commit_count_4_weeks
Type: number

coin repository commit count in 4 weeks

forks
Type: number

coin repository forks

last_4_weeks_commit_activity_series
Type: array number[]

coin repository last 4 weeks commit activity series

pull_request_contributors
Type: number

coin repository pull request contributors

pull_requests_merged
Type: number

coin repository pull requests merged

stars
Type: number

coin repository stars

subscribers
Type: number

coin repository subscribers

total_issues
Type: number

coin repository total issues

genesis_date
Type: string Format: date-timenullable

coin genesis date

hashing_algorithm
Type: string nullable

blockchain hashing algorithm

id
Type: string

coin ID

image
Type: object

coin image url

large
Type: string
small
Type: string
thumb
Type: string
last_updated
Type: string Format: date-time

coin last updated timestamp

links
Type: object

links

announcement_url
Type: array string[]

coin announcement url

bitcointalk_thread_identifier
Type: string nullable

coin bitcointalk thread identifier

blockchain_site
Type: array string[]

coin block explorer url

chat_url
Type: array string[]

coin chat url

facebook_username
Type: string

coin facebook username

homepage
Type: array string[]

coin website url

official_forum_url
Type: array string[]

coin official forum url

repos_url
Type: object

coin repository url

bitbucket
Type: array string[]

coin bitbucket repository url

github
Type: array string[]

coin github repository url

snapshot_url
Type: string nullable

coin snapshot url

subreddit_url
Type: string nullable

coin subreddit url

telegram_channel_identifier
Type: string

coin telegram channel identifier

twitter_screen_name
Type: string

coin twitter handle

whitepaper
Type: string

coin whitepaper url

localization
Type: object

coin name localization

propertyName
Type: string
market_cap_rank
Type: number

coin rank by market cap

market_cap_rank_with_rehypothecated
Type: number

coin rank by market cap including rehypothecated tokens

market_data
Type: object

coin market data

ath
Type: object

coin all time high (ATH) in currency

btc
Type: number
eur
Type: number
usd
Type: number
ath_change_percentage
Type: object

coin all time high (ATH) change in percentage

btc
Type: number
eur
Type: number
usd
Type: number
ath_date
Type: object

coin all time high (ATH) date

btc
Type: string
eur
Type: string
usd
Type: string
atl
Type: object

coin all time low (atl) in currency

btc
Type: number
eur
Type: number
usd
Type: number
atl_change_percentage
Type: object

coin all time low (atl) change in percentage

btc
Type: number
eur
Type: number
usd
Type: number
atl_date
Type: object

coin all time low (atl) date

btc
Type: string
eur
Type: string
usd
Type: string
circulating_supply
Type: number

coin circulating supply

current_price
Type: object

coin current price in currency

btc
Type: number
eur
Type: number
usd
Type: number
fdv_to_tvl_ratio
Type: number nullable

fully diluted valuation to total value locked ratio

fully_diluted_valuation
Type: object

coin fully diluted valuation (fdv) in currency

btc
Type: number
eur
Type: number
usd
Type: number
high_24h
Type: object

coin 24hr price high in currency

btc
Type: number
eur
Type: number
usd
Type: number
last_updated
Type: string Format: date-time

coin market data last updated timestamp

low_24h
Type: object

coin 24hr price low in currency

btc
Type: number
eur
Type: number
usd
Type: number
market_cap
Type: object

coin market cap in currency

btc
Type: number
eur
Type: number
usd
Type: number
market_cap_change_24h
Type: number

coin 24hr market cap change in currency

market_cap_change_24h_in_currency
Type: object

coin 24hr market cap change in currency

btc
Type: number
eur
Type: number
usd
Type: number
market_cap_change_percentage_24h
Type: number

coin 24hr market cap change in percentage

market_cap_change_percentage_24h_in_currency
Type: object

coin 24hr market cap change in percentage

btc
Type: number
eur
Type: number
usd
Type: number
market_cap_fdv_ratio
Type: number

market cap to fully diluted valuation ratio

market_cap_rank
Type: number

coin rank by market cap

market_cap_rank_with_rehypothecated
Type: number

coin rank by market cap including rehypothecated tokens

max_supply
Type: number nullable

coin max supply

max_supply_infinite
Type: boolean

whether max supply is infinite

mcap_to_tvl_ratio
Type: number nullable

market cap to total value locked ratio

outstanding_supply
Type: number nullable

tokens outstanding in the market, circulated/tradable or planned for circulation

outstanding_token_value_usd
Type: number nullable

outstanding token value in USD

price_change_24h
Type: number

coin 24hr price change in currency

price_change_24h_in_currency
Type: object

coin 24hr price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_14d
Type: number

coin 14d price change in percentage

price_change_percentage_14d_in_currency
Type: object

coin 14d price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_1h_in_currency
Type: object

coin 1h price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_1y
Type: number

coin 1y price change in percentage

price_change_percentage_1y_in_currency
Type: object

coin 1y price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_200d
Type: number

coin 200d price change in percentage

price_change_percentage_200d_in_currency
Type: object

coin 200d price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_24h
Type: number

coin 24hr price change in percentage

price_change_percentage_24h_in_currency
Type: object

coin 24hr price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_30d
Type: number

coin 30d price change in percentage

price_change_percentage_30d_in_currency
Type: object

coin 30d price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_60d
Type: number

coin 60d price change in percentage

price_change_percentage_60d_in_currency
Type: object

coin 60d price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
price_change_percentage_7d
Type: number

coin 7d price change in percentage

price_change_percentage_7d_in_currency
Type: object

coin 7d price change in currency

btc
Type: number
eur
Type: number
usd
Type: number
roi
Type: number nullable

coin return on investment

total_supply
Type: number

coin total supply

total_value_locked
Type: number nullable

total value locked

total_volume
Type: object

coin total trading volume in currency

btc
Type: number
eur
Type: number
usd
Type: number
name
Type: string

coin name

platforms
Type: object

coin asset platform and contract address

propertyName
Type: anything nullable
preview_listing
Type: boolean

preview listing coin

public_notice
Type: string nullable

public notice

sentiment_votes_down_percentage
Type: number

coin sentiment votes down percentage

sentiment_votes_up_percentage
Type: number

coin sentiment votes up percentage

status_updates
Type: array string[]

coin status updates

symbol
Type: string

coin symbol

tickers
Type: array object[]

coin tickers

base
Type: string

coin ticker base currency

bid_ask_spread_percentage
Type: number

coin ticker bid ask spread percentage

coin_id
Type: string

coin ticker base currency coin ID

coin_mcap_usd
Type: number

coin market cap in USD

converted_last
Type: object

coin ticker converted last price

btc
Type: number
eth
Type: number
usd
Type: number
converted_volume
Type: object

coin ticker converted volume

btc
Type: number
eth
Type: number
usd
Type: number
is_anomaly
Type: boolean

coin ticker anomaly

is_stale
Type: boolean

coin ticker stale

last
Type: number

coin ticker last price

last_fetch_at
Type: string Format: date-time

coin ticker last fetch timestamp

last_traded_at
Type: string Format: date-time

coin ticker last traded timestamp

market
Type: object

coin ticker exchange

has_trading_incentive
Type: boolean

coin ticker exchange trading incentive

identifier
Type: string

coin ticker exchange identifier

name
Type: string

coin ticker exchange name

target
Type: string

coin ticker target currency

target_coin_id
Type: string

coin ticker target currency coin ID

timestamp
Type: string Format: date-time

coin ticker timestamp

token_info_url
Type: string nullable

coin ticker token info url

trade_url
Type: string nullable

coin ticker trade url

trust_score
Type: string nullable

coin ticker trust score

volume
Type: number

coin ticker volume

watchlist_portfolio_users
Type: number

number of users watching this coin in portfolio

web_slug
Type: string

coin web slug
application/json
400

The request could not be processed. Check the request parameters.
401

A valid Felo API key is required.
402

The request cannot proceed because a billing requirement is not met.
403

The account is not permitted to perform this operation.
429

A request or spending limit has been reached.
502

The service could not complete the request.
503

The API or billing service is temporarily unavailable.
504

The service timed out while processing the request.
default

The operation failed. Keep the response request ID when contacting Felo support.

get/v1/beta/coingecko/coins/{id}/contract/{contract_address}

curl https://openapi.felo.ai/v1/beta/coingecko/coins/ethereum/contract/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "id": "usd-coin",
  "symbol": "usdc",
  "name": "USDC",
  "web_slug": "usdc",
  "asset_platform_id": "ethereum",
  "platforms": {
    "ethereum": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "polkadot": "1337",
    "flow": "A.b19436aae4d94622.FiatToken",

Get current data for a coin.

Coin Data by Token Address

AuthenticationRequired

CoinGecko

Coin Data by Token Address