# List Stock Instruments

Retrieves security information for one or more instruments.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://hk-co-branding-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/instruments/stocks/profiles/list",
  "method": "post",
  "tags": [
    "Instruments"
  ],
  "description": "Retrieves security information for one or more instruments.",
  "operationId": "listUsingGET",
  "parameters": [
    {
      "name": "access_token",
      "in": "header",
      "description": "User's authenticated token.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "reqid",
      "in": "header",
      "description": "The unique ID for this request. Suggest using UUID.",
      "schema": {
        "type": "string"
      },
      "example": "2e46d5a4-bef9-4507-8cda-98f85d2f770c"
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "type": "array",
          "items": {
            "required": [
              "category",
              "symbols"
            ],
            "type": "object",
            "properties": {
              "category": {
                "type": "string",
                "description": "Security type. Category values are as shown in the enum.",
                "example": "US_STOCK",
                "enum": [
                  "US_STOCK"
                ]
              },
              "symbols": {
                "type": "array",
                "description": "List of security symbols, supports JSON array format.",
                "example": [
                  "AAPL",
                  "GOOG"
                ],
                "items": {
                  "type": "string",
                  "description": "List of security symbols, supports JSON array format.",
                  "example": "[\"AAPL\",\"GOOG\"]"
                }
              }
            },
            "description": "List of security symbols by security type",
            "title": "MultiCategory"
          }
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Security name",
                  "example": "Apple"
                },
                "symbol": {
                  "type": "string",
                  "description": "Security symbol.",
                  "example": "AAPL"
                },
                "category": {
                  "type": "string",
                  "description": "Security category.",
                  "example": "US_STOCK"
                },
                "exchange_code": {
                  "type": "string",
                  "description": "Exchange code",
                  "example": "NAQ"
                },
                "currency": {
                  "type": "string",
                  "description": "Currency",
                  "example": "USD"
                },
                "subtype": {
                  "type": "string",
                  "description": "Security Subtypes",
                  "example": "COMMON_STOCK",
                  "enum": [
                    "COMMON_STOCK",
                    "ETF",
                    "INDEX",
                    "PREFERRED_STOCK",
                    "WARRANT",
                    "UNITS",
                    "RIGHT"
                  ]
                },
                "is_adr": {
                  "type": "string",
                  "description": "Is ADR, true or false",
                  "example": "false"
                }
              },
              "description": "Securities Information",
              "title": "InstrumentVo"
            }
          }
        }
      }
    }
  },
  "jsonRequestBodyExample": [
    {
      "category": "US_STOCK",
      "symbols": [
        "AAPL",
        "GOOG"
      ]
    }
  ],
  "postman": {
    "name": "List Stock Instruments",
    "description": {
      "content": "Retrieves security information for one or more instruments.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "instruments",
        "stocks",
        "profiles",
        "list"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) User's authenticated token.",
          "type": "text/plain"
        },
        "key": "access_token",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "The unique ID for this request. Suggest using UUID.",
          "type": "text/plain"
        },
        "key": "reqid",
        "value": ""
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "POST",
    "body": {
      "mode": "raw",
      "raw": "",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    }
  }
}
```