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

# List Metals Instruments

> List the tradeable metals instruments, keyed by symbol



## OpenAPI

````yaml get /metals/instruments
openapi: 3.0.3
info:
  title: fastFOREX.io
  version: 2.4.0
  description: Foreign & cryptocurrency exchange rate API
  termsOfService: https://www.fastforex.io/terms-of-sale
  contact:
    email: support@fastforex.io
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.fastforex.io
    description: Production
  - url: https://api.beta.fastforex.io
    description: Beta
security:
  - api_key: []
  - apiKeyHeader: []
  - bearerAuth: []
  - basicAuth: []
tags:
  - name: currency
    description: Physical currencies, rates and conversions
  - name: crypto
    description: Digital currencies, pairs & prices
  - name: fx
    description: Realtime FX trading pairs - instruments, prices and history
  - name: metals
    description: Precious and base metals - instruments, units, purities and prices
  - name: admin
    description: Account admin
  - name: plan-one
    description: Available on The One Plan
  - name: plan-extra
    description: Available on The Extra Plan
  - name: plan-premium
    description: Available on The Premium Plan
externalDocs:
  description: Find out more about fastFOREX.io
  url: https://www.fastforex.io
paths:
  /metals/instruments:
    get:
      tags:
        - metals
        - plan-premium
      description: List the tradeable metals instruments, keyed by symbol
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  ms:
                    $ref: '#/components/schemas/ResponseTime'
                  source:
                    type: string
                    description: Origin of the price data
                  instruments:
                    type: object
                    minProperties: 1
                    additionalProperties:
                      $ref: '#/components/schemas/MetalInstrument'
              example:
                instruments:
                  XAUAUD:
                    symbol: XAUAUD
                    alt: XAU/AUD
                    metal: XAU
                    name: Gold
                    category: precious_metal
                    target: AUD
                    target_name: Australian Dollar
                    unit: oz_t
                    unit_name: Troy Ounce
                    type: spot
                    purity: '1000'
                  XCUUSD:
                    symbol: XCUUSD
                    alt: XCU/USD
                    metal: XCU
                    name: Copper
                    category: base_metal
                    grade: grade_a
                    grade_name: Grade A
                    grade_min_purity_pct: 99.9935
                    target: USD
                    target_name: United States Dollar
                    unit: metric_tonne
                    unit_name: Metric Tonne
                    type: spot
                  XAGXAU:
                    symbol: XAGXAU
                    alt: XAG/XAU
                    metal: XAG
                    name: Silver
                    category: precious_metal
                    target: XAU
                    target_name: Gold
                    type: ratio
                source: otc_aggregate
                ms: 12
        '400':
          description: Bad Request
        '401':
          description: Not Authorized
        '403':
          description: Forbidden
        '429':
          description: Rate limit exceeded
components:
  schemas:
    ResponseTime:
      type: number
      format: int32
      description: Server response time in milliseconds
    MetalInstrument:
      type: object
      description: A tradeable metals instrument.
      properties:
        symbol:
          type: string
          pattern: '[A-Z]{6,7}'
          description: Instrument symbol, repeating the key so the entry stands alone
        alt:
          type: string
          description: >-
            Slash-separated form of the symbol, split after the leading metal
            code
        metal:
          $ref: '#/components/schemas/MetalSymbol'
        name:
          type: string
          description: Metal name
        category:
          $ref: '#/components/schemas/MetalCategory'
        grade:
          type: string
          description: Deliverable contract grade. Base metals only.
        grade_name:
          type: string
          description: Display name for the contract grade. Base metals only.
        grade_min_purity_pct:
          type: number
          format: float
          description: >-
            Minimum purity of the contract grade, as a percentage. Base metals
            only.
        target:
          type: string
          pattern: '[A-Z0-9]{3,6}'
          description: >-
            What the metal is priced against - a currency, a cryptocurrency, or
            another metal for a ratio
        target_name:
          type: string
          description: Display name for the target
        unit:
          $ref: '#/components/schemas/MetalUnit'
        unit_name:
          type: string
          description: Display name for the unit of mass
        purity:
          type: string
          description: >-
            Purity grade code the instrument is quoted at, as per
            /metals/purities. Precious metals only.
        type:
          $ref: '#/components/schemas/MetalInstrumentType'
      example:
        symbol: XAUUSD
        alt: XAU/USD
        metal: XAU
        name: Gold
        category: precious_metal
        target: USD
        target_name: United States Dollar
        unit: oz_t
        unit_name: Troy Ounce
        type: spot
        purity: '1000'
    MetalSymbol:
      type: string
      pattern: X[A-Z]{2}
      description: Three-letter metal symbol, e.g. XAU for gold
      example: XAU
    MetalCategory:
      type: string
      description: Whether the metal is a precious or a base metal
      enum:
        - precious_metal
        - base_metal
    MetalUnit:
      type: string
      description: Handle for a unit of mass that metal prices can be quoted in
      enum:
        - gram
        - kilogram
        - metric_tonne
        - grain
        - pennyweight
        - oz_t
        - lb_t
        - oz_av
        - lb_av
        - tael
        - baht
        - tola
    MetalInstrumentType:
      type: string
      description: >-
        spot is priced in a currency, crypto in a cryptocurrency, and ratio
        against another metal. A ratio has no unit of mass.
      enum:
        - spot
        - crypto
        - ratio
  securitySchemes:
    api_key:
      type: apiKey
      name: api_key
      in: query
    apiKeyHeader:
      type: apiKey
      name: X-API-KEY
      in: header
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: api_key
    basicAuth:
      type: http
      scheme: basic

````