CoinGecko
Cryptocurrency prices, market data and historical series.
코인 시장
한 번의 호출로 많은 코인을 다루는 순위 시장 표입니다. 코인당 한 행에 current_price, market_cap, market_cap_rank, total_volume, high_24h, low_24h, price_change_percentage_24h, circulating_supply, total_supply, max_supply, 날짜가 포함된 ath와 atl, image가 들어갑니다. per_page와 page로 페이지를 나누고, order(시가총액, 거래량 또는 id, 오름차순/내림차순)로 정렬하며, ids 또는 category로 좁히세요. price_change_percentage를 전달하면 해당하는 price_change_percentage_24h_in_currency 필드가 추가됩니다. 리더보드와 세그먼트 스캔에 사용하세요. 몇 개의 알려진 코인 가격은 get_coingecko_simple_price가 훨씬 가볍고, 한 코인의 전체 정보는 get_coingecko_coins_id를 사용하세요.
가격 참고
- 과금 방식: 플랜 리소스 단위.
- 참조 요청 추정치: USD 0.008.
- 단위 원가 기준: USD 0.0.
- 리소스 단위:
provider_credit. - 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다.
참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringcategory
코인 카테고리를 기준으로 필터링합니다. *참조:
/coins/categories/list - 유형: stringids
코인 ID입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다. *참조:
/coins/list - 유형: booleaninclude
_rehypothecated 결과에 재담보화된(rehypothecated) 토큰을 포함합니다. true이면
market_cap_rank_with_rehypothecated필드를 반환합니다. 기본값: false - 유형: string 열거형include
_tokens symbols조회에서는all을 지정해 일치하는 모든 토큰을 포함할 수 있습니다. 기본값top은 시가총액 또는 거래량 기준 상위 토큰을 반환합니다.값- top
- all
- 유형: string 열거형locale
언어 배경입니다. 기본값: en
값- ar
- bg
- cs
- da
- de
- 유형: stringnames
코인 이름입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다.
- 유형: string 열거형order
필드별로 결과를 정렬합니다. 기본값: market_cap_desc
값- market
_cap _asc - market
_cap _desc - volume
_asc - volume
_desc - id
_asc - id
_desc
- 유형: integerpage
결과를 페이지 단위로 조회합니다. 기본값: 1
- 유형: integerper
_page 페이지당 총 결과 수입니다. 기본값: 100 유효한 값: 1...250
- 유형: string 열거형precision
통화 가격 값의 소수 자릿수
값- full
- 0
- 1
- 2
- 3
- 유형: stringprice
_change _percentage 가격 변동률 기간을 포함합니다. 기간을 2개 이상 조회할 때는 쉼표로 구분합니다. 유효한 값:
1h,24h,7d,14d,30d,200d,1y - 유형: booleansparkline
7일 스파크라인 데이터를 포함합니다. 기본값: false
- 유형: stringsymbols
코인 심볼입니다. 코인을 2개 이상 조회할 때는 쉼표로 구분합니다.
- 유형: stringvs
_currency 필수코인 및 시장 데이터의 대상 통화입니다. *참조:
/simple/supported_vs_currencies
- 유형: array object[] · Response860C3Ae68Ea5_CoinsMarkets200
시장 데이터가 포함된 코인 목록
- ath유형: number | null필수
대상 통화 기준 사상 최고가
- ath유형: number | null
_change _percentage 필수사상 최고가 대비 변화율
- ath유형: string | null 형식: date-time
_date 필수사상 최고가 날짜
- atl유형: number | null필수
대상 통화 기준 사상 최저가
- atl유형: number | null
_change _percentage 필수사상 최저가 대비 변화율
- atl유형: string | null 형식: date-time
_date 필수사상 최저가 날짜
- circulating유형: number | null
_supply 필수유통 공급량
- current유형: number | null
_price 필수대상 통화 기준 현재 가격
- fully유형: number | null
_diluted _valuation 필수대상 통화 기준 완전 희석 가치
- high유형: number | null
_24h 필수대상 통화 기준 24시간 최고가
- id유형: string필수
코인 ID
- image유형: string필수
코인 이미지 URL
- last유형: string 형식: date-time
_updated 필수마지막 업데이트 타임스탬프
- low유형: number | null
_24h 필수대상 통화 기준 24시간 최저가
- market유형: number | null
_cap 필수대상 통화 기준 시가총액
- market유형: number | null
_cap _change _24h 필수대상 통화 기준 24시간 시가총액 변동
- market유형: number | null
_cap _change _percentage _24h 필수24시간 시가총액 변동률
- market유형: integer | null
_cap _rank 필수시가총액 순위
- max유형: number | null
_supply 필수최대 공급량
- name유형: string필수
코인 이름
- price유형: number | null
_change _24h 필수대상 통화 기준 24시간 가격 변동
- price유형: number | null
_change _percentage _24h 필수24시간 가격 변동률
- roi유형: object | null필수
투자 수익률 데이터
- currency유형: string
ROI 통화
- percentage유형: number
ROI 비율
- times유형: number
ROI 배수
- symbol유형: string필수
코인 심볼
- total유형: number | null
_supply 필수총 공급량
- total유형: number | null
_volume 필수대상 통화 기준 총 거래량
- market유형: integer | null
_cap _rank _with _rehypothecated 재담보 토큰을 포함한 시가총액 순위
- price유형: number | null
_change _percentage _14d _in _currency 대상 통화 기준 14일 가격 변동률
- price유형: number | null
_change _percentage _1h _in _currency 대상 통화 기준 1시간 가격 변동률
- price유형: number | null
_change _percentage _1y _in _currency 대상 통화 기준 1년 가격 변동률
- price유형: number | null
_change _percentage _200d _in _currency 대상 통화 기준 200일 가격 변동률
- price유형: number | null
_change _percentage _24h _in _currency 대상 통화 기준 24시간 가격 변동률
- price유형: number | null
_change _percentage _30d _in _currency 대상 통화 기준 30일 가격 변동률
- price유형: number | null
_change _percentage _7d _in _currency 대상 통화 기준 7일 가격 변동률
- sparkline유형: object
_in _7d 최근 7일 스파크라인 가격 데이터
- price유형: array number[]
가격 값 배열
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/markets?vs_currency=usd' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
"current_price": 77671,
"market_cap": 1555886872303,
"market_cap_rank": 1,
"fully_diluted_valuation": 1555914058873,
"total_volume": 33235034316,
"high_24h": 78419,
"low_24h": 76696,
"price_change_24h": -747.3360347281705,
"price_change_percentage_24h": -0.95302,
"market_cap_change_24h": -15184401491.513184,
"market_cap_change_percentage_24h": -0.9665,
"circulating_supply": 20030493,
"total_supply": 20030843,
"max_supply": 21000000,
"ath": 126080,
"ath_change_percentage": -38.39571,
"ath_date": "2025-10-06T18:57:42.558Z",
"atl": 67.81,
"atl_change_percentage": 114443.23093,
"atl_date": "2013-07-06T00:00:00.000Z",
"roi": null,
"last_updated": "2026-05-18T12:49:21.599Z",
"market_cap_rank_with_rehypothecated": 1,
"sparkline_in_7d": {
"price": [
81045.84776489827,
81001.73089268175,
80898.20817826076
]
},
"price_change_percentage_1h_in_currency": 0.5823392426906319,
"price_change_percentage_24h_in_currency": -0.9530164743774191,
"price_change_percentage_7d_in_currency": -4.042267423689584,
"price_change_percentage_14d_in_currency": -1.5720857443461431,
"price_change_percentage_30d_in_currency": 1.9453890367549207,
"price_change_percentage_200d_in_currency": -29.452371850925864,
"price_change_percentage_1y_in_currency": -25.214612207475373
}
]