GuidesAPI Reference

Token Price API

토큰의 시장 가격 정보를 미국 달러와 대한민국 원화로 얻을 수 있습니다.

Suggest Edits

실시간으로 변동하는 토큰 가격 정보를 거래소에서 불러옵니다. 토큰 가격은 원하는 통화(미국 달러/원화)로 변환하여 사용할 수 있습니다.

Token Price API로 무엇을 만들 수 있나요?

  • 가상 자산 포트폴리오: 사용자들이 자신의 가상 자산을 추적할 수 있는 앱을 개발할 수 있습니다.
    API를 이용하여 앱에서 각 가상 자산의 실시간 가격 정보를 제공해 보세요.

  • 암호화폐 거래소: 암호화폐 거래소에서 사용자들은 거래하고자 하는 암호화폐의 실시간 가격 정보를 확인할 수 있습니다.
    API를 이용하여 앱에서 각 암호화폐의 가격 정보를 제공해 보세요.

  • 암호화폐 예측 모델: 암호화폐 시장에서 특정 토큰 가격을 예측하는 모델을 개발할 수 있습니다.
    API를 이용하여 실시간으로 토큰 가격 정보를 수집하여 모델 학습에 활용해 보세요.

  • 암호화폐 가격 비교 사이트: 암호화폐 시장에서 제공되는 여러 토큰 가격을 비교하여 사용자들에게 가장 유리한 거래를
    할 수 있는 정보를 제공하는 웹사이트를 개발할 수 있습니다. API를 이용하여 다양한 토큰의 가격 정보를 수집하여
    제공해 보세요.

지원 플랫폼

PlatformMainnetTestnet
Bitcoin✅❌
BNB Smart Chain✅❌
Ethereum✅❌
Klaytn✅❌
Polygon✅❌

지원 통화

미국 달러($), 원화(₩)

거래소 목록

하단에 있는 거래소에서 내림차 순으로 토큰 가격을 가져옵니다.
거래소는 다음과 같습니다:

  • CoinMarketCap
  • CoinGecko
  • Upbit
  • Bithumb
  • CoinOne
  • Korbit
  • Gopax

Token Price Endpoint

https://api.xplorer.tech/{coinSymbol}/token-price/{apiKey}

인증 및 권한

Token Price API를 사용하려면 먼저 API Key가 필요해요.
콘솔에서 프로젝트를 생성하면 API Key가 추가 된 Endpoint가 생성됩니다.
Endpoint을 복사하여 요청을 보냅니다.

2800

요청 방식

HTTP GET 메서드로 Token Price API를 요청합니다. 추가적으로 query parameter인 addresses에
원하시는 토큰 주소를 넣으면 가격 정보 조회가 가능합니다. 아래에서 세부적인 요청 방식을 확인해 보세요.

다음 예제처럼 query parameter로 addresses 값을 따로 첨부하지 않았을 경우,
Token Price API에서 디폴트 행동으로 플랫폼 코인 가격을 불러옵니다. 

curl -X 'GET' \
  'https://api.xplorer.tech/ETH/token-price/{apiKey}' \
  -H 'accept: */*'

다음과 같은 결과가 나옵니다.

{
  "prices": [
    {
      "token": {
        "name": "Ethereum",
        "symbol": "ETH",
        "decimals": 18,
        "address": "0x"
      },
      "usdPrice": "1760.7300000000000000000000",
      "krwPrice": "2306078.8864500957313745976246",
      "source": "CoinGecko"
    }
  ]

플랫폼 코인 정보를 조회하려면 addresses에 0x를 넣습니다.

curl -X 'GET' \
  'https://api.xplorer.tech/ETH/token-price/{apiKey}?addresses=0x' \
  -H 'accept: */*'

다음과 같은 결과가 나옵니다.

{
  "prices": [
    {
      "token": {
        "name": "Ethereum",
        "symbol": "ETH",
        "decimals": 18,
        "address": "0x"
      },
      "usdPrice": "1760.7300000000000000000000",
      "krwPrice": "2306078.8864500957313745976246",
      "source": "CoinGecko"
    }
  ]

addresses에 여러 개의 토큰 주소들을 넣으려면 띄어쓰기 없는 콤마로 구분해서 넣습니다.
띄어쓰기가 들어가면 잘못된 주소를 조회하게 되니 주의해 주세요.

아래 예제는 이더리움 코인과 테더 USD 토큰의 가격까지 조회하는 예제입니다.
콤마로 구분하되, 띄어쓰기가 없는 점을 참고해주세요.

curl -X 'GET' \
  'https://api.xplorer.tech/ETH/token-price/{apiKey}?addresses=0x,0xdAC17F958D2ee523a2206206994597C13D831ec7' \
  -H 'accept: */*'

다음과 같은 결과가 나옵니다.

{
  "prices": [
    {
      "token": {
        "name": "Ethereum",
        "symbol": "ETH",
        "decimals": 18,
        "address": "0x"
      },
      "usdPrice": "1760.7300000000000000000000",
      "krwPrice": "2305920.4094140584870411714837",
      "source": "CoinGecko"
    },
    {
      "token": {
        "name": "Tether USD",
        "symbol": "USDT",
        "decimals": 6,
        "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
      },
      "usdPrice": "1.0020000000000000000000",
      "krwPrice": "1312.25812602323275233298338",
      "source": "CoinGecko"
    }
  ]
}

테스트넷 프로젝트에서는 Token Price API를 쓸 수 없어요. 가격 정보는 메인넷에서만 유효합니다.


응답 형식

Token Price API의 응답 형식은 다음과 같습니다.

{
  "prices": [
    {
      "token": {
        "name": "string",
        "symbol": "string",
        "decimals": 0,
        "address": "string"
      },
      "usdPrice": "string",
      "krwPrice": "string",
      "source": "string"
    }
  ]
}

참고

Tracker 버튼을 누르시면 해당 플랫폼과 관련된 토큰 주소 조회 사이트로 이동하게 됩니다.
여기서 원하는 토큰 주소를 복사하여 Token Price API에서 쓰실 수 있습니다.

2800

Updated about 1 year ago