ArbTide API
ArbTide API는 35개 거래소의 정규화된 펀딩비, 펀딩 기록, 실시간 가격, 수수료 차감 후 차익거래 경로, 캐시 앤 캐리 거래를 JSON으로 제공하며, 데이터는 거래소 API에서 직접 수집합니다. 모든 호출에는 API 키가 필요하고 크레딧으로 계산합니다: 체험용 무료 키로 하루 100, 내 도구와 봇을 위한 Pro로 월 5,000,000.
빠른 시작
curl -H "x-api-key: $ARBTIDE_KEY" https://arbtide.com/api/v1/funding-rates/btcHTTP/2 200
x-credits-cost: 1
x-credits-remaining: 99
x-credits-reset: 2026-11-19T00:00:00.000Z
{
"data": {
"coin": "BTC",
"averageApr": 0.04156994580336466,
"spreadApr": 0.358503,
"long": { "exchange": "deepcoin", "rate": -0.0001624, "intervalHours": 8, "apr": -0.17782799999999999 },
"short": { "exchange": "xt", "rate": 0.000165, "intervalHours": 8, "apr": 0.180675 },
"rates": [
{ "exchange": "xt", "symbol": "BTC/USDT:USDT", "rate": 0.000165, "intervalHours": 8, "apr": 0.180675 },
{ "exchange": "extended", "symbol": "BTC/USDC:USDC", "rate": 0.000013, "intervalHours": 1, "apr": 0.11388, "markPrice": 64656.27777825 }
]
},
"meta": { "updatedAt": "2026-11-18T07:22:13.556Z" }
}예시
하나를 복사해 ARBTIDE_KEY를 설정하고 실행하세요. 모든 응답의 헤더에 그 호출이 쓴 크레딧이 표시됩니다.
Python: 수수료 차감 후 최고의 가격 경로
import os
import requests
API = "https://arbtide.com/api/v1"
headers = {"x-api-key": os.environ["ARBTIDE_KEY"]}
# Price routes with a positive spread after fees, widest first (5 credits)
reply = requests.get(f"{API}/arbitrage", params={"type": "perp", "limit": 10}, headers=headers)
for route in reply.json()["data"]:
print(route["coin"], route["buy"]["exchange"], "->", route["sell"]["exchange"], f'{route["netSpread"]:.2%} net')
print("credits left:", reply.headers["x-credits-remaining"])JavaScript: 펀딩 차이가 가장 큰 코인
// Node 18+ or any browser-less runtime with fetch
const reply = await fetch("https://arbtide.com/api/v1/funding-rates?limit=10", {
headers: { "x-api-key": process.env.ARBTIDE_KEY },
})
const { data } = await reply.json()
for (const coin of data) {
console.log(coin.coin, `${(coin.spreadApr * 100).toFixed(1)}% APR`, "long", coin.long.exchange, "short", coin.short.exchange)
}
console.log("credits left:", reply.headers.get("x-credits-remaining"))Python: Discord로 보내는 폴링 알림
import os, time, requests
API = "https://arbtide.com/api/v1"
HEADERS = {"x-api-key": os.environ["ARBTIDE_KEY"]}
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]
def get(path, **params):
while True:
reply = requests.get(f"{API}{path}", params=params, headers=HEADERS)
if reply.status_code == 429 and reply.json()["error"]["code"] == "rate_limited":
time.sleep(int(reply.headers.get("Retry-After", 1))) # the speed limit refills every second
continue
reply.raise_for_status()
return reply.json()["data"]
seen = set()
while True:
# A list costs 5 credits: every 15 minutes is 480 a day, so run this on Pro. Free has 100 a day.
for route in get("/arbitrage", type="perp", minNetSpread=0.005, limit=5):
key = (route["coin"], route["buy"]["exchange"], route["sell"]["exchange"])
if key not in seen:
seen.add(key)
requests.post(DISCORD, json={"content": f'{route["coin"]}: {route["netSpread"]:.2%} net, buy {key[1]}, sell {key[2]}'})
time.sleep(15 * 60)Google Sheets: 코인 하나의 펀딩비 (Apps Script)
// Google Sheets: Extensions > Apps Script. Save the key under Project Settings > Script properties as ARBTIDE_KEY.
// In a cell: =ARBTIDE_FUNDING("BTC")
function ARBTIDE_FUNDING(coin) {
const key = PropertiesService.getScriptProperties().getProperty("ARBTIDE_KEY")
const reply = UrlFetchApp.fetch("https://arbtide.com/api/v1/funding-rates/" + String(coin).toLowerCase(), { headers: { "x-api-key": key } })
return JSON.parse(reply.getContentText()).data.rates.map((rate) => [rate.exchange, rate.rate, rate.apr])
}플랜
Pro 시작하기Free는 API를 체험하기 위한 것입니다. Pro는 내 도구와 봇을 운영하기 위한 것입니다.
Free
- 크레딧
- 하루 100
- 속도 제한
- 초당 1
- API 키
- 1
- 키 유효 기간
- 최대 30일
- IP 주소로 제한한 키
- —
- 알림과 관심 목록 접근
- —
- 호출당 펀딩 기록
- 7일
Pro
- 크레딧
- 월 5,000,000
- 속도 제한
- 초당 50
- API 키
- 10
- 키 유효 기간
- 30일부터 무기한까지
- IP 주소로 제한한 키
- 포함
- 알림과 관심 목록 접근
- 포함
- 호출당 펀딩 기록
- 90일
크레딧
호출은 돌려주는 양만큼 크레딧이 듭니다. 코인 하나나 거래소 하나는 1, 전체 목록은 5, 펀딩 기록은 돌려주는 하루마다 1. 할당량과 속도 제한 모두 크레딧으로 계산하므로 무거운 호출은 그만큼 더 쓸 뿐입니다.
- GET5크레딧
- 경로
- /api/v1/exchanges/{exchange}/funding-rates
- 설명
- Every linear perpetual funding rate on one exchange
- GET5크레딧
- 경로
- /api/v1/funding-rates
- 설명
- Funding summary for every coin listed on at least two exchanges
- GET5크레딧
- 경로
- /api/v1/arbitrage
- 설명
- Price arbitrage routes with a positive net spread
- GET5크레딧
- 경로
- /api/v1/strategies/cash-and-carry
- 설명
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1크레딧
- 경로
- /api/v1/exchanges
- 설명
- List exchanges with market counts and volume
- GET1크레딧
- 경로
- /api/v1/funding-rates/{coin}
- 설명
- Funding rates for one coin on every exchange
- GET하루에 1크레딧
- 경로
- /api/v1/funding-rates/{coin}/history
- 설명
- Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90
- GET1크레딧
- 경로
- /api/v1/arbitrage/{coin}
- 설명
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1크레딧
- 경로
- /api/v1/prices/{coin}
- 설명
- Live bid and ask for one coin on every exchange and market type
- GET1크레딧
- 경로
- /api/v1/status
- 설명
- Data collection status of every exchange and stream
| GET | /api/v1/exchanges/{exchange}/funding-rates | Every linear perpetual funding rate on one exchange | 5 |
| GET | /api/v1/funding-rates | Funding summary for every coin listed on at least two exchanges | 5 |
| GET | /api/v1/arbitrage | Price arbitrage routes with a positive net spread | 5 |
| GET | /api/v1/strategies/cash-and-carry | Cash-and-carry trades: buy spot, short the perpetual, earn funding | 5 |
| GET | /api/v1/exchanges | List exchanges with market counts and volume | 1 |
| GET | /api/v1/funding-rates/{coin} | Funding rates for one coin on every exchange | 1 |
| GET | /api/v1/funding-rates/{coin}/history | Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90 | 하루에 1 |
| GET | /api/v1/arbitrage/{coin} | Best spot and perpetual route for one coin, including unprofitable ones | 1 |
| GET | /api/v1/prices/{coin} | Live bid and ask for one coin on every exchange and market type | 1 |
| GET | /api/v1/status | Data collection status of every exchange and stream | 1 |
10개 중 10개 표시
계정을 읽을 수 있는 Pro 키로는 /me 엔드포인트(알림, 알림 기록, 관심 목록)가 호출당 1 크레딧입니다. OpenAPI 명세에 나와 있습니다.
API 키
- 계정의 API 탭에서 키를 만들고
x-api-key: arb_…또는Authorization: Bearer arb_…로 보내세요. 키는 만들 때 한 번만 표시됩니다. - 모든 키는 선택한 유효 기간이 지나면 작동을 멈춥니다. Free 키는 최대 30일, Pro 키는 90일, 1년 또는 무기한입니다. 멈추기 1주일 전에 이메일로 알려드립니다.
- 키를 교체하면 같은 설정의 새 키를 받고, 이전 키도 24시간 동안 작동하므로 끊김 없이 바꿀 수 있습니다.
- Pro에서는 키를 최대 20개의 IP 주소나 203.0.113.0/24 같은 IPv4 범위로 제한할 수 있으며, 다른 곳에서 온 호출은 거부됩니다.
- 모든 키는 시장 데이터를 읽습니다. Pro 키에는 계정 읽기도 허용할 수 있습니다.
- 키를 폐기하면 즉시 작동을 멈춥니다.
한도와 헤더
Free 크레딧은 매일 UTC 자정에, Pro 크레딧은 매월 UTC 월초에 다시 시작됩니다. 속도 제한은 매초 채워지며 최대 5초 분량의 크레딧을 한 번에 쓸 수 있습니다. 모든 응답에는 다음 헤더가 있습니다.
- X-Credits-Cost
- 이 호출에 쓴 크레딧.
- X-Credits-Remaining
- 이번 기간에 남은 크레딧.
- X-Credits-Limit
- 이번 기간의 할당량.
- X-Credits-Reset
- 할당량이 다시 시작되는 시각(UTC).
- X-RateLimit-Remaining
- 속도 제한이 걸리기 전에 바로 쓸 수 있는 크레딧.
- Retry-After
- 기다려야 할 초. 속도 제한으로 호출이 거부됐을 때 보냅니다.
HTTP/2 429
{ "error": { "code": "quota_exceeded", "message": "The daily quota of 100 credits is used up; it resets at 2026-11-19T00:00:00.000Z. ..." } }오류
오류는 다음 코드 중 하나와 함께 { error: { code, message } } 형태로 돌아옵니다.
- 400
- invalid_request
- 매개변수가 없거나 잘못됐습니다. 메시지에 어느 것인지 나옵니다.
- 401
- api_key_required
- API 키가 전송되지 않았습니다. 계정의 API 탭에서 무료 키를 만드세요.
- 401
- invalid_api_key
- 키가 틀렸거나 폐기됐습니다.
- 401
- key_expired
- 키가 만료됐습니다. 교체하거나 새로 만드세요.
- 403
- ip_not_allowed
- 키가 다른 IP 주소로 제한되어 있습니다.
- 403
- insufficient_scope
- 키에 계정 같은 이 정보를 읽을 권한이 없습니다.
- 403
- upgrade_required
- 더 높은 플랜이 필요합니다.
- 404
- not_found
- 해당 코인, 거래소 또는 경로가 없습니다.
- 429
- rate_limited
- 너무 빠릅니다. Retry-After의 초만큼 기다리세요.
- 429
- quota_exceeded
- 이번 기간의 크레딧을 다 썼습니다. X-Credits-Reset 시각에 돌아옵니다.
규칙
- 모든 응답은
{ data, meta }형태입니다. - 비율, 스프레드, APR은 소수입니다: 0.0001 = 0.01%.
자주 묻는 질문
- API 키가 필요한가요?
- 네. 모든 호출에 키가 필요하고, 무료 키는 1분이면 만듭니다. 계정의 API 탭에서 카드 없이 만들 수 있습니다. 키는 한 번만 표시되며 언제든 교체하거나 폐기할 수 있습니다.
- 무료 키에는 무엇이 포함되나요?
- 초당 1 크레딧으로 하루 100 크레딧, 최대 30일 유효한 시장 데이터 키 1개, 호출당 7일치 펀딩 기록입니다. API를 체험하기 위한 것입니다. Pro는 월 5,000,000 크레딧, 키 10개, IP 제한, 90일치 기록을 제공합니다.
- 크레딧은 어떻게 계산하나요?
- 호출이 돌려주는 양만큼입니다. 코인 하나 또는 거래소 하나는 1 크레딧, 전체 목록은 5, 펀딩 기록은 하루마다 1 크레딧입니다. 할당량과 속도 제한 모두 크레딧으로 계산하며, 모든 응답에 사용량과 남은 양이 표시됩니다.
- 데이터는 어디에서 오나요?
- 35개 거래소의 공개 API에서 직접 가져와 우리 서버에서 수집하고, 비교 가능한 단위로 맞춘 뒤 수수료를 차감합니다. ArbTide는 데이터 집계 업체의 데이터를 재판매하지 않습니다.
- API로 제품을 만들 수 있나요?
- 어느 플랜에서든 개인용·내부용 도구에는 데이터를 쓸 수 있습니다. 원본 데이터 재판매, 제한 우회, 서비스에 해가 되는 스크래핑은 안 됩니다. 자세한 내용은 이용약관을 보세요.