API de ArbTide
La API de ArbTide devuelve tasas de funding normalizadas, historial de funding, precios en vivo, rutas de arbitraje después de comisiones y operaciones de cash and carry de 35 exchanges en JSON, recogidas directamente de las API de los exchanges. Cada llamada necesita una clave API y se cuenta en créditos: 100 al día con una clave gratuita para probarla y 5,000,000 al mes con Pro para tus propias herramientas y bots.
Inicio 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.043082874679662236,
"spreadApr": 0.25584505585295325,
"long": { "exchange": "backpack", "rate": -0.00000858105660421841, "intervalHours": 1, "apr": -0.07517005585295326 },
"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": "deepcoin", "symbol": "BTC/USDT:USDT", "rate": 0.00010965, "intervalHours": 8, "apr": 0.12006675 }
]
},
"meta": { "updatedAt": "2026-11-18T07:17:44.618Z" }
}Ejemplos
Copia uno, define ARBTIDE_KEY y ejecútalo. Cada respuesta indica en sus cabeceras cuántos créditos costó la llamada.
Python: las mejores rutas de precio después de comisiones
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: las mayores diferencias 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: una alerta por sondeo a 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: tasas de funding de una moneda (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])
}Planes
Obtener ProFree sirve para probar la API. Pro es para ejecutar tus propias herramientas y bots sobre ella.
Free
- Créditos
- 100 al día
- Límite de velocidad
- 1 por segundo
- Claves API
- 1
- Duración de la clave
- Hasta 30 días
- Claves limitadas a tus direcciones IP
- —
- Acceso a tus alertas y lista de seguimiento
- —
- Historial de funding por llamada
- 7 días
Pro
- Créditos
- 5.000.000 al mes
- Límite de velocidad
- 50 por segundo
- Claves API
- 10
- Duración de la clave
- De 30 días a ilimitada
- Claves limitadas a tus direcciones IP
- Incluido
- Acceso a tus alertas y lista de seguimiento
- Incluido
- Historial de funding por llamada
- 90 días
Créditos
Cada llamada cuesta créditos según lo que devuelve: una moneda o un exchange cuesta 1, una lista completa 5 y el historial de funding 1 por cada día devuelto. Tu cuota y tu límite de velocidad se cuentan en créditos, así que una llamada pesada simplemente usa más.
- GET5Créditos
- Ruta
- /api/v1/exchanges/{exchange}/funding-rates
- Descripción
- Every linear perpetual funding rate on one exchange
- GET5Créditos
- Ruta
- /api/v1/funding-rates
- Descripción
- Funding summary for every coin listed on at least two exchanges
- GET5Créditos
- Ruta
- /api/v1/arbitrage
- Descripción
- Price arbitrage routes with a positive net spread
- GET5Créditos
- Ruta
- /api/v1/strategies/cash-and-carry
- Descripción
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1Créditos
- Ruta
- /api/v1/exchanges
- Descripción
- List exchanges with market counts and volume
- GET1Créditos
- Ruta
- /api/v1/funding-rates/{coin}
- Descripción
- Funding rates for one coin on every exchange
- GET1 por díaCréditos
- Ruta
- /api/v1/funding-rates/{coin}/history
- Descripción
- Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90
- GET1Créditos
- Ruta
- /api/v1/arbitrage/{coin}
- Descripción
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1Créditos
- Ruta
- /api/v1/prices/{coin}
- Descripción
- Live bid and ask for one coin on every exchange and market type
- GET1Créditos
- Ruta
- /api/v1/status
- Descripción
- 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 día |
| 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 |
Con una clave Pro que puede leer tu cuenta, los endpoints /me (alertas, historial de alertas, lista de seguimiento) cuestan 1 crédito cada uno. Están en la especificación OpenAPI.
Claves API
- Crea claves en la pestaña API de tu cuenta y envía una como
x-api-key: arb_…oAuthorization: Bearer arb_…. La clave se muestra una sola vez, al crearla. - Cada clave deja de funcionar al acabar la duración que elijas. Las claves Free duran hasta 30 días; las Pro pueden durar 90 días, un año o no caducar nunca. Te avisamos por correo una semana antes.
- Al reemplazar una clave recibes otra con la misma configuración, y la antigua sigue funcionando 24 horas para que cambies sin cortes.
- En Pro una clave puede limitarse a un máximo de 20 direcciones IP o rangos IPv4 como 203.0.113.0/24; las llamadas desde otro lugar se rechazan.
- Toda clave lee datos de mercado. A una clave Pro también se le puede permitir leer tu cuenta.
- Revocar una clave la detiene al instante.
Límites y cabeceras
Los créditos de Free empiezan de nuevo cada medianoche UTC y los de Pro al empezar cada mes UTC. El límite de velocidad se rellena cada segundo y te deja gastar hasta 5 segundos de créditos de una vez. Cada respuesta incluye estas cabeceras:
- X-Credits-Cost
- Créditos que usó esta llamada.
- X-Credits-Remaining
- Créditos que quedan en este periodo.
- X-Credits-Limit
- Tu cuota del periodo.
- X-Credits-Reset
- Cuándo empieza de nuevo la cuota (UTC).
- X-RateLimit-Remaining
- Créditos que puedes gastar ahora antes de que actúe el límite de velocidad.
- Retry-After
- Segundos que hay que esperar; se envía cuando el límite de velocidad rechazó una llamada.
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. ..." } }Errores
Los errores llegan como { error: { code, message } } con uno de estos códigos:
- 400
- invalid_request
- Falta un parámetro o no es válido; el mensaje dice cuál.
- 401
- api_key_required
- No se envió ninguna clave API. Crea una gratis en la pestaña API de tu cuenta.
- 401
- invalid_api_key
- La clave es incorrecta o fue revocada.
- 401
- key_expired
- La clave dejó de funcionar. Reemplázala o crea una nueva.
- 403
- ip_not_allowed
- La clave está limitada a otras direcciones IP.
- 403
- insufficient_scope
- La clave no puede leer esto, por ejemplo tu cuenta.
- 403
- upgrade_required
- Esto requiere un plan superior.
- 404
- not_found
- No existe esa moneda, exchange o ruta.
- 429
- rate_limited
- Demasiado rápido. Espera los segundos de Retry-After.
- 429
- quota_exceeded
- Se acabaron los créditos del periodo. Vuelven en X-Credits-Reset.
Convenciones
- Toda respuesta es
{ data, meta }. - Las tasas, spreads y APR son fracciones: 0.0001 = 0,01 %.
Preguntas frecuentes
- ¿Necesito una clave API?
- Sí. Cada llamada necesita una clave, y una gratuita se crea en un minuto: en la pestaña API de tu cuenta, sin tarjeta. La clave se muestra una sola vez y puedes reemplazarla o revocarla cuando quieras.
- ¿Qué incluye la clave gratuita?
- 100 créditos al día a 1 crédito por segundo, una clave de datos de mercado de hasta 30 días y 7 días de historial de funding por llamada. Sirve para probar la API. Pro lo eleva a 5,000,000 créditos al mes, 10 claves, límites por IP y 90 días de historial.
- ¿Cómo se cuentan los créditos?
- Según lo que devuelve la llamada: una moneda o un exchange cuesta 1 crédito, una lista completa 5 y el historial de funding 1 crédito por día. Tu cuota y tu límite de velocidad se cuentan en créditos, y cada respuesta indica lo que costó y lo que queda.
- ¿De dónde vienen los datos?
- Directamente de las API públicas de 35 exchanges, recogidas en nuestros propios servidores y normalizadas a unidades comparables, con las comisiones descontadas. ArbTide no revende datos de agregadores.
- ¿Puedo crear un producto con la API?
- Puedes usar los datos en herramientas personales e internas con cualquier plan. No puedes revender los datos en bruto, saltarte los límites ni hacer scraping que perjudique el servicio. Los Términos tienen los detalles.