API
Stagingv2

Reference data

List companies metadata

Return company profiles, the reference master for every listed security, including classification, financials and contact details. Paginated.

GET/v2/vendor/companies/metadata
Requires scopecompanies.metadata

Query parameters

ParameterDescription
page
integer
optional		Page to fetch. Defaults to 1.
limit
integer
optional		Records per page, 1 to 200. Defaults to 50.
status
string
optional		Filter by trading status, for example active.

Response fields

FieldDescription
symbol
string
Ticker used across the API.
name
string
Registered issuer name.
isin
string
ISIN identifier.
sector
string
Sector classification.
marketCap
number
Market capitalisation in Naira.
status
string
Trading status.
pagination
object
page, limit, total and totalPages.
Request
curl "https://stagingmobile.nasdng.com/v2/vendor/companies/metadata?page=1&limit=50" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"
const params = new URLSearchParams({ page: "1", limit: "50" });
const res = await fetch(
  `https://stagingmobile.nasdng.com/v2/vendor/companies/metadata?${params}`,
  { headers: { Authorization: "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx" } }
);
const { data } = await res.json();
import requests

res = requests.get(
    "https://stagingmobile.nasdng.com/v2/vendor/companies/metadata",
    params={"page": "1", "limit": "50"},
    headers={"Authorization": "Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()
Response 200 OK
{
  "success": true,
  "message": "Companies metadata fetched successfully",
  "data": {
    "data": [
      {
        "symbol": "SDNASDPLC",
        "name": "NASD Plc",
        "isin": "NGSDNASDPL08",
        "instrumentType": "Equity",
        "status": "active",
        "category": "blue",
        "sector": "Financial Services",
        "subsector": "Other Financial Institutions",
        "marketCap": 20075000000,
        "nominalValue": 0.5,
        "nasdPrice": 40.15,
        "secRegistered": true,
        "logo": "https://cdn.nasdng.com/logos/sdnasdplc.png"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 62,
      "totalPages": 2
    }
  }
}