ArbTide

ArbTide API

ArbTide API는 35개 거래소의 정규화된 펀딩비, 펀딩 기록, 실시간 가격, 수수료 차감 후 차익거래 경로, 캐시 앤 캐리 거래를 JSON으로 제공하며, 데이터는 거래소 API에서 직접 수집합니다. 모든 호출에는 API 키가 필요하고 크레딧으로 계산합니다: 체험용 무료 키로 하루 100, 내 도구와 봇을 위한 Pro로 월 5,000,000.

API 키 받기OpenAPI 3.1 명세

기본 URL https://arbtide.com/api/v1

빠른 시작

curl -H "x-api-key: $ARBTIDE_KEY" https://arbtide.com/api/v1/funding-rates/btc
HTTP/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])
}

Free는 API를 체험하기 위한 것입니다. Pro는 내 도구와 봇을 운영하기 위한 것입니다.

크레딧

호출은 돌려주는 양만큼 크레딧이 듭니다. 코인 하나나 거래소 하나는 1, 전체 목록은 5, 펀딩 기록은 돌려주는 하루마다 1. 할당량과 속도 제한 모두 크레딧으로 계산하므로 무거운 호출은 그만큼 더 쓸 뿐입니다.

  • GET
    5
    크레딧
    경로
    /api/v1/exchanges/{exchange}/funding-rates
    설명
    Every linear perpetual funding rate on one exchange

  • GET
    5
    크레딧
    경로
    /api/v1/funding-rates
    설명
    Funding summary for every coin listed on at least two exchanges

  • GET
    5
    크레딧
    경로
    /api/v1/arbitrage
    설명
    Price arbitrage routes with a positive net spread

  • GET
    5
    크레딧
    경로
    /api/v1/strategies/cash-and-carry
    설명
    Cash-and-carry trades: buy spot, short the perpetual, earn funding

  • GET
    1
    크레딧
    경로
    /api/v1/exchanges
    설명
    List exchanges with market counts and volume

  • GET
    1
    크레딧
    경로
    /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

  • GET
    1
    크레딧
    경로
    /api/v1/arbitrage/{coin}
    설명
    Best spot and perpetual route for one coin, including unprofitable ones

  • GET
    1
    크레딧
    경로
    /api/v1/prices/{coin}
    설명
    Live bid and ask for one coin on every exchange and market type

  • GET
    1
    크레딧
    경로
    /api/v1/status
    설명
    Data collection status of every exchange and stream

10개 중 10개 표시

계정을 읽을 수 있는 Pro 키로는 /me 엔드포인트(알림, 알림 기록, 관심 목록)가 호출당 1 크레딧입니다. OpenAPI 명세에 나와 있습니다.

API 키

한도와 헤더

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 시각에 돌아옵니다.

규칙

자주 묻는 질문

API 키가 필요한가요?
네. 모든 호출에 키가 필요하고, 무료 키는 1분이면 만듭니다. 계정의 API 탭에서 카드 없이 만들 수 있습니다. 키는 한 번만 표시되며 언제든 교체하거나 폐기할 수 있습니다.
무료 키에는 무엇이 포함되나요?
초당 1 크레딧으로 하루 100 크레딧, 최대 30일 유효한 시장 데이터 키 1개, 호출당 7일치 펀딩 기록입니다. API를 체험하기 위한 것입니다. Pro는 월 5,000,000 크레딧, 키 10개, IP 제한, 90일치 기록을 제공합니다.
크레딧은 어떻게 계산하나요?
호출이 돌려주는 양만큼입니다. 코인 하나 또는 거래소 하나는 1 크레딧, 전체 목록은 5, 펀딩 기록은 하루마다 1 크레딧입니다. 할당량과 속도 제한 모두 크레딧으로 계산하며, 모든 응답에 사용량과 남은 양이 표시됩니다.
데이터는 어디에서 오나요?
35개 거래소의 공개 API에서 직접 가져와 우리 서버에서 수집하고, 비교 가능한 단위로 맞춘 뒤 수수료를 차감합니다. ArbTide는 데이터 집계 업체의 데이터를 재판매하지 않습니다.
API로 제품을 만들 수 있나요?
어느 플랜에서든 개인용·내부용 도구에는 데이터를 쓸 수 있습니다. 원본 데이터 재판매, 제한 우회, 서비스에 해가 되는 스크래핑은 안 됩니다. 자세한 내용은 이용약관을 보세요.