> ## Documentation Index
> Fetch the complete documentation index at: https://opentools.page/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# list_assets

> List Alpaca assets.

## alpaca\_list\_assets

```python
tools = trading.alpaca(
    api_key=os.environ["ALPACA_KEY"],
    api_secret=os.environ["ALPACA_SECRET"],
    model="openai",
    paper=True,
    minimal=True,
    include=["alpaca_list_assets"],
)
```

**Options**

* `include` / `exclude`: filter which tools are exposed (use full names like `alpaca_list_assets`).
* `minimal`: omit `provider` and `provider_fields` when `True`.
* `paper`: use Alpaca paper trading instead of live trading.


## OpenAPI

````yaml api-reference/openapi.json get /tools/alpaca/list_assets
openapi: 3.1.0
info:
  title: OpenTools Trading Tools
  version: 0.1.0
  description: >-
    Reference for OpenTools trading tool calls. These are SDK tools, documented
    as virtual endpoints for clarity.
servers: []
security: []
tags:
  - name: Alpaca
    description: >-
      Read-only account + assets + clock + orders + portfolio history +
      positions.
  - name: Coinbase
    description: >-
      Accounts + portfolios + portfolio breakdown + positions (derived) +
      brokerage products + orders (if available).
paths:
  /tools/alpaca/list_assets:
    get:
      tags:
        - Alpaca
      summary: list_assets
      description: List Alpaca assets.
      operationId: alpaca_list_assets
      requestBody:
        required: false
        description: This is a request to obtain information. Your API keys are required.
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              description: ''
            example: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties: false
                  required:
                    - symbol
                  description: ''
                  properties:
                    provider:
                      type:
                        - string
                        - 'null'
                      description: Trading provider identifier. Omitted when minimal=True.
                    id:
                      type:
                        - string
                        - 'null'
                      description: Provider asset id when available.
                    symbol:
                      type: string
                      description: Ticker symbol or asset symbol.
                    name:
                      type:
                        - string
                        - 'null'
                      description: Human-readable asset name when available.
                    exchange:
                      type:
                        - string
                        - 'null'
                      description: Exchange code when available (provider dependent).
                    asset_class:
                      type:
                        - string
                        - 'null'
                      description: >-
                        Canonical asset class when available. Some providers use
                        different naming (e.g. Alpaca uses 'class').
                    status:
                      type:
                        - string
                        - 'null'
                      description: >-
                        Provider status when available (e.g. 'active',
                        'inactive').
                    tradable:
                      type:
                        - boolean
                        - 'null'
                      description: Whether the asset is tradable on the provider, if known.
                    marginable:
                      type:
                        - boolean
                        - 'null'
                      description: >-
                        Whether the asset is marginable on the provider, if
                        known.
                    shortable:
                      type:
                        - boolean
                        - 'null'
                      description: >-
                        Whether the asset is shortable on the provider, if
                        known.
                    easy_to_borrow:
                      type:
                        - boolean
                        - 'null'
                      description: >-
                        Whether the asset is easy-to-borrow on the provider, if
                        known.
                    fractionable:
                      type:
                        - boolean
                        - 'null'
                      description: >-
                        Whether fractional trading is supported on the provider,
                        if known.
                    provider_fields:
                      type: object
                      description: >-
                        Additional provider-specific fields. Omitted when
                        minimal=True
                      additionalProperties: true
                      default: {}
                  examples:
                    - provider: <string>
                      id: <string>
                      symbol: <string>
                      name: <string>
                      exchange: <string>
                      asset_class: <string>
                      status: <string>
                      tradable: true
                      marginable: true
                      shortable: true
                      easy_to_borrow: true
                      fractionable: true
                      provider_fields: {}
        '401':
          description: Unauthorized (missing/invalid credentials).
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  message:
                    type: string
                  domain:
                    type: string
                  provider:
                    type: string
                  details: {}
                required:
                  - message
        '429':
          description: Rate limited by provider or transport.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  message:
                    type: string
                  domain:
                    type: string
                  provider:
                    type: string
                  details: {}
                required:
                  - message
      x-codeSamples:
        - lang: python
          label: Python
          source: |
            import os
            from opentools import trading

            tools = trading.alpaca(
                api_key=os.environ["ALPACA_KEY"],
                api_secret=os.environ["ALPACA_SECRET"],
                model="openai",
                paper=True,
                minimal=True,
                include=["alpaca_list_assets"],
            )

````