SearchCtrl+K

Commodity Symbols API Reference

List all 245+ supported commodity symbols available in the APIFreaks Commodity API. Includes metals, energy, agriculture, industrial, raw materials, oils and meals, textiles, meats, poultry, and livestock.

GEThttps://api.apifreaks.com/v2.0/commodity/symbols

Test

Returns a list of all tradable commodities with their symbols, names, categories, pricing currency, unit of measurement, status, and update interval. Deprecated symbols are included with status: "inactive" and a deprecationDate - historical rates remain available for them up to that date, but latest rates do not.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v2.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v2.0/commodity/symbols' \
  -H 'X-apiKey: API-KEY'

Response

{
  "success": true,
  "symbols": [
    {
      "symbol": "NG-FUT",
      "category": "Energy",
      "currency": {
        "code": "USD",
        "name": "US Dollar",
        "symbol": "$"
      },
      "unit": {
        "symbol": "MMBtu",
        "name": "Million British Thermal Units"
      },
      "name": "Natural Gas Futures",
      "status": "active",
      "updateInterval": "PER_MINUTE"
    },
    {
      "symbol": "NG-EU",
      "category": "Energy",
      "currency": {
        "code": "USD",
        "name": "US Dollar",
        "symbol": "$"
      },
      "unit": {
        "symbol": "MMBtu",
        "name": "Million British Thermal Units"
      },
      "name": "Natural Gas, Europe",
      "status": "active",
      "updateInterval": "PER_MONTH",
      "exchange": "World Bank"
    },
    {
      "symbol": "UANEU",
      "category": "Industrial",
      "currency": {
        "code": "USD",
        "name": "US Dollar",
        "symbol": "$"
      },
      "unit": {
        "symbol": "T",
        "name": "Metric Ton"
      },
      "name": "Urea Ammonium Nitrate",
      "status": "inactive",
      "updateInterval": "PER_MINUTE",
      "deprecationDate": "2024-04-14"
    }
  ]
}

API Response Schema

A successful request returns a 200 OK response with an array of commodity symbols.

success

Booleanmandatory

Indicates whether the API request was successful.

An array of commodity symbol objects, each containing details about a tradable commodity.

Custom Response Headers

Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.