# Director dealings (insider trades)

> Structured director-dealing filings: who bought or sold, role, volume, price, total value and holdings after the trade, plus weekly net insider flow and the most active tickers.

```http
GET https://koboterminal.com/api/ngxdata/insider-signal
```

**Plan:** Professional and above (from ₦75,000 / $50 a month). Professional and above get the full feed. Lower tiers receive a limited preview.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `symbol` | query | string | no | Filter by ticker (e.g. `FIRSTHOLDCO`) |
| `side` | query | string | no | buy or sell |
| `days` | query | integer | no | Only filings from the last N days (e.g. `30`) |
| `limit` | query | integer | no | Max rows, default 100, max 500 |

## Request

```bash
curl "https://koboterminal.com/api/ngxdata/insider-signal?days=30" \
  -H "X-API-Key: $KOBO_API_KEY"
```

```python
import os, requests

r = requests.get(
    "https://koboterminal.com/api/ngxdata/insider-signal",
    params={"days": "30"},
    headers={"X-API-Key": os.environ["KOBO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
data = r.json()
```

```javascript
const res = await fetch("https://koboterminal.com/api/ngxdata/insider-signal?days=30", {
  headers: { "X-API-Key": process.env.KOBO_API_KEY },
});
if (!res.ok) throw new Error(`Kobo API ${res.status}`);
const data = await res.json();
```

## Response

Real response from the live API on 18 November 2026, trimmed to the first item of each list:

```json
{
  "success": true,
  "count": 2,
  "data": [
    {
      "symbol": "NEIMETH",
      "company": "NEIMETH INTERNATIONAL PHARMACEUTICALS PLC",
      "insider_name": "Clinoscope Services Limited",
      "role": "Substantial Shareholder",
      "transaction_type": "buy",
      "volume": 74726661,
      "price": 6,
      "total_value": 448359966,
      "post_trade_holdings": null,
      "dealing_date": "2026-11-10",
      "disclosure_created_at": "2026-11-13T20:15:04+00:00",
      "pdf_url": "https://doclib.ngxgroup.com/Financial_NewsDocs/118_DEALING_IN_SHARES_CLINOSCOPE_PURCHASES_NOVEMBER_2026.pdf"
    }
  ],
  "stats": {
    "week_net_flow": 318859966,
    "week_total_buys": 448359966,
    "week_total_sells": 129500000,
    "week_dealings": 2,
    "biggest_buy": {
      "symbol": "NEIMETH",
      "transaction_type": "buy",
      "total_value": 448359966,
      "volume": 74726661
    },
    "biggest_sell": {
      "symbol": "ACCESSCORP",
      "transaction_type": "sell",
      "total_value": 129500000,
      "volume": 5000000
    },
    "top_tickers": [
      {
        "symbol": "NEIMETH",
        "net": 448359966,
        "buys": 448359966,
        "sells": 0
      }
    ]
  }
}
```

## Use it from an AI assistant

This endpoint is available as the `get_insider_dealings` tool on the Kobo Terminal MCP server (`https://koboterminal.com/mcp`). See [MCP server](https://koboterminal.com/docs/mcp).

## Errors

Standard errors apply: see [Rate limits and errors](https://koboterminal.com/docs/errors).
