암호화폐 시장 데이터 API
특정 거래소에 종속되지 않은 암호화폐 시장 데이터입니다. token_price와 token_chart는 컨트랙트 주소나 코인 ID로 토큰 가격을 조회하고, token_ranking은 시가총액, 24시간 변동률 또는 거래량 기준으로 토큰 순위를 매깁니다. tokenomics는 토큰의 언락 일정을 조회하고, tge_status는 프로젝트의 토큰 출시 여부를 알려줍니다.
토큰은 chain:contract-address(예: ethereum:0xdac1...) 또는 coingecko:id(예: coingecko:bitcoin) 형식으로 입력합니다. 가격은 여러 거래소와 온체인 데이터를 집계한 값이므로 특정 거래소의 최종 체결가가 아닙니다. confidence는 해당 가격을 뒷받침하는 거래 규모를 나타냅니다.
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 암호화폐 시장 데이터 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
토큰 가격token_price | 컨트랙트 주소나 코인 ID로 최대 20개 토큰의 가격을 한 번에 조회하며, 심볼, 가격 기준 시각, 신뢰도 점수가 포함됩니다. | 요청 1,000개당 $1.39 | 정상 |
토큰 가격 추이token_chart | 컨트랙트 주소나 코인 ID로 토큰 하나의 가격 이력을 읽습니다. | 요청 1,000개당 $1.39 | 정상 |
토큰 순위token_ranking | 시가총액, 24시간 변동률 또는 24시간 거래량 기준으로 토큰 순위를 매기며, MEME, AI, L2 같은 카테고리로 범위를 좁힐 수 있습니다. | 요청 1,000개당 $9.6 | 정상 |
토큰 언락 일정tokenomics | 심볼로 토큰의 일별 언락 일정을 읽습니다. | 요청 1,000개당 $9.6 | 정상 |
토큰 생성 이벤트(TGE) 현황tge_status | 프로젝트의 토큰 출시 여부, 마지막 토큰 생성 이벤트 시점, 상장된 거래소를 확인합니다. | 요청 1,000개당 $9.6 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
암호화폐 시장 데이터 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
token_price토큰 가격 컨트랙트 주소나 코인 ID로 최대 20개 토큰의 가격을 한 번에 조회하며, 심볼, 가격 기준 시각, 신뢰도 점수가 포함됩니다. 가격을 산정할 수 없는 토큰은 제외됩니다. | token | — | Sync 응답 | — | 요청 1,000개당 $1.39 | token · symbol · price_usd · price_at · decimals · confidence · platform |
token_chart토큰 가격 추이 컨트랙트 주소나 코인 ID로 토큰 하나의 가격 이력을 읽습니다. 5분에서 1주 간격의 데이터 포인트를 현재 시점까지 최대 500개 제공합니다. | token | period | Sync 응답 | 카탈로그 값: defaultLimit=30, maxLimit=500. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | token · symbol · price_usd · price_at · confidence · platform |
token_ranking토큰 순위 시가총액, 24시간 변동률 또는 24시간 거래량 기준으로 토큰 순위를 매기며, MEME, AI, L2 같은 카테고리로 범위를 좁힐 수 있습니다. 가격, 가격 범위, 시가총액, FDV, 공급량, 역대 최고가와 최저가가 포함됩니다. | category, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $9.6 | rank · slug · symbol · name · price_usd · change_24h_pct · market_cap_usd · volume_24h_usd · high_24h_usd · low_24h_usd · fdv_usd · circulating_supply · total_supply · max_supply · ath_usd · ath_at · atl_usd · atl_at · platform | |
tokenomics토큰 언락 일정 심볼로 토큰의 일별 언락 일정을 읽습니다. 누적 언락 수량, 총 공급량 대비 비율, 투자자나 팀 같은 용도별 언락 수량이 포함됩니다. | symbol | from, to | Sync 응답 | — | 요청 1,000개당 $9.6 | symbol · date · cumulative_unlocked · circulating_supply · total_supply · max_supply · unlocked_pct · allocations · platform |
tge_status토큰 생성 이벤트(TGE) 현황 프로젝트의 토큰 출시 여부, 마지막 토큰 생성 이벤트 시점, 상장된 거래소를 확인합니다. | keyword | — | Sync 응답 | — | 요청 1,000개당 $9.6 | project_name · status · last_event_at · exchanges · platform |
암호화폐 시장 데이터 token_price 파라미터는 각각 무엇을 의미하나요?
컨트랙트 주소나 코인 ID로 최대 20개 토큰의 가격을 한 번에 조회하며, 심볼, 가격 기준 시각, 신뢰도 점수가 포함됩니다. 가격을 산정할 수 없는 토큰은 제외됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태token필수- 토큰은
chain:contract-address(예:ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7) 또는coingecko:id(예:coingecko:bitcoin) 형식으로 지정합니다.token_price는 쉼표로 구분해 최대 20개까지,token_chart는 정확히 1개를 받습니다. 다른 형식은 과금 전에 거부됩니다.ethereum.org: ERC-20 토큰 표준 — Ethereum 공식 개발자 문서에 따르면 ERC-20 토큰은 체인에 배포된 컨트랙트이며 컨트랙트 주소로 식별됩니다. `token`의 chain:contract-address 형식이 가리키는 것이 바로 이 주소입니다. 가격은 거래 데이터를 집계한 값이며 이 자료의 범위에 포함되지 않습니다. · 확인일
암호화폐 시장 데이터 token_chart 파라미터는 각각 무엇을 의미하나요?
컨트랙트 주소나 코인 ID로 토큰 하나의 가격 이력을 읽습니다. 5분에서 1주 간격의 데이터 포인트를 현재 시점까지 최대 500개 제공합니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태token필수- 토큰은
chain:contract-address(예:ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7) 또는coingecko:id(예:coingecko:bitcoin) 형식으로 지정합니다.token_price는 쉼표로 구분해 최대 20개까지,token_chart는 정확히 1개를 받습니다. 다른 형식은 과금 전에 거부됩니다.ethereum.org: ERC-20 토큰 표준 — Ethereum 공식 개발자 문서에 따르면 ERC-20 토큰은 체인에 배포된 컨트랙트이며 컨트랙트 주소로 식별됩니다. `token`의 chain:contract-address 형식이 가리키는 것이 바로 이 주소입니다. 가격은 거래 데이터를 집계한 값이며 이 자료의 범위에 포함되지 않습니다. · 확인일 period선택token_chart데이터 포인트의 간격으로, 5m, 15m, 1h, 4h, 12h, 1d(기본값), 1w 중 하나입니다.허용 값:12h15m1d1h1w4h5m
암호화폐 시장 데이터 token_ranking 파라미터는 각각 무엇을 의미하나요?
시가총액, 24시간 변동률 또는 24시간 거래량 기준으로 토큰 순위를 매기며, MEME, AI, L2 같은 카테고리로 범위를 좁힐 수 있습니다. 가격, 가격 범위, 시가총액, FDV, 공급량, 역대 최고가와 최저가가 포함됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태category선택token_ranking을 한 카테고리로 제한합니다: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO, LST.허용 값:aiai_agentsbase_ecodefidepingamingl1l2lstmemerwasol_ecostablecoinsort선택token_ranking의 정렬 순서로, market_cap(기본값), change_24h(시가총액 상위 250개 내에서 순위 산정), volume_24h 중 하나입니다.허용 값:change_24hmarket_capvolume_24h
암호화폐 시장 데이터 tokenomics 파라미터는 각각 무엇을 의미하나요?
심볼로 토큰의 일별 언락 일정을 읽습니다. 누적 언락 수량, 총 공급량 대비 비율, 투자자나 팀 같은 용도별 언락 수량이 포함됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태symbol필수tokenomics에 사용할 토큰 심볼입니다(예: ARB, OP, APT).from선택tokenomics의 시작 날짜(YYYY-MM-DD)입니다.from과to를 생략하면 이번 달 데이터를 반환합니다.to선택tokenomics의 종료 날짜(YYYY-MM-DD)입니다.
암호화폐 시장 데이터 tge_status 파라미터는 각각 무엇을 의미하나요?
프로젝트의 토큰 출시 여부, 마지막 토큰 생성 이벤트 시점, 상장된 거래소를 확인합니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수tge_status에 사용할 프로젝트 이름 또는 토큰 심볼입니다(예: monad, bitcoin).
암호화폐 시장 데이터 API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"crypto_market","action":"token_price","params":{"token":"<token>"}}'
암호화폐 시장 데이터 API 자주 묻는 질문
암호화폐 시장 데이터 API로 무엇을 가져올 수 있나요?
platform을 crypto_market 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 토큰 가격, 토큰 가격 추이, 토큰 순위, 토큰 언락 일정 및 토큰 생성 이벤트(TGE) 현황입니다. 각 액션 이름은 서로 다른 암호화폐 시장 데이터 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
암호화폐 시장 데이터 token_price 요청에는 어떤 입력이 필요한가요?
토큰은 chain:contract-address(예: ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7) 또는 coingecko:id(예: coingecko:bitcoin) 형식으로 지정합니다. token_price는 쉼표로 구분해 최대 20개까지, token_chart는 정확히 1개를 받습니다. 다른 형식은 과금 전에 거부됩니다. params 안의 token 필드로 전달하세요.
암호화폐 시장 데이터 token_price 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 token, symbol, price_usd 및 price_at입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 암호화폐 시장 데이터 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.