/
Instrumentos

Instrumentos

Pedir lista de instrumentos

Este endpoint consultar por los instrumentos disponibles en el mercado.

Path: [baseURL]/rest/instruments
Method: GET
Produces: application/json
Consumes: -

Field

Req

Valid Values

Data Type

Description

Field

Req

Valid Values

Data Type

Description

“marketSegment”

N

DDF, DDA, DUAL, TIVA, MAE

String

Identificador del segmento.

“allowsRegistration”

N

 

Bool

Indica si se permiten registraciones sobre los intrumentos.

 

Response - HTTP/1.1 200 OK

Campos del body:

Field

Req.

Valid Values

Data Type

Description

Field

Req.

Valid Values

Data Type

Description

“symbol”

Y

 

String

Símbolo del instrumento.

"marketSegment"

Y

DDF, DDA, DUAL, TIVA, MAE

String

Identificador del segmento.
DDF: segmento Monedas
DDA: segmento Agro
DUAL: segmento Otros
TIVA: segmento Títulos Valores
MAE: segmento MAE

“lowLimitPrice”

Y

 

Number

Precio mínimo permitido para una orden.

"highLimitPrice"

Y

 

Number

Precio máximo permitido para una orden.

"minPriceIncrement"

Y

 

Number

Variación minima del precio para una orden.

"minTradeVol"

Y

 

Number

Cantidad minima permitida para una orden.

"maxTradeVol"

Y

 

Number

Cantidad maxima permitida para una orden.

"tickSize"

Y

 

Number

Variación minima de la cantidad para una orden.

"maturityDate"

C

 

String

Fecha de vencimiento del instrumento con formato YYYYMMDD.
Requerido cuando cficode = DXXXXX, FXXXXX, OMAOCS, DTXXXX, FXXXSX, DYXTXR, DBXXFR, OCASPS, OCAFXS, OCEFXS, OCAMPS, OXXXPS, OPASPS, OPAFXS, OPEFXS, OPAMPS, DBXXXX

"contractMultiplier"

Y

 

Number

Tamaño del instrumento.

"roundLot"

Y

 

Number

Multiplicador del instrumento.

"priceConvertionFactor"

Y

 

Number

Factor de conversion del precio.

"currency"

 

ARS, USD, BRL, EXT, UYU, UYD, USG

String

Moneda usada para el precio.
ARS = Pesos argentinos
USD = Dólar americano
BRL = Real brasilero
EXT = Dólar americano CCL
UYU = Peso uruguayo
UYD = Dólar uruguayo
USG = Dólar garantizado

"orderTypes"

Y

STOP_LIMIT, MARKET_TO_LIMIT, LIMIT, MARKET, STOP, PREVIOUSLY_QUOTED

String[]

Tipo de ordenes permitidas para el instrumento.

"timesInForce"

Y

DAY, GTC, IOC, FOK, GTD

String[]

Tiempo de vigencia de la orden validos para el instrumento. Valores validos:
DAY = Day
GTC = Good Till Cancel
IOC = Immediate or Cancel
FOK = Fill or Kill
GTD = Good Till Date

"securityType"

Y

 

String

Tipo de instrumento.

"settlType"

C

1, 2, 3, 4, 5, 6

String

Indica el período de liquidación de la orden.
1 = CI (T+0)
2 = 24 hs (T+1)
3 = 48 hs (T+2)
4 = 72 hs (T+3)
5 = 96 hs (T+4)
6 = 120 hs (T+5)
Requerido cuando cficode = ESXXXX, DYXTXR, DBXXFR, IFXXXP, MCXXXX, LRSTXH, DBXXXX

"instrumentPricePrecision"

Y

 

Number

Escala decimal del precio.

"instrumentSizePrecision"

Y

 

Number

Escala decimal de la cantidad.

"securityId"

Y

 

String

Identificador del instrumento según el securityIdSource.

"securityIdSource"

Y

8

String

Identificador de la clase o origen del "securityId".
8 = Posición ACYRSA

"securityDescription"

N

 

String

Descripción del instrumento.

"tickPriceRanges"

Y

BLOQUE []

Variación mínima dinámica del precio para una orden.

->

“lowerLimit”

Y

 

Number

Valor de la orden a partir de la cual se aplica el tick.

->

“tick”

Y

 

Number

Variación mínima del precio.

"strike"

C

 

Number

Precio de Ejercicio para opciones.
Requerido cuando cficode = OCASPS, OCAFXS, OCEFXS, OCAMPS, OPASPS, OPAFXS, OPEFXS, OPAMPS

"underlying"

Y

 

String

Producto subyacente del instrumento.

"cficode"

Y

 

String

Tipo de instrumento según ISO 10962.

“allowsRegistration”

Y

 

Bool

Indica si se permite registraciones sobre el instrumento.

“registrationTypesAllowed”

C

REGISTRATION_INTRA_AGENTS, REGISTRATION_BETWEEN_AGENTS, REGISTRATION_BOTH

String

Registraciones permitidas sobre el instrumento.
REGISTRATION_INTRA_AGENTS: Solo se permite registraciones entre cuentas del mismo agente.
REGISTRATION_BETWEEN_AGENTS: Solo se permite registraciones entre cuentas de diferentes agentes.
REGISTRATION_BOTH: Se permiten ambos casos.

Campo requerido si “allowsRegistration” = true

"registrationMarginTick"

C

 

Number

Cantidad de ticks que se puede desviar el precio de una registración en relación al mejor precio de venta y mejor precio de compra por pantalla.
Campo requerido si “allowsRegistration” = true

“registrationMinTradeVol”

C

 

Number

Cantidad minima permitida para una registración.
Campo requerido si “allowsRegistration” = true

"registrationMaxTradeVol"

C

 

Number

Cantidad maxima permitida para una registración.
Campo requerido si “allowsRegistration” = true

“registrationMinPriceIncrement"

C

 

Number

Variación minima del precio para una registración.
Campo requerido si “allowsRegistration” = true

“registrationClearingInstructions“

C

2=BILATERAL, 6=GUARANTEED

Number[]

Indica los tipos de compensación admitidos para registraciones.
En caso de no corresponder, se envía vacío.

“registrationPriceScale”

Y

 

Number

Escala decimal para el precio de las registraciones.
Campo requerido si “allowsRegistration” = true

[{ "symbol": "Instrument 02", "marketSegment": "TEST", "lowLimitPrice": 2.0, "highLimitPrice": 347.5, "minPriceIncrement": 0.100000, "minTradeVol": 1.000000, "maxTradeVol": 50.000000, "tickSize": 1.000000, "maturityDate": "20260423", "contractMultiplier": 100.000000, "roundLot": 1.000000, "priceConvertionFactor": 1.000000, "currency": "USG", "orderTypes": [ "STOP_LIMIT", "MARKET_TO_LIMIT", "LIMIT", "PREVIOUSLY_QUOTED" ], "timesInForce": [ "DAY", "FOK", "IOC", "GTD" ], "securityType": "FUTURE", "settlType": null, "instrumentPricePrecision": 1, "instrumentSizePrecision": 0, "securityId": "Instrument 02", "securityIdSource": "8", "securityDescription": null, "tickPriceRanges": [ { "lowerLimit": 0, "tick": 0.100000 } ], "strike": null, "underlying": "Product_a", "cficode": "FXXXSX", "allowsRegistration": true, "registrationTypesAllowed": "REGISTRATION_BOTH", "registrationMarginTick": 10000, "registrationMinPriceIncrement": 0.010000, "registrationMinTradeVol": 1.00, "registrationMaxTradeVol": 10000000000000.00, "registrationClearingInstructions": [ 2,6 ], "registrationPriceScale": 2 }, { "symbol": "Instrument 01", "marketSegment": "TEST", "lowLimitPrice": 2.0, "highLimitPrice": 347.5, "minPriceIncrement": 0.100000, "minTradeVol": 1.000000, "maxTradeVol": 50.000000, "tickSize": 1.000000, "maturityDate": "20260423", "contractMultiplier": 100.000000, "roundLot": 2.000000, "priceConvertionFactor": 1.000000, "currency": "USG", "orderTypes": [ "STOP_LIMIT", "MARKET_TO_LIMIT", "LIMIT", "MARKET", "STOP", "PREVIOUSLY_QUOTED" ], "timesInForce": [ "DAY", "FOK", "IOC", "GTD" ], "securityType": "FUTURE", "settlType": null, "instrumentPricePrecision": 1, "instrumentSizePrecision": 0, "securityId": "Instrument 01", "securityIdSource": "8", "securityDescription": null, "tickPriceRanges": [ { "lowerLimit": 0, "tick": 0.100000 } ], "strike": null, "underlying": "Product_a", "cficode": "FXXXSX", "allowsRegistration": true, "registrationTypesAllowed": "REGISTRATION_BOTH", "registrationMarginTick": 10000, "registrationMinPriceIncrement": 0.010000, "registrationMinTradeVol": 1.00, "registrationMaxTradeVol": 10000000000000.00, "registrationClearingInstructions": [ 6 ], "registrationPriceScale": 2 }]