Quick Start

curl -X GET "https://api.gofarmrate.com/v1/commodities" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/v1/commodities

Retrieve a list of all available commodities

Query Parameters
category - Filter by category (optional)
limit - Number of results (default: 100)
offset - Pagination offset (default: 0)
Response Example
{
                    "status": "success",
                    "data": {
                      "commodities": [
                        {
                          "id": "tom-001",
                          "name": "Tomatoes",
                          "category": "Vegetables",
                          "unit": "bag",
                          "markets_count": 150
                        }
                      ],
                      "total": 1234,
                      "limit": 100,
                      "offset": 0
                    }
                  }
GET/v1/markets

Get a list of markets by state or LGA

Query Parameters
state - Filter by state (optional)
lga - Filter by Local Government Area (optional)
active - Only active markets (default: true)
Response Example
{
                      "status": "success",
                      "data": {
                        "markets": [
                          {
                            "id": "mkt-001",
                            "name": "Mile 12 Market",
                            "state": "Lagos",
                            "lga": "Kosofe",
                            "active": true,
                            "commodities_count": 89
                          }
                        ]
                      }
                    }