marketsinsider tradesngx

Director dealings in Nigerian stocks: accessing Form 3 insider data via API

How to access NGX director dealings, Form 3 disclosures, and insider trade signals for Nigerian stocks via the Mansa API insider-trades endpoint.

2026-05-29·7 min read

When a director or major shareholder of a Nigerian listed company buys or sells shares, they must disclose it to the NGX. These director dealings — the Nigerian equivalent of Form 3/4 insider filings — are a powerful signal. The Mansa API parses these disclosures and exposes them as structured data, the only API offering this for African markets.

The insider-trades endpoint

curl
curl "https://mansaapi.com/api/v1/markets/exchanges/NGX/insider-trades?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "success": true,
  "count": 12,
  "data": [
    {
      "symbol": "GTCO",
      "company": "Guaranty Trust Holding Company",
      "insider_name": "Segun Agbaje",
      "role": "Group CEO",
      "transaction_type": "buy",
      "volume": 500000,
      "price": 42.50,
      "total_value": 21250000,
      "dealing_date": "2026-05-15"
    }
  ],
  "stats": {
    "week_net_flow": 45000000,
    "week_total_buys": 60000000,
    "week_total_sells": 15000000
  }
}
This endpoint requires a Pro tier key ($49/month). Insider data is the most differentiated dataset in the Mansa API — no other API provides parsed director dealings for Nigerian stocks.

Filtering

Query parameters
?symbol=GTCO     Filter to one stock
?side=buy        Only buys (or "sell")
?days=30         Lookback window
?limit=100       Max records (up to 500)

Node.js — track insider buying in a stock

Node.js
import { MansaAPI } from "mansaapi";

const mansa = new MansaAPI({ apiKey: "mansa_live_sk_..." });

const insider = await mansa.markets.getInsiderTrades("NGX", {
  symbol: "GTCO",
  side: "buy",
  days: 90,
});

console.log(`${insider.count} insider buys in 90 days`);
console.log(`Net flow this week: ₦${insider.stats.week_net_flow.toLocaleString()}`);

Why insider data matters

Insider buying is one of the few signals where the actor has both information and capital at risk. A cluster of director purchases often precedes positive news; heavy insider selling can be an early warning. Aggregated net-flow stats let you screen the whole market for unusual insider activity in one call.

What you can build

Insider-activity dashboards, smart-money screeners, alert systems for director dealings in stocks you hold, and research tools that surface unusual insider flow. This is premium institutional-grade data at a developer-friendly price.

See the pricing page for Pro tier details, or the markets docs for the full endpoint reference.

Try it now

Free API key — 100 requests/day, no credit card.

Read docs