파트너 API
읽기 전용 JSON API입니다. 원문 출처 링크가 포함된 뉴스 요약, 시장 데이터, 파생상품, 이벤트 캘린더, 토큰 스크리너를 제공하며 게시된 데이터만 다룹니다.
전체 레퍼런스(OpenAPI 3.1)openapi.yaml 다운로드
라이선스와 출처 표기
- 데이터 옆에 사이트 링크와 함께 “Satoshi Daily”를 반드시 표시해야 합니다. 모든 응답에는 attribution 객체와 X-Attribution 헤더가 포함됩니다.
- 뉴스는 자체 작성한 요약입니다. 원문 기사의 권리는 각 매체에 있으므로 sources[]의 링크를 함께 표시하고, 요약을 원문인 것처럼 게시하지 마세요.
- 시장 데이터 출처는 CoinGecko, GeckoTerminal, 거래소 공개 API입니다. API의 어떤 내용도 투자 권유가 아닙니다.
{
"data": { "items": [ … ], "next_cursor": "…" },
"attribution": {
"text": "Satoshi Daily",
"url": "https://satoshidaily.net",
"required": true,
"license": "Display \"Satoshi Daily\" with a link to https://satoshidaily.net next to the data. …"
}
}API 키와 요금제
API 키는 Satoshi Daily 편집팀이 발급합니다. 키는 한 번만 표시되므로 브라우저가 아닌 서버에 보관하세요. X-API-Key 헤더 또는 Authorization: Bearer로 전송합니다.
| 요금제 | 분당 요청 수 | 일일 요청 수(UTC) |
|---|---|---|
| free | 60 | 5,000 |
| pro | 300 | 100,000 |
| business | 1,200 | 1,000,000 |
요청 한도
분당 한도는 슬라이딩 윈도 방식입니다. 모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset(초)과 -Day 접미사가 붙은 같은 헤더가 포함됩니다. 한도를 넘으면 429와 함께 Retry-After에 대기 시간(초)이 반환됩니다. 키가 없거나 폐기된 키면 401이 반환됩니다.
엔드포인트
기본 URL: https://satoshidaily.net/api/public/v1
| GET /news?lang=ru&coin=&min_importance=&limit=&cursor= | 게시된 뉴스: 요약, “왜 중요한가”, 원문 출처 링크 |
| GET /news/{id}?lang= | 뉴스 1건 |
| GET /market | 시가총액, 거래량, 도미넌스, 공포·탐욕 지수, 상위 100개, 상승·하락 상위 코인 |
| GET /coins/{id}?days=7&lang= | 코인 카드, 가격 이력, 관련 뉴스 |
| GET /derivatives | 코인별 펀딩비, 미결제약정, 청산 |
| GET /derivatives/{coin}?hours=24 | 코인 하나의 거래소별 데이터와 이력 |
| GET /events?from=&to=&type=&coin=&lang= | 이벤트 캘린더(게시된 항목만) |
| GET /events/{id}?lang= | 이벤트 1건 |
| GET /screener?preset=&mcap_min=&…&sort=&page= | 상위 1,000개 스크리너: 필터, 정렬, 페이지 |
| GET /screener/meta | 카테고리, 체인, 프리셋, 데이터 갱신 시점 |
| GET /widget/ticker · /widget/coins/{id} · /widget/news · /widget/fear-greed | 위젯 데이터, 키 불필요(Origin별 한도) |
예시
curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/news?lang=ko&limit=5" curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/screener?preset=near_ath&per_page=20" curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/screener?mcap_min=100M&ch7d_min=10&category=layer-2&sort=ch7d" curl -s -H "Authorization: Bearer $SD_API_KEY" "https://satoshidaily.net/api/public/v1/coins/bitcoin?days=30&lang=ko" curl -si -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/derivatives" | grep -i '^x-ratelimit' curl -s "https://satoshidaily.net/api/public/v1/widget/ticker?coins=bitcoin,ethereum&lang=ko"
키 없이 쓰는 위젯
내 사이트에 시세, 코인 카드, 뉴스 피드, 공포·탐욕 지수를 표시하려면 기성 위젯을 사용하세요. 키가 필요 없으며 한도는 Origin별로 적용됩니다. 위젯 만들기 →