> ## 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.

# get_asset

> Get a single Alpaca asset by symbol or asset ID.

## alpaca\_get\_asset

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

**Options**

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

**Request**

* `symbol_or_asset_id`: ticker symbol or Alpaca asset id.


## OpenAPI

````yaml api-reference/openapi.json get /tools/alpaca/get_asset
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/get_asset:
    get:
      tags:
        - Alpaca
      summary: get_asset
      description: Get a single Alpaca asset by symbol or asset ID.
      operationId: alpaca_get_asset
      requestBody:
        required: true
        description: This is a request to obtain information. Your API keys are required.
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - symbol_or_asset_id
              properties:
                symbol_or_asset_id:
                  type: string
                  description: Ticker symbol or Alpaca asset ID.
            example:
              symbol_or_asset_id: PTJSF
      responses:
        '200':
          description: Asset (OpenTools trading schema) or null if not found.
          content:
            application/json:
              schema:
                anyOf:
                  - 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: {}
                  - type: 'null'
        '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_get_asset"],
            )

````