# Commodities

The commodities endpoint provides a daily updated list of available commodity pairs, across precious metals, livestock, softs, grains, etc.

**API credits cost:** `1` per request

## Parameters

- `symbol` (string, optional)
  The ticker symbol of an instrument for which data is requested
  Example value: `XAU/USD`


- `category` (string, optional)
  Filter by category of commodity
  Example value: `Precious Metal`


- `format` (string, optional)
  The format of the response data
  Available values: `JSON`, `CSV`
  Default value: `JSON`


- `delimiter` (string, optional)
  The separator used in the CSV response data
  Default value: `;`


- `page` (integer, optional)
  Page number of the results to fetch
  Default value: `1`


- `outputsize` (integer, optional)
  Determines the number of data points returned in the output



## Response

- `count` (integer)
  Count

- `data` (array of object)
  List of commodities
  - `symbol` (string)
    Currency pair according to ISO 4217 standard codes with slash(/) delimiter
  - `name` (string)
    Full name of the instrument
  - `category` (string)
    Category of commodity
  - `description` (string)
    Short description of the commodity

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/commodities?apikey=demo"
```

## Example Response

```json
{
    "count": 100,
    "data": [
        {
            "category": "Agricultural Product",
            "description": "Standardized contract to buy or sell a set quantity of corn at a future date.",
            "name": "Corn Futures",
            "symbol": "C_1"
        },
        {
            "category": "Agricultural Product",
            "description": "Agreement to transact cocoa beans at a predetermined price and date.",
            "name": "Cocoa Futures",
            "symbol": "CC1"
        },
        {
            "category": "Precious Metal",
            "description": "Spot price per troy ounce of gold.",
            "name": "Gold Spot",
            "symbol": "XAU/USD"
        }
    ],
    "status": "ok"
}
```