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

# Get Company Crypto Holdings

> [OpenAPI JSON Spec](/docs/output/v1_crypto_holdings_get.json)
**Feature Overview**
Retrieve company crypto holdings filtered by token symbol.

**Supported Tokens:** BTC, ETH, SOL, BNB

**Filters (optional):**
- `crypto_nav_to_market_cap_ratio_min` / `crypto_nav_to_market_cap_ratio_max`: range [0, 2]
- `limit`: 1-100, default unlimited (server caps at 100)

**Implementation:** Served from an in-memory snapshot refreshed every
10 minutes. The underlying CoinGecko sync runs daily, so the cache
is always within one refresh window of the freshest available data.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/crypto/holdings
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/crypto/holdings:
    get:
      tags:
        - Crypto
      summary: Get Company Crypto Holdings
      description: >-
        [OpenAPI JSON Spec](/docs/output/v1_crypto_holdings_get.json)

        **Feature Overview**

        Retrieve company crypto holdings filtered by token symbol.


        **Supported Tokens:** BTC, ETH, SOL, BNB


        **Filters (optional):**

        - `crypto_nav_to_market_cap_ratio_min` /
        `crypto_nav_to_market_cap_ratio_max`: range [0, 2]

        - `limit`: 1-100, default unlimited (server caps at 100)


        **Implementation:** Served from an in-memory snapshot refreshed every

        10 minutes. The underlying CoinGecko sync runs daily, so the cache

        is always within one refresh window of the freshest available data.
      parameters:
        - description: Token symbol (BTC, ETH, SOL, or BNB)
          in: query
          name: symbol
          required: true
          schema:
            type: string
        - description: Minimum NAV/market cap ratio (0-2)
          in: query
          name: crypto_nav_to_market_cap_ratio_min
          schema:
            type: number
            format: float64
        - description: Maximum NAV/market cap ratio (0-2)
          in: query
          name: crypto_nav_to_market_cap_ratio_max
          schema:
            type: number
            format: float64
        - description: Result limit (1-100)
          in: query
          name: limit
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: Company crypto holdings
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.CryptoHoldingInfo'
                        type: array
                    type: object
        '400':
          description: Parameter validation error
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
        '503':
          description: Cache not yet warmed up
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.CryptoHoldingInfo:
      properties:
        company_name:
          description: Company name
          type: string
        country:
          description: Country
          type: string
        symbol:
          description: Company stock symbol
          type: string
        token_holdings:
          additionalProperties:
            $ref: '#/components/schemas/model.TokenHoldingAmount'
          description: '{ "<TOKEN>": {"amount": <float>} }'
          type: object
        updated_at:
          description: >-
            Data update time, RFC3339 (max updated_at across the company's token
            rows)
          example: '2025-09-09T12:09:15Z'
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.TokenHoldingAmount:
      properties:
        amount:
          type: number
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````