Assets e Instrumentos Disponibles

Busca instrumentos internacionales por símbolo, nombre o bolsa y usa paginación para navegar resultados.

Busca instrumentos disponibles para operar en bolsa internacional usando filtros por mercado, símbolo o nombre.

Qué puedes hacer con este endpoint

Usa GET /api/publicapi/creasys/Asset para:

  • buscar instrumentos por nombre o símbolo
  • filtrar por bolsa o mercado
  • consultar un instrumento específico por símbolo exacto
  • paginar resultados cuando la búsqueda devuelve muchos registros
💡

Este endpoint es la base para construir buscadores de instrumentos antes de enviar órdenes internacionales con CodBolsa = "ALPACA".


Buscar assets

→ GET /api/publicapi/creasys/Asset

Servicio para obtener los instrumentos disponibles para operar en bolsa internacional, con opciones de búsqueda y filtrado por mercado, símbolo o nombre.

Parámetros de búsqueda

ParámetroDescripciónObligatorio
exchangeNameNombre del mercado o bolsa donde se negocia el instrumento. Ejemplos: NASDAQ, NYSE. Si se omite, devuelve instrumentos de todos los mercadosNo
searchBúsqueda amplia por símbolo o nombre completo del instrumento. Ejemplo: AppleNo
id_correlativoIdentificador correlativo interno del instrumento en el sistemaNo
nemoBúsqueda exacta por símbolo del instrumento. Ejemplo: AAPLNo
pageNúmero de página para paginación. Valor por defecto: 1No
pageSizeCantidad máxima de registros por página. Valor por defecto: 20No

Cómo usar los filtros

Búsqueda amplia

Usa search cuando quieras buscar por nombre o símbolo sin conocer el valor exacto.

Ejemplo:

GET /api/publicapi/creasys/Asset?search=Apple

Búsqueda exacta por símbolo

Usa nemo cuando ya conoces el ticker exacto.

Ejemplo:

GET /api/publicapi/creasys/Asset?nemo=AAPL

Filtro por bolsa

Usa exchangeName para limitar los resultados a una bolsa específica.

Ejemplo:

GET /api/publicapi/creasys/Asset?exchangeName=NASDAQ

Paginación

Usa page y pageSize para dividir resultados extensos.

Ejemplo:

GET /api/publicapi/creasys/Asset?search=tech&page=1&pageSize=20

Respuesta

{
  "items": [
    {
      "asset_id": "b0b6dd9d-8b9b-48a9-ba46-b9d54906e415",
      "symbol": "AAPL",
      "exchange": "NASDAQ",
      "asset_class": "us_equity",
      "name": "Apple Inc. Common Stock",
      "tradable": true,
      "marginable": true
    },
    {
      "asset_id": "8ccae427-5dd0-45b3-b5fe-7ba5e422c766",
      "symbol": "TSLA",
      "exchange": "NASDAQ",
      "asset_class": "us_equity",
      "name": "Tesla, Inc. Common Stock",
      "tradable": true,
      "marginable": true
    }
  ],
  "totalCount": 250
}

Campos de la respuesta

CampoDescripción
asset_idIdentificador único del instrumento
symbolSímbolo bursátil del instrumento
exchangeBolsa donde se negocia
asset_classClase de activo
nameNombre completo del instrumento
tradableIndica si el instrumento está disponible para operar
marginableIndica si permite operaciones con margen
totalCountTotal de registros que coinciden con la búsqueda

Flujo recomendado

  1. Busca instrumentos con search si no conoces el ticker exacto
  2. Usa nemo para validar el símbolo final antes de operar
  3. Filtra por exchangeName si tu interfaz separa instrumentos por mercado
  4. Usa el symbol obtenido como Nemotecnico al enviar órdenes internacionales

Siguiente paso

Continúa con Órdenes Internacionales para enviar una orden con CodBolsa = "ALPACA" usando el símbolo encontrado.