Felo API PlatformFelo API Platform
CoinGecko 전체 엔드포인트
v0.2.0-beta
OpenAPI 3.1.0

토큰 주소로 코인 데이터 조회

서버:https://openapi.felo.ai
클라이언트 라이브러리

CoinGecko

​

Cryptocurrency prices, market data and historical series.

토큰 주소로 코인 데이터 조회

​

CoinGecko id 대신 컨트랙트 주소로 조회하는 전체 코인 프로필입니다. id는 자산 플랫폼, contract_address는 토큰이며 둘 다 필수이고 다른 매개변수는 없습니다. get_coingecko_coins_id와 같은 형태(description, links, image, categories, platforms, detail_platforms, market_cap_rank, market_data 블록, 내장 tickers 배열)에 contract_address 자체를 더해 반환합니다. 주소로 알 수 없는 토큰을 식별할 때 사용하세요. 현재 가격만 필요하다면 get_coingecko_simple_token_price_id가 훨씬 가볍습니다.

가격 참고

  • 과금 방식: 플랜 리소스 단위.
  • 참조 요청 추정치: USD 0.008.
  • 단위 원가 기준: USD 0.0.
  • 리소스 단위: provider_credit.
  • 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다.

참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

경로 매개변수
  • contract_address
    유형: string
    필수

    토큰의 컨트랙트 주소입니다.

  • id
    유형: string
    필수

    자산 플랫폼 ID입니다. *참조: /asset_platforms.

응답
  • 200
    유형: object · Response860C3Ae68Ea5_CoinsContractAddress

    토큰 컨트랙트 주소로 코인 데이터 조회

    • additional_notices
      유형: array string[]
      필수

      추가 공지

    • asset_platform_id
      유형: string | null
      필수

      코인 자산 플랫폼 ID

    • block_time_in_minutes
      유형: number
      필수

      블록체인 블록 시간(분)

    • categories
      유형: array string[]
      필수

      코인 카테고리

    • contract_address
      유형: string
      필수

      코인 컨트랙트 주소

    • country_origin
      유형: string
      필수

      원산지 국가

    • description
      유형: object
      필수

      코인 설명

      • propertyName
        유형: string
    • detail_platforms
      유형: object
      필수

      상세 코인 자산 플랫폼 및 컨트랙트 주소

      • propertyName
        유형: object
        • contract_address
          유형: string

          토큰 컨트랙트 주소

        • decimal_place
          유형: integer | null

          토큰 소수 자릿수

        • geckoterminal_url
          유형: string

          GeckoTerminal URL

    • genesis_date
      유형: string | null
      필수

      제네시스 날짜

    • has_supply_breakdown
      유형: boolean
      필수

      /coins/supply_breakdown을 통해 상세 공급 내역 데이터를 사용할 수 있는지 여부

    • hashing_algorithm
      유형: string | null
      필수

      블록체인 해싱 알고리즘

    • id
      유형: string
      필수

      코인 ID

    • image
      유형: object
      필수

      코인 이미지 URL

      • large
        유형: string
      • small
        유형: string
      • thumb
        유형: string
    • last_updated
      유형: string
      필수

      마지막 업데이트 타임스탬프

    • 유형: object
      필수

      링크

      • announcement_url
        유형: array string[]

        공지 URL

      • bitcointalk_thread_identifier
        유형: integer | null

        Bitcointalk 스레드 식별자

      • blockchain_site
        유형: array string[]

        블록 탐색기 URL

      • chat_url
        유형: array string[]

        채팅 URL

      • facebook_username
        유형: string

        Facebook 사용자 이름

      • homepage
        유형: array string[]

        웹사이트 URL

      • official_forum_url
        유형: array string[]

        공식 포럼 URL

      • repos_url
        유형: object

        리포지토리 URL

        • bitbucket
          유형: array string[]

          Bitbucket 리포지토리 URL

        • github
          유형: array string[]

          GitHub 리포지토리 URL

      • snapshot_url
        유형: string | null

        스냅샷 URL

      • subreddit_url
        유형: string | null

        Subreddit URL

      • telegram_channel_identifier
        유형: string

        Telegram 채널 식별자

      • twitter_screen_name
        유형: string

        Twitter 핸들

      • whitepaper
        유형: string

        백서 URL

    • market_cap_rank
      유형: integer | null
      필수

      시가총액 순위

    • market_cap_rank_with_rehypothecated
      유형: integer | null
      필수

      재담보 토큰을 포함한 시가총액 순위

    • name
      유형: string
      필수

      코인 이름

    • platforms
      유형: object
      필수

      코인 자산 플랫폼 및 컨트랙트 주소

      • propertyName
        유형: string
    • preview_listing
      유형: boolean
      필수

      미리보기 리스팅 코인

    • public_notice
      유형: string | null
      필수

      공개 공지

    • sentiment_votes_down_percentage
      유형: number | null
      필수

      센티먼트 투표 부정 비율

    • sentiment_votes_up_percentage
      유형: number | null
      필수

      센티먼트 투표 긍정 비율

    • status_updates
      유형: array object[]
      필수

      상태 업데이트

      • category
        유형: string

        상태 업데이트 카테고리

      • created_at
        유형: string

        상태 업데이트 생성 시각

      • description
        유형: string

        상태 업데이트 설명

      • user
        유형: string

        상태 업데이트 사용자

      • user_title
        유형: string

        상태 업데이트 사용자 직함

    • symbol
      유형: string
      필수

      코인 심볼

    • watchlist_portfolio_users
      유형: number
      필수

      포트폴리오에서 이 코인을 지켜보는 사용자 수

    • web_slug
      유형: string
      필수

      코인 웹 슬러그

    • localization
      유형: object

      코인 이름 현지화

      • propertyName
        유형: string
    • market_data
      유형: object

      마켓 데이터

      • ath
        유형: object

        대상 통화 기준 사상 최고가

        • propertyName
          유형: number
      • ath_change_percentage
        유형: object

        사상 최고가 대비 변화율

        • propertyName
          유형: number
      • ath_date
        유형: object

        사상 최고가 날짜

        • propertyName
          유형: string
      • atl
        유형: object

        대상 통화 기준 사상 최저가

        • propertyName
          유형: number
      • atl_change_percentage
        유형: object

        사상 최저가 대비 변화율

        • propertyName
          유형: number
      • atl_date
        유형: object

        사상 최저가 날짜

        • propertyName
          유형: string
      • circulating_supply
        유형: number

        유통 공급량

      • current_price
        유형: object

        대상 통화 기준 현재 가격

        • propertyName
          유형: number
      • fdv_to_tvl_ratio
        유형: number | null

        FDV 대비 TVL 비율

      • fully_diluted_valuation
        유형: object

        대상 통화 기준 완전 희석 가치

        • propertyName
          유형: number
      • high_24h
        유형: object

        대상 통화 기준 24시간 최고가

        • propertyName
          유형: number
      • last_updated
        유형: string

        시장 데이터 최근 업데이트 타임스탬프

      • low_24h
        유형: object

        대상 통화 기준 24시간 최저가

        • propertyName
          유형: number
      • market_cap
        유형: object

        대상 통화 기준 시가총액

        • propertyName
          유형: number
      • market_cap_change_24h
        유형: number

        대상 통화 기준 24시간 시가총액 변동

      • market_cap_change_24h_in_currency
        유형: object

        대상 통화 기준 24시간 시가총액 변동

        • propertyName
          유형: number
      • market_cap_change_percentage_24h
        유형: number

        24시간 시가총액 변동률

      • market_cap_change_percentage_24h_in_currency
        유형: object

        통화별 24시간 시가총액 변동률

        • propertyName
          유형: number
      • market_cap_fdv_ratio
        유형: number

        시가총액 대비 FDV 비율

      • market_cap_rank
        유형: integer | null

        시가총액 순위

      • market_cap_rank_with_rehypothecated
        유형: integer | null

        재담보 토큰을 포함한 시가총액 순위

      • max_supply
        유형: number | null

        최대 공급량

      • max_supply_infinite
        유형: boolean

        최대 공급량 무한 여부

      • mcap_to_tvl_ratio
        유형: number | null

        시가총액 대비 TVL 비율

      • outstanding_supply
        유형: number | null

        시장에 유통 중인 토큰

      • outstanding_token_value_usd
        유형: number | null

        유통 토큰 가치(USD)

      • price_change_24h
        유형: number

        대상 통화 기준 24시간 가격 변동

      • price_change_24h_in_currency
        유형: object

        대상 통화 기준 24시간 가격 변동

        • propertyName
          유형: number
      • price_change_percentage_14d
        유형: number

        14일 가격 변동률

      • price_change_percentage_14d_in_currency
        유형: object

        통화별 14일 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_1h_in_currency
        유형: object

        통화별 1시간 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_1y
        유형: number

        1년 가격 변동률

      • price_change_percentage_1y_in_currency
        유형: object

        통화별 1년 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_200d
        유형: number

        200일 가격 변동률

      • price_change_percentage_200d_in_currency
        유형: object

        통화별 200일 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_24h
        유형: number

        24시간 가격 변동률

      • price_change_percentage_24h_in_currency
        유형: object

        통화별 24시간 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_30d
        유형: number

        30일 가격 변동률

      • price_change_percentage_30d_in_currency
        유형: object

        통화별 30일 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_60d
        유형: number

        60일 가격 변동률

      • price_change_percentage_60d_in_currency
        유형: object

        통화별 60일 가격 변동률

        • propertyName
          유형: number
      • price_change_percentage_7d
        유형: number

        7일 가격 변동률

      • price_change_percentage_7d_in_currency
        유형: object

        통화별 7일 가격 변동률

        • propertyName
          유형: number
      • roi
        유형: object | null

        투자 수익률

        • currency
          유형: string

          ROI 통화

        • percentage
          유형: number

          ROI 비율

        • times
          유형: number

          ROI 배수

      • sparkline_7d
        유형: array number[]

        스파크라인 7일 가격 데이터

      • total_supply
        유형: number

        총 공급량

      • total_value_locked
        유형: number | null

        예치 총액

      • total_volume
        유형: object

        대상 통화 기준 총 거래량

        • propertyName
          유형: number
    • tickers
      유형: array object[]

      티커

      • base
        유형: string

        티커 기준 통화

      • bid_ask_spread_percentage
        유형: number

        티커 매수-매도 호가 스프레드 비율

      • coin_id
        유형: string

        티커 기준 통화 코인 ID

      • coin_mcap_usd
        유형: number

        시가총액(USD)

      • converted_last
        유형: object

        티커 환산 최근 가격

        • btc
          유형: number
        • eth
          유형: number
        • usd
          유형: number
      • converted_volume
        유형: object

        티커 환산 거래량

        • btc
          유형: number
        • eth
          유형: number
        • usd
          유형: number
      • is_anomaly
        유형: boolean

        티커 이상 여부

      • is_stale
        유형: boolean

        티커 만료 여부

      • last
        유형: number

        티커 최근 가격

      • last_fetch_at
        유형: string

        티커 최근 조회 타임스탬프

      • last_traded_at
        유형: string

        티커 최근 거래 타임스탬프

      • market
        유형: object

        티커 거래소

        • has_trading_incentive
          유형: boolean

          거래소 거래 인센티브

        • identifier
          유형: string

          거래소 식별자

        • name
          유형: string

          거래소 이름

      • target
        유형: string

        티커 대상 통화

      • target_coin_id
        유형: string

        티커 대상 통화 코인 ID

      • timestamp
        유형: string

        티커 타임스탬프

      • token_info_url
        유형: string | null

        티커 토큰 정보 URL

      • trade_url
        유형: string

        티커 거래 URL

      • trust_score
        유형: string | null

        티커 신뢰 점수

      • volume
        유형: number

        티커 거래량

    application/json
  • 400

    요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

  • 401

    유효한 Felo API 키가 필요합니다.

  • 402

    청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

  • 403

    이 계정에는 이 작업을 수행할 권한이 없습니다.

  • 429

    요청 또는 지출 한도에 도달했습니다.

  • 502

    서비스가 요청을 완료할 수 없습니다.

  • 503

    API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

  • 504

    요청을 처리하는 동안 서비스 시간이 초과되었습니다.

  • default

    오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

    application/json
Request Example for get/v1/beta/coingecko/coins/{id}/contract/{contract_address}
curl https://openapi.felo.ai/v1/beta/coingecko/coins/ethereum/contract/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "weth",
  "symbol": "weth",
  "name": "WETH",
  "web_slug": "weth",
  "asset_platform_id": "ethereum",
  "platforms": {
    "ethereum": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "terra-2": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674",
    "tron": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
  },
  "detail_platforms": {
    "ethereum": {
      "decimal_place": 18,
      "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "geckoterminal_url": "https://www.geckoterminal.com/eth/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    "terra-2": {
      "decimal_place": 18,
      "contract_address": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674"
    },
    "tron": {
      "decimal_place": 18,
      "contract_address": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF",
      "geckoterminal_url": "https://www.geckoterminal.com/tron/tokens/THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
    }
  },
  "block_time_in_minutes": 0,
  "hashing_algorithm": null,
  "categories": [
    "Crypto-Backed Tokens",
    "Wrapped-Tokens",
    "Terra Ecosystem",
    "Ethereum Ecosystem",
    "FTX Holdings",
    "Tron Ecosystem",
    "Index Coop Defi Index"
  ],
  "preview_listing": false,
  "public_notice": null,
  "additional_notices": [],
  "has_supply_breakdown": false,
  "localization": {
    "en": "WETH",
    "de": "",
    "es": "",
    "fr": "",
    "it": "",
    "pl": "",
    "ro": "",
    "hu": "",
    "nl": "",
    "pt": ""
  },
  "description": {
    "en": "What is WETH (Wrapped ETH)?\nWETH is the tokenized/packaged form of ETH..."
  },
  "links": {
    "homepage": [
      "https://ethereum.org/en/wrapped-eth"
    ],
    "whitepaper": "",
    "blockchain_site": [
      "https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "https://intel.arkm.com/explorer/token/weth"
    ],
    "official_forum_url": [],
    "chat_url": [],
    "announcement_url": [],
    "snapshot_url": null,
    "twitter_screen_name": "",
    "facebook_username": "",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "",
    "subreddit_url": null,
    "repos_url": {
      "github": [],
      "bitbucket": []
    }
  },
  "image": {
    "thumb": "https://coin-images.coingecko.com/coins/images/2518/thumb/weth.png?1696503332",
    "small": "https://coin-images.coingecko.com/coins/images/2518/small/weth.png?1696503332",
    "large": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332"
  },
  "country_origin": "",
  "genesis_date": "2016-06-17",
  "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "sentiment_votes_up_percentage": null,
  "sentiment_votes_down_percentage": null,
  "watchlist_portfolio_users": 34782,
  "market_cap_rank": null,
  "market_cap_rank_with_rehypothecated": 30,
  "market_data": {
    "current_price": {
      "btc": 0.02728343,
      "eth": 0.99972363,
      "usd": 2115.04
    },
    "total_value_locked": null,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null,
    "roi": null,
    "ath": {
      "btc": 0.14280504,
      "eth": 3.614831,
      "usd": 4950.08
    },
    "ath_change_percentage": {
      "btc": -80.89678,
      "eth": -72.33124,
      "usd": -57.2622
    },
    "ath_date": {
      "btc": "2018-09-02T00:00:00.000Z",
      "eth": "2018-09-13T00:00:00.000Z",
      "usd": "2025-08-24T19:28:11.411Z"
    },
    "atl": {
      "btc": 0.00890197,
      "eth": 0.22395179,
      "usd": 82.1
    },
    "atl_change_percentage": {
      "btc": 206.45314,
      "eth": 346.6045,
      "usd": 2476.69436
    },
    "atl_date": {
      "btc": "2025-09-02T07:56:48.935Z",
      "eth": "2025-09-02T07:56:48.935Z",
      "usd": "2018-12-15T00:00:00.000Z"
    },
    "market_cap": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_rank": null,
    "outstanding_token_value_usd": null,
    "market_cap_rank_with_rehypothecated": 30,
    "fully_diluted_valuation": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_fdv_ratio": 1,
    "total_volume": {
      "btc": 107.294,
      "eth": 3931,
      "usd": 8317546
    },
    "high_24h": {
      "btc": 0.02756131,
      "eth": 1.00272,
      "usd": 2125.08
    },
    "low_24h": {
      "btc": 0.02717062,
      "eth": 0.99799697,
      "usd": 2068.79
    },
    "price_change_24h": -3.316519511214,
    "price_change_percentage_24h": -0.15656,
    "price_change_percentage_7d": -0.0669,
    "price_change_percentage_14d": -9.45938,
    "price_change_percentage_30d": -8.82256,
    "price_change_percentage_60d": 1.63545,
    "price_change_percentage_200d": -37.57849,
    "price_change_percentage_1y": -14.56267,
    "market_cap_change_24h": -12121742.79577,
    "market_cap_change_percentage_24h": -0.25222,
    "price_change_24h_in_currency": {
      "btc": -0.000274386252168236,
      "eth": -0.000212661454704888,
      "usd": -3.3165195112137553
    },
    "price_change_percentage_1h_in_currency": {
      "btc": -0.19183,
      "eth": 0.00019,
      "usd": -0.00865
    },
    "price_change_percentage_24h_in_currency": {
      "btc": -0.99568,
      "eth": -0.02127,
      "usd": -0.15656
    },
    "price_change_percentage_7d_in_currency": {
      "btc": -0.89914,
      "eth": -0.05304,
      "usd": -0.0669
    },
    "price_change_percentage_14d_in_currency": {
      "btc": -5.49184,
      "eth": -0.04201,
      "usd": -9.45938
    },
    "price_change_percentage_30d_in_currency": {
      "btc": -8.68383,
      "eth": -0.02751,
      "usd": -8.82256
    },
    "price_change_percentage_60d_in_currency": {
      "btc": -8.8249,
      "eth": 0.0505,
      "usd": 1.63545
    },
    "price_change_percentage_200d_in_currency": {
      "btc": -17.15793,
      "eth": -0.10813,
      "usd": -37.57849
    },
    "price_change_percentage_1y_in_currency": {
      "btc": 18.09057,
      "eth": 0.19761,
      "usd": -14.56267
    },
    "market_cap_change_24h_in_currency": {
      "btc": -635.7460114267669,
      "eth": -986.7877555103041,
      "usd": -12121742.795770645
    },
    "market_cap_change_percentage_24h_in_currency": {
      "btc": -1.01713,
      "eth": -0.0435,
      "usd": -0.25222
    },
    "total_supply": 2267926.915444636,
    "max_supply": null,
    "max_supply_infinite": true,
    "circulating_supply": 2267926.915444636,
    "outstanding_supply": null,
    "last_updated": "2026-05-25T10:09:02.821Z"
  },
  "status_updates": [],
  "last_updated": "2026-05-25T10:09:02.821Z",
  "tickers": [
    {
      "base": "WETH",
      "target": "USDC",
      "market": {
        "name": "Native",
        "identifier": "native",
        "has_trading_incentive": false
      },
      "last": 2114.7318378964214,
      "volume": 2999.739679821518,
      "converted_last": {
        "btc": 0.02728106,
        "eth": 1.000065,
        "usd": 2114.1
      },
      "converted_volume": {
        "btc": 81.256,
        "eth": 2979,
        "usd": 6296774
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.04287,
      "timestamp": "2026-05-25T10:04:42+00:00",
      "last_traded_at": "2026-05-25T10:04:42+00:00",
      "last_fetch_at": "2026-05-25T10:04:42+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://native.org/app/swap/",
      "token_info_url": null,
      "coin_id": "weth",
      "target_coin_id": "usd-coin",
      "coin_mcap_usd": 4793905265.563903
    }
  ]
}
Coin Data by Token Address

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.