How do I install the Primary skill?

Run npx skillmds@latest add gauss314/primary in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Primary skill do?

Trading API de Primary (Matba ROFEX): futuros, opciones, acciones, bonos. Órdenes, posiciones, cuenta, market data. It is listed under Integrations & APIs on SkillMD.

Is Primary safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Primary?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Primary free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Primary?

gauss314 (@gauss314) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Primary by gauss314 — Agent Skill

Name: Primary
Author: gauss314

Primary — Trading API de Matba ROFEX

API para operar en el Mercado Argentino de Futuros y Opciones (Matba ROFEX) a través de Primary Trading Platform (PTP). Soporta futuros (dólar, soja, trigo, maíz, índices), opciones sobre futuros, acciones, bonos y CEDEARs.

Base URL: https://api.remarkets.primary.com.ar

Docs: github.com/matbarofex — repositorio oficial con ejemplos open source.

Autenticación

Obtener Credenciales

Entorno	URL	Descripción
REMARKET (demo)	remarkets.primary.ventures	Crear cuenta gratis para paper trading
LIVE (producción)	Contactar a mpi@primary.com.ar	Solicitar acceso al equipo MPI

Una vez creada la cuenta en REMARKET, tendrás:

Usuario: el que registraste
Password: el que configuraste
Account: tu número de cuenta (suele ser REM + últimos dígitos del usuario)

Obtener Token

import requests

r = requests.post("https://api.remarkets.primary.com.ar/auth/getToken",
    headers={"X-Username": tu_usuario, "X-Password": tu_password})

token = r.headers["X-Auth-Token"]

El token se envía en adelante como header X-Auth-Token en todos los requests.

⚠️ NUNCA hardcodear credenciales. Usar variables de entorno o parámetros CLI.

import os
TOKEN = os.getenv("PRIMARY_TOKEN")  # Opcional: cachear token
USER = os.getenv("PRIMARY_USER")
PASS = os.getenv("PRIMARY_PASSWORD")
ACCOUNT = os.getenv("PRIMARY_ACCOUNT")  # Ej: 12345 o REM12345

Renew Token

Si recibís un 401, el token expiró. Renovalo con un nuevo POST a /auth/getToken.

Segmentos

El mercado se organiza en segmentos (ruedas de negociación). Cada instrumento pertenece a un segmento.

Segmento	Descripción
`DDF`	Derivados Financieros (futuros de dólar, índices)
`DDA`	Derivados Agropecuarios (soja, trigo, maíz)
`DUAL`	Instrumentos listados en ambas divisiones
`MERV`	Mercados externos a Matba ROFEX (BYMA)
`MAE`	Mercado Abierto Electrónico
`TEST`	Ambiente de pruebas
`U-DDF`, `U-DDA`, `U-DUAL`, `U-FIN`, `U-COMM`, `U-STOCK`	Sub-segmentos de usuarios
`TIVA`, `AVS`	Otros segmentos

Listar Segmentos

GET https://api.remarkets.primary.com.ar/rest/segment/all

r = requests.get("https://api.remarkets.primary.com.ar/rest/segment/all",
    headers={"X-Auth-Token": token})
print(r.json()["segments"])

Respuesta:

{"status":"OK","segments":[
  {"marketSegmentId":"DDF","marketId":"ROFX"},
  {"marketSegmentId":"DDA","marketId":"ROFX"},
  ...
]}

Instrumentos (Securities)

Los instrumentos se identifican por su símbolo y marketId. Ejemplos:

Símbolo	Descripción	CFI Code
`DLR/JUN26`	Futuro de dólar Junio 2026	`FXXXSX`
`SOJ.ROS/MAY26`	Futuro de soja Rosario Mayo 2026	`FXXXSX`
`DLR/JUN26 1460 C`	Opción Call sobre futuro dólar	`OCAFXS`
`DLR/JUN26 1420 P`	Opción Put sobre futuro dólar	`OPAFXS`
`GGAL`	Acción Grupo Galicia	`ESXXXX`

Todos los Instrumentos

GET https://api.remarkets.primary.com.ar/rest/instruments/all

Instrumentos con Detalle

GET https://api.remarkets.primary.com.ar/rest/instruments/details

Devuelve: symbol, segment, lowLimitPrice, highLimitPrice, minPriceIncrement, minTradeVol, maxTradeVol, tickSize, contractMultiplier, roundLot, maturityDate, currency, orderTypes, timesInForce, cficode.

Detalle de un Instrumento

GET https://api.remarkets.primary.com.ar/rest/instruments/detail?symbol=DLR/JUN26&marketId=ROFX

Por Código CFI

GET https://api.remarkets.primary.com.ar/rest/instruments/byCFICode?CFICode=FXXXSX

CFI Code	Tipo
`FXXXSX`	Futuro
`FXXXXX`	Futuro (genérico)
`OCAFXS`	Opción Call sobre Futuro
`OPAFXS`	Opción Put sobre Futuro
`OCEFXS`	Opción Call europea sobre Futuro
`OPEFXS`	Opción Put europea sobre Futuro
`ESXXXX`	Acción
`DBXXXX`	Bono
`EMXXXX`	CEDEAR
`OCASPS`	Opción Call sobre Acción
`OPASPS`	Opción Put sobre Acción
`DBXXFR`	Obligación Negociable

Por Segmento

GET https://api.remarkets.primary.com.ar/rest/instruments/bySegment?MarketSegmentID=DDF&MarketID=ROFX

Market Data

En Tiempo Real (REST Snapshot)

GET https://api.remarkets.primary.com.ar/rest/marketdata/get
    ?marketId=ROFX
    &symbol=DLR/JUN26
    &entries=BI,OF,LA,OP,CL,SE,OI
    &depth=3

Entry	Significado
`BI`	Bids (ofertas de compra en el book)
`OF`	Offers (ofertas de venta en el book)
`LA`	Last (último precio operado)
`OP`	Opening Price (precio de apertura)
`CL`	Closing Price (cierre rueda anterior)
`SE`	Settlement Price (precio de ajuste, solo futuros)
`HI`	High Price (máximo de la rueda)
`LO`	Low Price (mínimo de la rueda)
`TV`	Trade Volume (volumen operado en contratos)
`OI`	Open Interest (interés abierto, solo futuros)
`IV`	Index Value (solo índices)
`EV`	Effective Volume (solo BYMA)
`NV`	Nominal Volume (solo BYMA)
`ACP`	Auction Price (cierre del día corriente)

r = requests.get("https://api.remarkets.primary.com.ar/rest/marketdata/get",
    headers={"X-Auth-Token": token},
    params={"marketId": "ROFX", "symbol": "DLR/JUN26",
            "entries": "BI,OF,LA,OP,CL,SE,OI", "depth": 3})
data = r.json()["marketData"]
print(f"Bid: {data['BI']}  |  Offer: {data['OF']}")
print(f"Last: {data['LA']}  |  Settle: {data['SE']}")

Histórica (Trades)

GET https://api.remarkets.primary.com.ar/rest/data/getTrades
    ?marketId=ROFX
    &symbol=DLR/JUN26
    &dateFrom=2026-06-01
    &dateTo=2026-06-08

Parámetros: marketId, symbol, date (una fecha), dateFrom/dateTo (rango), external (para mercados externos), environment (REMARKETS).

r = requests.get("https://api.remarkets.primary.com.ar/rest/data/getTrades",
    headers={"X-Auth-Token": token},
    params={"marketId": "ROFX", "symbol": "DLR/JUN26",
            "date": "2026-06-05"})
trades = r.json()["trades"]
for t in trades[:3]:
    print(f"{t['datetime']}  {t['price']}  {t['size']}")

Órdenes

Tipos de Órdenes

Tipo	Descripción
`LIMIT`	Orden con precio límite
`MARKET`	Orden a mercado
`STOP_LIMIT`	Orden stop que se activa como limit
`MARKET_TO_LIMIT`	Market que se convierte en limit

Nota: STOP_LIMIT y MARKET_TO_LIMIT no están disponibles para todos los instrumentos. Verificar orderTypes en el detalle del instrumento.

Time in Force (TIF)

TIF	Descripción
`DAY`	Solo válida por el día. Se expira al cierre de rueda
`IOC`	Immediate or Cancel
`FOK`	Fill or Kill
`GTD`	Good Till Date (requiere `expireDate`)

Ingresar Orden (REST)

GET https://api.remarkets.primary.com.ar/rest/order/newSingleOrder
    ?marketId=ROFX
    &symbol=DLR/JUN26
    &side=BUY
    &orderQty=10
    &ordType=LIMIT
    &price=1450.0
    &timeInForce=DAY
    &account=TU_CUENTA
    &cancelPrevious=False
    &iceberg=False

Parámetros:

Parámetro	Tipo	Obligatorio	Descripción
`marketId`	String	✅	`ROFX`
`symbol`	String	✅	Símbolo del instrumento
`side`	String	✅	`BUY` o `SELL`
`orderQty`	Integer	✅	Cantidad de contratos
`ordType`	String	✅	`LIMIT` o `MARKET`
`price`	Float	Condicional	Requerido para LIMIT
`timeInForce`	String	No	`DAY` (default), `IOC`, `FOK`, `GTD`
`account`	Integer/String	✅	Número de cuenta
`cancelPrevious`	Boolean	No	Cancela órdenes previas del mismo contrato/lado
`iceberg`	Boolean	No	Orden Iceberg (default: false)
`displayQty`	Integer	Condicional	Cantidad a divulgar (para iceberg)
`expireDate`	Date	Condicional	Requerido para GTD (formato: YYYYMMDD)

Respuesta:

{"status":"OK","order":{"clientId":"21581341758","proprietary":"PBCP"}}

El clientId es el clOrdId (Client Order ID) que se usa para consultar/cancelar la orden.

Ingresar Orden (WebSocket)

{"type":"no","product":{"marketId":"ROFX","symbol":"DLR/JUN26"},
 "price":185,"quantity":23,"side":"BUY","account":"20","iceberg":false}

Para identificar la orden vía WebSocket, incluir wsClOrdId:

{"type":"no","product":{"marketId":"ROFX","symbol":"DLR/JUN26"},
 "price":185,"quantity":23,"side":"BUY","account":"20",
 "iceberg":false,"wsClOrdId":"mioid-unico-123"}

Respuesta WebSocket (Execution Report):

{"type":"or","orderReport":{"orderId":"1128056","clOrdId":"user14545...",
 "status":"PENDING_NEW","text":"Enviada","wsClOrdId":"mioid-unico-123"}}

Importante: El wsClOrdId solo aparece en el primer execution report. Luego se debe usar el clOrdId devuelto para seguimiento.

Reemplazar Orden

GET https://api.remarkets.primary.com.ar/rest/order/replaceById
    ?clOrdId=user144733478280357
    &proprietary=api
    &price=17
    &orderQty=10

Cancelar Orden

GET https://api.remarkets.primary.com.ar/rest/order/cancelById
    ?clOrdId=ajduj3l13ieci2jr4ck
    &proprietary=PBCP

Cancelar por WebSocket

{"type":"co","clientId":"user114121092035207","proprietary":"PBCP"}

Consultar Estado de la Orden (REST)

Endpoint	Descripción
`GET /rest/order/id?clOrdId=...&proprietary=api`	Último estado del request
`GET /rest/order/allById?clOrdId=...&proprietary=api`	Todos los estados del request
`GET /rest/order/byOrderId?orderId=...`	Estado por Order ID
`GET /rest/order/actives?accountId=10`	Órdenes activas (NEW o PARTIALLY_FILLED)
`GET /rest/order/filleds?accountId=10`	Órdenes total o parcialmente operadas
`GET /rest/order/all?accountId=10`	Todos los estados de la cuenta
`GET /rest/order/byExecId?execId=T1234567`	Estado por Execution ID

Execution Reports (WebSocket)

Suscribirse a una cuenta:

{"type":"os","account":{"id":"40"}}

Varias cuentas:

{"type":"os","accounts":[{"id":"40"},{"id":"4000"}]}

Todas las cuentas:

{"type":"os"}

Solo órdenes activas:

{"type":"os","snapshotOnlyActive":true}

Risk API

La Risk API usa HTTP Basic Auth con el mismo user/password, no token. Requiere el header Authorization: Basic <base64> adicionalmente al X-Auth-Token.

import base64
auth = base64.b64encode(f"{user}:{password}".encode()).decode()
headers = {"X-Auth-Token": token, "Authorization": f"Basic {auth}"}

Posiciones de una Cuenta

GET https://api.remarkets.primary.com.ar/rest/risk/position/getPositions/{accountName}

r = requests.get(f"https://api.remarkets.primary.com.ar/rest/risk/position/getPositions/TU_CUENTA",
    headers=headers)
positions = r.json()["positions"]
for p in positions:
    print(f"{p['symbol']}  Buy:{p['buySize']}  Sell:{p['sellSize']}  Diff:{p['totalDiff']}")

Posiciones Detalladas

GET https://api.remarkets.primary.com.ar/rest/risk/detailedPosition/{accountName}

Devuelve desglose por instrumento con: contractType, marketPrice, currency, exchangeRate, contractMultiplier, buyCurrentSize, sellCurrentSize, detailedDailyDiff.

Reporte de Cuenta

GET https://api.remarkets.primary.com.ar/rest/risk/accountReport/{accountName}

import base64
auth = base64.b64encode(f"{user}:{password}".encode()).decode()
headers = {"X-Auth-Token": token, "Authorization": f"Basic {auth}"}
r = requests.get(f"https://api.remarkets.primary.com.ar/rest/risk/accountReport/TU_CUENTA",
    headers=headers)
data = r.json()["accountData"]
print(f"Colateral: {data['collateral']}")
print(f"Margen: {data['margin']}")
print(f"Disponible: {data['availableToCollateral']}")
# Saldos por moneda
for moneda, saldo in data['detailedAccountReports']['0']['currencyBalance']['detailedCurrencyBalance'].items():
    print(f"  {moneda}: consumido={saldo['consumed']}  disponible={saldo['available']}")

WebSocket

URL: wss://api.remarkets.primary.com.ar/

La API WebSocket recibe mensajes asíncronos. El token se envía como header en la conexión:

import websocket

ws = websocket.WebSocketApp(
    "wss://api.remarkets.primary.com.ar/",
    header=[f"X-Auth-Token: {token}"],
   
   
    ...
)
ws.run_forever()

Los mensajes tienen el formato:

type	Significado
`no`	New Order (enviar orden)
`co`	Cancel Order (cancelar orden)
`or`	Order Report (execution report recibido)
`os`	Order Subscription (suscribirse a reports)
`smd`	Subscribe Market Data
`Md`	Market Data (recibido)

Market Data por WebSocket

{"type":"smd","level":1,"entries":["OF","BI","LA"],
 "products":[{"symbol":"DLR/JUN26","marketId":"ROFX"}],"depth":2}

Respuesta:

{"type":"Md","instrumentId":{"marketId":"ROFX","symbol":"DLR/JUN26"},
 "marketData":{"OF":[{"price":189,"size":21},{"price":188,"size":13}]}}

Estados de una Orden

Estado	Significado
`PENDING_NEW`	Enviada al mercado, aún no procesada
`NEW`	Aceptada, activa en el book
`PARTIALLY_FILLED`	Parcialmente operada
`FILLED`	Totalmente operada
`CANCELLED`	Cancelada
`REJECTED`	Rechazada (ver `text` para motivo)
`PENDING_CANCEL`	Cancelación en proceso
`PENDING_REPLACE`	Reemplazo en proceso
`REPLACED`	Reemplazada
`PENDING_APPROVAL`	Pendiente de aprobación

Errores Comunes

Error	Causa	Solución
401 Unauthorized	Token inválido o expirado	Renovar con `/auth/getToken`
`"No tiene acceso a la cuenta"`	Account ID incorrecto	Verificar `accountId`
`"Product doesn't exist"`	Symbol incorrecto	Verificar símbolo con `instruments/all`
`"Access Denied"`	Sin permisos para el endpoint	Verificar segmento/método
`"Ruta invalida"`	Endpoint no existe	Revisar URL
Bid/Offer vacíos	Mercado cerrado o sin liquidez	Consultar en horario de rueda

Scripts de Ejemplo

Ver ./scripts/:

# Autenticación y token (opcional, los scripts hacen login automático)
export PRIMARY_USER="tu_usuario"
export PRIMARY_PASSWORD="tu_password"
export PRIMARY_ACCOUNT="TU_CUENTA"

# Listar segmentos e instrumentos
python scripts/instruments.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD

# Market data de un futuro
python scripts/market_data.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --symbol DLR/JUN26 --entries BI,OF,LA

# Ver reporte de cuenta
python scripts/check_account.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --account TU_CUENTA

# Ver posiciones
python scripts/check_positions.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --account TU_CUENTA

# Enviar orden (¡cuidado! orden real en live)
python scripts/place_order.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --symbol DLR/JUN26 --side BUY --qty 1 --type LIMIT --price 1450 --account TU_CUENTA

# WebSocket: Market Data en tiempo real
python scripts/websocket_md.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --symbols DLR/JUN26 --entries BI,OF,LA --depth 3

# WebSocket: Execution Reports
python scripts/websocket_orders.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --account TU_CUENTA

# WebSocket: Enviar orden (requiere suscripción a execution reports aparte)
python scripts/websocket_send_order.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --symbol DLR/JUN26 --side BUY --qty 1 --type LIMIT --price 1450 --account TU_CUENTA

# WebSocket: Cancelar orden
python scripts/websocket_send_order.py --user $PRIMARY_USER --password $PRIMARY_PASSWORD \
    --cancel --clordid user12345... --proprietary PBCP

Glosario de Campos

Campo	Descripción
`clOrdId`	Client Order ID — ID del request al mercado
`orderId`	Order ID — ID de la orden en el mercado
`execId`	Execution ID — ID de una ejecución particular
`proprietary`	Usuario FIX que envió la orden (`PBCP` o `ISV_PBCP`)
`wsClOrdId`	ID de orden enviada por WebSocket (solo en 1er report)
`avgPx`	Precio promedio operado
`cumQty`	Cantidad acumulada operada
`leavesQty`	Cantidad remanente
`lastPx`	Último precio operado
`lastQty`	Última cantidad operada
`transactTime`	Fecha y hora de la transacción
`tickSize`	Incremento mínimo de cantidad
`minPriceIncrement`	Incremento mínimo de precio (tick price)
`contractMultiplier`	Multiplicador del contrato
`maturityDate`	Fecha de vencimiento
`priceConvertionFactor`	Factor para precio unitario
`lowLimitPrice`	Límite mínimo de precio
`highLimitPrice`	Límite máximo de precio

Primary

File contents

Primary — Trading API de Matba ROFEX

Autenticación

Obtener Credenciales

Obtener Token

Renew Token

Segmentos

Listar Segmentos

Instrumentos (Securities)

Todos los Instrumentos

Instrumentos con Detalle

Detalle de un Instrumento

Por Código CFI

Por Segmento

Market Data

En Tiempo Real (REST Snapshot)

Histórica (Trades)

Órdenes

Tipos de Órdenes

Time in Force (TIF)

Ingresar Orden (REST)

Ingresar Orden (WebSocket)

Reemplazar Orden

Cancelar Orden

Cancelar por WebSocket

Consultar Estado de la Orden (REST)

Execution Reports (WebSocket)

Risk API

Posiciones de una Cuenta

Posiciones Detalladas

Reporte de Cuenta

WebSocket

Market Data por WebSocket

Estados de una Orden

Errores Comunes

Scripts de Ejemplo

Glosario de Campos

Frequently asked questions

Primary

File contents

Primary — Trading API de Matba ROFEX

Autenticación

Obtener Credenciales

Obtener Token

Renew Token

Segmentos

Listar Segmentos

Instrumentos (Securities)

Todos los Instrumentos

Instrumentos con Detalle

Detalle de un Instrumento

Por Código CFI

Por Segmento

Market Data

En Tiempo Real (REST Snapshot)

Histórica (Trades)

Órdenes

Tipos de Órdenes

Time in Force (TIF)

Ingresar Orden (REST)

Ingresar Orden (WebSocket)

Reemplazar Orden

Cancelar Orden

Cancelar por WebSocket

Consultar Estado de la Orden (REST)

Execution Reports (WebSocket)

Risk API

Posiciones de una Cuenta

Posiciones Detalladas

Reporte de Cuenta

WebSocket

Market Data por WebSocket

Estados de una Orden

Errores Comunes

Scripts de Ejemplo

Glosario de Campos

Related skills

Frequently asked questions

How do I install the Primary skill?

What does the Primary skill do?

Is Primary safe to use?

Which AI agents work with Primary?

Is Primary free to use?

Who published Primary?