프롬프트 하나로 시작하세요.
에이전트에게 프롬프트 보내기
# 작업: DataMaxi+ API로 개발하기
Base URL https://api.datamaxiplus.com/api/v1
인증 헤더 전송 X-DTMX-APIKEY: <key> (환경 변수 DATAMAXI_API_KEY에서 읽을 것, 코드에 직접 쓰지 말 것)
과금 유료 호출은 모두 MCP와 함께 쓰는 선불 USD 잔액 하나에서 차감됩니다.
1 크레딧 = $0.0001. 성공한 응답만 과금됩니다.
충전 DataMaxi+ 대시보드 -> Billing (충전 단위: $10, $25, $100, $500, $1000, 구독 없음)
## 반드시 처리할 오류
402 Payment Required {"error": "insufficient balance, top up to continue"}
or {"error": "balance expired, top up to continue"}
-> 재시도를 멈추고 사용자에게 충전을 안내한 뒤 다시 진행.
429 Too Many Requests -> Retry-After 헤더만큼 기다릴 것. 과금 없음.
5xx -> 백오프로 재시도. 과금 없음.
모든 응답에 x-ratelimit-limit / x-ratelimit-remaining / x-ratelimit-reset 헤더가 있습니다.
## REST 엔드포인트 (성공한 호출당 가격)
GET /funding-rate/latest $0.0001 / call 필수: exchange, symbol
GET /ticker $0.0001 / call 필수: exchange, symbol, market
GET /premium $0.0001 / call
GET /open-interest $0.0001 / call 필수: exchange, symbol
GET /open-interest/list $0.0001 / call
GET /wallet-status $0.0001 / call 필수: asset
GET /forex $0.0001 / call 필수: symbol
GET /cex/fees $0.0001 / call
GET /listings/historical $0.0001 / call
GET /cex/announcements $0.0001 / call
GET /telegram/channels $0.0001 / call
GET /margin-borrow $0.0001 / call 필수: asset
GET /cex/symbol/volume $0.0001 / call 필수: base
GET /cex/symbol/oi $0.0001 / call 필수: base
GET /cex/symbol/oi-stats $0.0001 / call 필수: base
GET /cex/symbol/liquidation $0.0001 / call 필수: base
GET /cex/candle $0.0005 / call 필수: exchange, symbol
GET /liquidation $0.0005 / call 필수: exchange, symbol
GET /liquidation/feed $0.0005 / call
GET /liquidation/heatmap $0.0005 / call
GET /liquidation/stats $0.0005 / call
GET /liquidation/map $0.0005 / call
GET /liquidation/symbol-history $0.0005 / call 필수: symbol
GET /open-interest/summary $0.0005 / call
GET /open-interest/overview $0.0005 / call
GET /naver-trend $0.0005 / call 필수: symbol
GET /telegram/messages $0.0005 / call
GET /funding-rate/history $0.0005 / call 필수: exchange, symbol
GET /cex/token/updates $0.0005 / call
GET /open-interest/history-aggregated $0.002 / call 필수: token_id
GET /index-price $0.002 / call 필수: asset
## WebSocket
wss://api.datamaxiplus.com/ws/v1/<channel> X-DTMX-APIKEY 헤더 동일 연결 1분당 $0.0001
채널: announcement/listing, forex, funding-rate, liquidation, liquidation/feed, open-interest, premium, ticker/futures, ticker/spot
전체 문서: https://docs.datamaxiplus.com/api/getting-started
API 키 발급
# .env DATAMAXI_API_KEY=<your key>
잔액 충전
엔드포인트 둘러보기
→샘플
| 날짜 | 호출 |
|---|---|
| 10월 19일 | 12 |
| 10월 20일 | 16.86 |
| 10월 21일 | 16.76 |
| 10월 22일 | 16.96 |
| 10월 23일 | 20.32 |
| 10월 24일 | 20.51 |
| 10월 25일 | 16.44 |
| 10월 26일 | 15.32 |
| 10월 27일 | 17.24 |
| 10월 28일 | 15.94 |
| 10월 29일 | 13.7 |
| 10월 30일 | 16.63 |
| 10월 31일 | 20.81 |
| 11월 1일 | 20.64 |
| 11월 2일 | 20.64 |
| 11월 3일 | 24.26 |
| 11월 4일 | 25.23 |
| 11월 5일 | 21.16 |
| 11월 6일 | 18.84 |
| 11월 7일 | 19.32 |
| 11월 8일 | 16.29 |
| 11월 9일 | 11.32 |
| 11월 10일 | 11.26 |
| 11월 11일 | 13.45 |
| 11월 12일 | 12 |
| 11월 13일 | 10.87 |
| 11월 14일 | 14.29 |
| 11월 15일 | 16.31 |
| 11월 16일 | 13.31 |
| 11월 17일 | 11.44 |
funding-rate/latest
거래소·심볼별 펀딩
$0.0001 / 호출
샘플
| 날짜 | 호출 |
|---|---|
| 10월 19일 | 8.05 |
| 10월 20일 | 6.39 |
| 10월 21일 | 8.22 |
| 10월 22일 | 7.5 |
| 10월 23일 | 3.31 |
| 10월 24일 | 2.87 |
| 10월 25일 | 6.14 |
| 10월 26일 | 6.57 |
| 10월 27일 | 6.1 |
| 10월 28일 | 10.55 |
| 10월 29일 | 15.75 |
| 10월 30일 | 16.05 |
| 10월 31일 | 16.04 |
| 11월 1일 | 19.42 |
| 11월 2일 | 20.22 |
| 11월 3일 | 16.35 |
| 11월 4일 | 14.83 |
| 11월 5일 | 16.79 |
| 11월 6일 | 15.86 |
| 11월 7일 | 13.38 |
| 11월 8일 | 15.87 |
| 11월 9일 | 20.32 |
| 11월 10일 | 20.56 |
| 11월 11일 | 20.38 |
| 11월 12일 | 23.99 |
| 11월 13일 | 25.63 |
| 11월 14일 | 21.94 |
| 11월 15일 | 19.37 |
| 11월 16일 | 19.95 |
| 11월 17일 | 17.39 |
premium
거래소 간 가격 차
$0.0001 / 호출
샘플
| 날짜 | 호출 |
|---|---|
| 10월 19일 | 6.37 |
| 10월 20일 | 4.6 |
| 10월 21일 | -0.0029 |
| 10월 22일 | -0.42 |
| 10월 23일 | 3.02 |
| 10월 24일 | 3.45 |
| 10월 25일 | 2.57 |
| 10월 26일 | 6.02 |
| 10월 27일 | 9.7 |
| 10월 28일 | 8.1 |
| 10월 29일 | 6.12 |
| 10월 30일 | 7.8 |
| 10월 31일 | 7.46 |
| 11월 1일 | 3.22 |
| 11월 2일 | 2.16 |
| 11월 3일 | 5.27 |
| 11월 4일 | 5.93 |
| 11월 5일 | 5.14 |
| 11월 6일 | 9.11 |
| 11월 7일 | 14.59 |
| 11월 8일 | 15.31 |
| 11월 9일 | 15.12 |
| 11월 10일 | 18.46 |
| 11월 11일 | 19.84 |
| 11월 12일 | 16.23 |
| 11월 13일 | 14.33 |
| 11월 14일 | 16.26 |
| 11월 15일 | 15.72 |
| 11월 16일 | 13.06 |
| 11월 17일 | 15.06 |
open-interest/summary
시장 미결제약정 스냅샷
$0.0005 / 호출
샘플
| 날짜 | 호출 |
|---|---|
| 10월 19일 | 10.07 |
| 10월 20일 | 10.51 |
| 10월 21일 | 14.33 |
| 10월 22일 | 14.42 |
| 10월 23일 | 12.42 |
| 10월 24일 | 14.05 |
| 10월 25일 | 15.42 |
| 10월 26일 | 11.37 |
| 10월 27일 | 7.14 |
| 10월 28일 | 7.04 |
| 10월 29일 | 5.56 |
| 10월 30일 | 0.81 |
| 10월 31일 | -0.3 |
| 11월 1일 | 2.95 |
| 11월 2일 | 3.61 |
| 11월 3일 | 2.44 |
| 11월 4일 | 5.46 |
| 11월 5일 | 9.42 |
| 11월 6일 | 8.21 |
| 11월 7일 | 5.95 |
| 11월 8일 | 7.42 |
| 11월 9일 | 7.46 |
| 11월 10일 | 3.24 |
| 11월 11일 | 1.56 |
| 11월 12일 | 4.44 |
| 11월 13일 | 5.33 |
| 11월 14일 | 4.27 |
| 11월 15일 | 7.71 |
| 11월 16일 | 13.38 |
| 11월 17일 | 14.55 |
liquidation/feed
실시간 청산
$0.0005 / 호출