API da ArbTide
A API da ArbTide devolve em JSON taxas de funding normalizadas, histórico de funding, preços ao vivo, rotas de arbitragem já descontadas as taxas e operações de cash and carry de 35 corretoras, coletadas direto das APIs das corretoras. Toda chamada precisa de uma chave de API e é contada em créditos: 100 por dia com uma chave grátis para testar e 5,000,000 por mês no Pro para suas próprias ferramentas e bots.
Início rápido
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" }
}Exemplos
Copie um, defina ARBTIDE_KEY e execute. Cada resposta informa, nos cabeçalhos, quantos créditos a chamada custou.
Python: as melhores rotas de preço após as taxas
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: as maiores diferenças de funding
// 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: um alerta por consulta periódica para o 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: taxas de funding de uma moeda (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])
}Planos
Assinar o ProO Free serve para testar a API. O Pro é para rodar suas próprias ferramentas e bots nela.
Free
- Créditos
- 100 por dia
- Limite de velocidade
- 1 por segundo
- Chaves de API
- 1
- Validade da chave
- Até 30 dias
- Chaves limitadas aos seus endereços IP
- —
- Acesso aos seus alertas e à sua watchlist
- —
- Histórico de funding por chamada
- 7 dias
Pro
- Créditos
- 5.000.000 por mês
- Limite de velocidade
- 50 por segundo
- Chaves de API
- 10
- Validade da chave
- De 30 dias a sem prazo
- Chaves limitadas aos seus endereços IP
- Incluído
- Acesso aos seus alertas e à sua watchlist
- Incluído
- Histórico de funding por chamada
- 90 dias
Créditos
Cada chamada custa créditos conforme o que devolve: uma moeda ou uma corretora custa 1, uma lista completa 5 e o histórico de funding 1 por dia devolvido. Sua cota e seu limite de velocidade são contados em créditos, então uma chamada pesada só usa mais deles.
- GET5Créditos
- Caminho
- /api/v1/exchanges/{exchange}/funding-rates
- Descrição
- Every linear perpetual funding rate on one exchange
- GET5Créditos
- Caminho
- /api/v1/funding-rates
- Descrição
- Funding summary for every coin listed on at least two exchanges
- GET5Créditos
- Caminho
- /api/v1/arbitrage
- Descrição
- Price arbitrage routes with a positive net spread
- GET5Créditos
- Caminho
- /api/v1/strategies/cash-and-carry
- Descrição
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1Créditos
- Caminho
- /api/v1/exchanges
- Descrição
- List exchanges with market counts and volume
- GET1Créditos
- Caminho
- /api/v1/funding-rates/{coin}
- Descrição
- Funding rates for one coin on every exchange
- GET1 por diaCréditos
- Caminho
- /api/v1/funding-rates/{coin}/history
- Descrição
- Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90
- GET1Créditos
- Caminho
- /api/v1/arbitrage/{coin}
- Descrição
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1Créditos
- Caminho
- /api/v1/prices/{coin}
- Descrição
- Live bid and ask for one coin on every exchange and market type
- GET1Créditos
- Caminho
- /api/v1/status
- Descrição
- 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 por dia |
| 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 |
Com uma chave Pro autorizada a ler sua conta, os endpoints /me (alertas, histórico de alertas, watchlist) custam 1 crédito cada. Eles estão na especificação OpenAPI.
Chaves de API
- Crie chaves na aba API da sua conta e envie uma como
x-api-key: arb_…ouAuthorization: Bearer arb_…. A chave aparece uma única vez, ao ser criada. - Toda chave para de funcionar ao fim da validade escolhida. Chaves Free duram até 30 dias; chaves Pro podem durar 90 dias, um ano ou não ter prazo. Avisamos por e-mail uma semana antes.
- Ao substituir uma chave você recebe outra com as mesmas configurações, e a antiga continua funcionando por 24 horas para você trocar sem interrupção.
- No Pro, uma chave pode ser limitada a até 20 endereços IP ou faixas IPv4 como 203.0.113.0/24; chamadas de outros lugares são recusadas.
- Toda chave lê dados de mercado. Uma chave Pro também pode ser autorizada a ler sua conta.
- Revogar uma chave a interrompe na hora.
Limites e cabeçalhos
Os créditos do Free recomeçam a cada meia-noite UTC, e os do Pro no início de cada mês UTC. O limite de velocidade se recarrega a cada segundo e permite gastar até 5 segundos de créditos de uma vez. Toda resposta traz estes cabeçalhos:
- X-Credits-Cost
- Créditos usados por esta chamada.
- X-Credits-Remaining
- Créditos restantes no período.
- X-Credits-Limit
- Sua cota no período.
- X-Credits-Reset
- Quando a cota recomeça (UTC).
- X-RateLimit-Remaining
- Créditos que você pode gastar agora antes de o limite de velocidade agir.
- Retry-After
- Segundos de espera, enviado quando o limite de velocidade recusou uma chamada.
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. ..." } }Erros
Os erros voltam como { error: { code, message } } com um destes códigos:
- 400
- invalid_request
- Falta um parâmetro ou ele é inválido; a mensagem diz qual.
- 401
- api_key_required
- Nenhuma chave de API foi enviada. Crie uma grátis na aba API da sua conta.
- 401
- invalid_api_key
- A chave está errada ou foi revogada.
- 401
- key_expired
- A chave parou de funcionar. Substitua ou crie uma nova.
- 403
- ip_not_allowed
- A chave está limitada a outros endereços IP.
- 403
- insufficient_scope
- A chave não pode ler isso, como a sua conta.
- 403
- upgrade_required
- Isso exige um plano superior.
- 404
- not_found
- Essa moeda, corretora ou rota não existe.
- 429
- rate_limited
- Rápido demais. Espere os segundos de Retry-After.
- 429
- quota_exceeded
- Os créditos do período acabaram. Eles voltam em X-Credits-Reset.
Convenções
- Toda resposta é
{ data, meta }. - Taxas, spreads e APRs são frações: 0.0001 = 0,01%.
Perguntas frequentes
- Preciso de uma chave de API?
- Sim. Toda chamada precisa de uma chave, e uma grátis sai em um minuto: na aba API da sua conta, sem cartão. A chave aparece uma única vez, e você pode substituí-la ou revogá-la quando quiser.
- O que a chave grátis inclui?
- 100 créditos por dia a 1 crédito por segundo, uma chave de dados de mercado de até 30 dias e 7 dias de histórico de funding por chamada. Serve para testar a API. O Pro sobe para 5,000,000 créditos por mês, 10 chaves, limites por IP e 90 dias de histórico.
- Como os créditos são contados?
- Pelo que a chamada devolve: uma moeda ou uma corretora custa 1 crédito, uma lista completa 5 e o histórico de funding 1 crédito por dia. Sua cota e seu limite de velocidade são contados em créditos, e cada resposta informa o custo e o que sobrou.
- De onde vêm os dados?
- Direto das APIs públicas de 35 corretoras, coletados nos nossos próprios servidores e normalizados em unidades comparáveis, já sem as taxas. A ArbTide não revende dados de agregadores.
- Posso criar um produto em cima da API?
- Você pode usar os dados em ferramentas pessoais e internas em qualquer plano. Não pode revender os dados brutos, contornar os limites nem fazer scraping que prejudique o serviço. Os Termos trazem os detalhes.