Inicio rápido de la API

Precio del crédito: 0.001 $ (1000 créditos gratis al registrarte). URL base https://api.marketapi.app/v1. Envía tu clave en la cabecera Authorization. Las claves en URL se rechazan.

curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/bars?symbol=EURUSD&timeframe=M1&from=2026-09-01T00:00:00Z&to=2026-09-02T00:00:00Z"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/symbols/EURUSD"

EURUSD y XAUUSD son solo ejemplos: ponga en su lugar el ticker que quiera, escrito exactamente como en la lista de precios (agrupada por mercado: forex, metales, índices, acciones, energías, cripto, con buscador) o en la lista de tickers (CSV). Varios tickers se separan con comas.

Dos productos, una clave API. La API de precios de mercado de abajo sirve precios a apps, bots y paneles. El oráculo de precios on-chain sirve los mismos precios como informes firmados que los contratos inteligentes verifican on-chain.

Endpoints

Hasta dónde llegan las velas: M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years (hasta donde llega el propio historial del mercado).

Oráculo de precios on-chain (para contratos inteligentes)

Usa los mismos precios de forex, oro, índices y acciones dentro de contratos inteligentes, para préstamos DeFi, activos tokenizados (RWA), FX on-chain, pagos con stablecoins y activos sintéticos. Tu app obtiene un informe de precio firmado; tu contrato se lo pasa a nuestro contrato verificador, que comprueba la firma on-chain. El precio no se puede falsificar en tránsito y nadie tiene que confiar en el mensajero.

1. Obtén un informe con tu clave API:

   curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10"

2. Envía su report y su signature a submit() del verificador en tu transacción.
3. Lee el precio verificado con getPriceNoOlderThan(feedId, maxAge). Solo devuelve un precio en vivo (mercado OPEN) más reciente que maxAge.

Cada informe indica el estado del mercado (OPEN, CLOSED, HALTED) y el diferencial bid-ask, y caduca alrededor de un minuto después de firmarse. Los feeds tienen IDs fijos (keccak256("XAUUSD")), unos cortacircuitos detienen saltos anómalos y hay un adaptador compatible con Chainlink (latestRoundData). Los precios que nuestro relayer ya guardó on-chain se pueden leer gratis.

Documentación del oráculo Feeds, redes y contratos

Plan gratuito (sin clave)

Prueba la API sin cuenta: 10 peticiones por minuto y 1000 por día por dirección IP, hasta 5 símbolos por petición.

curl "https://api.marketapi.app/v1/free/prices/latest?symbols=EURUSD"
curl "https://api.marketapi.app/v1/free/symbols"
curl "https://api.marketapi.app/v1/free/market-status?symbols=EURUSD"

¿Necesitas más? Crea una cuenta para tener acceso completo con tu propia clave API.

Estado del precio

Cada precio lleva un status que dice una sola cosa: lo actual que es el precio.

Añade require_live=true para recibir solo precios LIVE; los símbolos excluidos no se cobran. Cada símbolo pedido aparece exactamente en una lista: data (tiene precio), no_data (símbolo conocido, aún sin precio) o unknown (no ofrecido).

Horario de negociación. El forex, los metales y la mayoría de los índices cotizan desde el domingo por la noche hasta el viernes por la noche (UTC). Los CFD de acciones y ETF siguen la sesión regular de su bolsa en hora local, con horario de verano: Nueva York 09:30–16:00, Londres 08:00–16:30, Fráncfort y París 09:00–17:30. Los festivos bursátiles (NYSE, LSE, Xetra, Euronext) cuentan como cerrados. Fuera de ese horario un precio es MARKET_CLOSED, no STALE; si la fuente cotiza igualmente (por ejemplo antes de la apertura), el precio es LIVE.

Especificaciones de instrumentos

GET /v1/symbols/{symbol} devuelve la especificación completa del instrumento tal como la informa la fuente, incluidas divisas, tamaño de contrato, tamaño de tick y límites de volumen, junto con sus sesiones de negociación. GET /v1/symbols/{symbol}/properties/history lista cada cambio. La lista de símbolos (CSV) incluye los campos principales de la especificación.

Reintentos seguros

Envía una cabecera Idempotency-Key para que los reintentos sean seguros: repetir una petición con la misma clave en 24 horas devuelve exactamente la primera respuesta, sin cobrar (respuestas de hasta 2 MB). Para datos actuales, envía una clave nueva; una clave cuya respuesta ya no se guarda recibe 409 idempotency_key_used.

Precios en tiempo real (bots de trading, paneles)

Dos formas de obtener el precio más reciente. Ambas entregan las mismas cotizaciones; elige según cómo funcione tu programa.

¿Qué tan actual es un precio?

Los símbolos que estás transmitiendo, o que has pedido mediante /prices/latest en los últimos 5 minutos, se actualizan desde la fuente aproximadamente cada segundo (hasta de esos símbolos entre todos los clientes a la vez). Todos los demás se actualizan continuamente en segundo plano, con menos frecuencia. Así que: pide o suscríbete a los símbolos que operas y se vuelven rápidos.

Cada cotización lleva time, el momento en que la fuente la produjo (UTC), y un status. Un programa de trading siempre debería comprobar ambos:

• Usa require_live=true en las llamadas REST: solo se devuelven precios LIVE (los demás se listan aparte y no se cobran).
• Compara time con tu reloj e ignora las cotizaciones más antiguas de lo que tolera tu estrategia. Los mercados pueden estar tranquilos: un precio puede legítimamente no cambiar durante un rato.

Ejemplo REST

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"

{"data": [{"symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
           "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}],
 "not_live": [], "unknown": [], "no_data": []}

Consultar más de una vez por segundo no aporta nada: esa es la frecuencia con que se lee la fuente para los símbolos activos.

Protocolo WebSocket

Conéctate a /stream con la cabecera Authorization: Bearer <your key> (permiso read:latest). Después envía mensajes JSON:

> {"action": "subscribe",   "symbols": ["EURUSD", "XAUUSD"]}
< {"type": "subscribed", "symbols": ["EURUSD", "XAUUSD"], "rejected": []}
< {"type": "quote", "symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
   "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}
> {"action": "unsubscribe", "symbols": ["XAUUSD"]}
< {"type": "error", "code": "...", "detail": "..."}

Límites: hasta 50 símbolos por conexión. Códigos de cierre: 4401 clave inválida, 4402 saldo agotado (recarga y vuelve a conectar), 4429 demasiadas conexiones abiertas. El servidor envía pings cada 20 segundos; la mayoría de las bibliotecas WebSocket los responden automáticamente.

Ejemplo en Python (pip install "websockets>=14")

import asyncio, json, os, websockets

async def main():
    url = "/stream"
    headers = {"Authorization": "Bearer " + os.environ["API_KEY"]}
    while True:                                   # reconnect with backoff
        try:
            async with websockets.connect(url, additional_headers=headers) as ws:
                await ws.send(json.dumps({"action": "subscribe", "symbols": ["EURUSD"]}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["type"] == "quote" and msg["status"] == "LIVE":
                        print(msg["symbol"], msg["bid"], msg["ask"], msg["time"])
        except websockets.ConnectionClosed as e:
            if e.code in (4401, 4402):            # wrong key / no balance: retrying will not help
                raise
        await asyncio.sleep(5)

asyncio.run(main())

Ejemplo en Node.js (npm install ws)

const WebSocket = require("ws");
const ws = new WebSocket("/stream", { headers: { Authorization: "Bearer " + process.env.API_KEY } });
ws.on("open", () => ws.send(JSON.stringify({ action: "subscribe", symbols: ["EURUSD"] })));
ws.on("message", (raw) => {
  const m = JSON.parse(raw);
  if (m.type === "quote" && m.status === "LIVE") console.log(m.symbol, m.bid, m.ask, m.time);
});
ws.on("close", (code) => console.log("closed", code));   // reconnect after a few seconds unless 4401/4402

Guarda tu clave API en tu servidor o en tu bot. Nunca la pongas en páginas web o apps que otras personas puedan abrir: quien tenga la clave puede gastar tu saldo.

Conviene saber

• Los precios son el bid y ask propios de la fuente; price_basis en /symbols indica con qué precio se construyen las barras. Son datos de mercado indicativos, no un centro de ejecución: tus órdenes se ejecutan a los precios de tu propio bróker.
• Las horas son siempre UTC. Los decimales son cadenas con la precisión propia del instrumento, así no se pierde nada por redondeo.
• Para el historial (barras y ticks) consulta los endpoints de arriba; tiempo real e historial comparten los mismos símbolos y claves.

Gráficos, indicadores, herramientas de dibujo y alertas de precio (sitio web)

Cada símbolo tiene un gráfico interactivo gratuito en /price/<ticker>, por ejemplo /price/EURUSD. Son funciones del sitio web: no usan créditos de la API y solo necesitas cuenta para guardar análisis y crear alertas.

¿Nuevo en gráficos? Aprende cada indicador y herramienta de dibujo con palabras sencillas: la idea, la fórmula, cómo usarlo y un ejemplo.

Listas de seguimiento, comparación, multigráfico y screener (sitio web)

Ideas de trading, perfiles y seguimiento (sitio web)

App móvil (iPhone y Android)

Inicia sesión con tu cuenta para tener tus listas de seguimiento con precios en vivo, el gráfico completo (cada indicador, herramienta de dibujo y el asistente de patrones, con tus análisis guardados), alertas de precio como notificaciones en el móvil (marca push en una alerta; activa las notificaciones en Cuenta dentro de la app) y las ideas de la comunidad. La verificación en dos pasos funciona como en la web. Cada móvil en el que inicias sesión aparece en Cuenta, donde puedes cerrarle la sesión; una contraseña nueva cierra la sesión en todos los móviles. Los planes y recargas se gestionan en esta web. Puedes eliminar tu cuenta en la app o aquí en Cuenta.

Invitar a amigos (referidos)

En Panel → Invitar a amigos encontrarás tu enlace personal (/r/your-code; añade ?next=/premium o cualquier página de este sitio para enviar a la gente allí). Quien lo abra y cree una cuenta en 30 días queda vinculado a ti. Durante 12 meses desde su registro, cada recarga que pague (cripto en las redes principales o tarjeta, de al menos 5 $) te da un 20 %. El cashback espera 14 días por si hay un reembolso y luego se añade a tu saldo: úsalo en créditos de API, planes o Chart Premium. También puedes cobrarlo (stablecoins o PayPal) a partir de 50 $, confirmado por correo y revisado por nuestro equipo. Invitarte a ti mismo o a una segunda cuenta tuya no cuenta, y hay un límite mensual por persona que invita.

Programa de socios (brókers y formadores)

Las empresas dan Chart Premium a sus clientes: solicítalo en Panel → Socio; una vez aprobado recibes un ID de socio y 5 plazas de prueba gratis (14 días de Pro cada una). Las plazas se compran en paquetes (10, 50, 250) con un 30 % de descuento, para Pro o Pro+ y 1, 3, 6 o 12 meses cada una, desde tu saldo. Cada plaza se convierte en un código de activación de un solo uso, creado en la página de socio o mediante la API de socios, opcionalmente con tu propia referencia de cliente (guardada enmascarada). Los códigos no usados se pueden cancelar y devuelven su plaza. Los clientes introducen el código en la página Premium.

Asistente de patrones (sitio web)

✦ Asistente en el gráfico escanea las velas de la temporalidad en pantalla y lista lo que encuentra, con las reglas que cumplió cada hallazgo, una operación sugerida y dibujos que puedes mostrar en el gráfico o guardar como tuyos. Es un análisis automático de precios pasados, no asesoramiento de inversión. Cómo leer un hallazgo, su historial, los intervalos de confianza y la significancia: la guía del asistente de patrones.

Chart Premium (sitio web)

Los gráficos son gratis. Chart Premium añade más herramientas pesadas durante 1, 3, 6 o 12 meses, pagadas con el mismo saldo prepago que la API (los periodos largos cuestan menos al mes).

Probador de estrategias (sitio web)

Estrategia en el gráfico prueba una estrategia de trading con las velas pasadas de la temporalidad en pantalla y muestra cada operación en el gráfico, el beneficio, el drawdown, la tasa de acierto y una curva de capital frente a comprar y mantener. Elige una estrategia integrada y cambia sus parámetros, o escribe la tuya en JavaScript. Con sesión iniciada puedes probar con hasta 20,000 velas y guardar hasta 50 estrategias. Tu script solo se ejecuta en tu navegador, en un entorno aislado que no puede acceder a internet, a tu cuenta ni a este sitio.

La guía completa de la consola de backtest explica cada ajuste y resultado, toda la referencia del script (incluidos los 71 indicadores en código) y 11 ejemplos listos para usar.

const len = input("Average period", 50, { min: 2, max: 500 });
const avg = ta.sma(close, len);
plot(avg, "SMA " + len, "#2F80ED");

function onBar(i) {
  if (avg[i] == null) return;                       // still warming up
  if (position <= 0 && close[i] > avg[i]) long({ slPct: 2 });
  if (position >= 0 && close[i] < avg[i]) short({ slPct: 2 });
}

Compartir análisis y clubes

Comparte un análisis con un enlace o trabaja en equipo en un club: un espacio de trabajo común con un chat y una estantería de análisis de gráficos.

Dónde llegan las alertas: correo, Telegram, móvil, navegador y webhooks

# Python: check that a webhook really comes from us (Flask example)
import hashlib, hmac, time
from flask import Flask, request, abort
SECRET = b"your-webhook-secret"
app = Flask(__name__)

@app.post("/alerts")
def alerts():
    ts = request.headers.get("X-Alert-Timestamp", "")
    sig = request.headers.get("X-Alert-Signature", "").removeprefix("sha256=")
    good = hmac.new(SECRET, ts.encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, good) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    alert = request.get_json()
    print(alert)            # your trading bot, Slack, a spreadsheet…
    return "ok"

Límites y errores (API de precios)

Tu cuenta: claves API, seguridad y equipos

Créditos, recargas y planes

Tareas

El trabajo pesado (escaneos de patrones, grandes lotes de códigos, informes largos) espera en una cola justa en lugar de ralentizar el sitio. Panel → Tareas muestra cada uno con su puesto en la cola y el tiempo previsto; puedes salir de la página y se te avisa en el panel (y por correo en los largos) cuando termina. Una tarea que falla se reintenta automáticamente y nunca desaparece en silencio.

Ayuda y soporte

• Tickets de soporte: escríbenos desde tu panel (con capturas de pantalla); las respuestas llegan por correo y en el ticket.
• Preguntar a la IA (el botón de chat abajo a la derecha) responde preguntas sobre la plataforma en cualquier momento.
• Aprende explica cada indicador y herramienta de dibujo; el blog tiene tutoriales; el registro de cambios lista las novedades.
• Estado de un precio: GET /v1/prices/latest indica LIVE, STALE o MARKET_CLOSED para cada cotización (ver Estado del precio).

Los indicadores y dibujos se calculan en tu navegador. Los gráficos, indicadores y alertas son información, no asesoramiento de inversión.