Returns groups of distinct insiders who traded the same symbol in the same direction within a configurable lookback window. By default, a cluster requires at least three distinct insiders, and you can adjust both the lookback period and minimum number of insiders.The endpoint identifies patterns in the available filings. It does not determine whether the trades were coordinated or what motivated them.This endpoint requires a Business plan.
Check insider_type_breakdown before interpreting a cluster. It shows the types of insiders represented in the group, which can help distinguish activity spread across employees from activity concentrated among directors or senior officers. For example, a cluster dominated by employee/staff records may reflect broader employee participation. Both patterns can produce the same basic “N insiders traded” count, so the breakdown provides important context. A cluster should be treated as a pattern in the filings, not as evidence of coordinated intent or investment conviction.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"NGN Market API","description":"Access real-time and historical NGX market data including equities, forex rates, company profiles, indices, bonds, and financial news.","colors":{"primary":"#1a6b3c","light":"#22c55e","dark":"#16a34a"},"favicon":"https://mintcdn.com/ngnmarket/VhAlvr_x14B_JerF/favicon.ico?fit=max\u0026auto=format\u0026n=VhAlvr_x14B_JerF\u0026q=85\u0026s=beee26fbf7d216bb5cc3c16341cd73f2","navbar":{"links":[{"href":"https://ngnmarket.com/contact","label":"Support"},{"href":"https://discord.gg/d96fHBUUSR","label":"Join Community"}],"primary":{"type":"button","label":"Get API Key","href":"https://ngnmarket.com/developer"}},"footer":{"socials":{"x":"https://x.com/ngnmarket","discord":"https://discord.gg/d96fHBUUSR","github":"https://github.com/ngnmarket","linkedin":"https://www.linkedin.com/company/ngnmarket"}},"seo":{"indexing":"all"},"interaction":{"drilldown":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://ngnmarket.com/dashboard"},{"anchor":"Blog","icon":"newspaper","href":"https://ngnmarket.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ngnmarket","hasAudioNarration":false,"actualSubdomain":"ngnmarket","customDomains":["docs.ngnmarket.com"],"gitSource":{"type":"github","owner":"ngnmarket","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad766e46e89f16d0373c5d1","collectionId":"ddacfbb8-2852-4047-942a-e207292c9d15","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad766e46e89f16d0373c5d1"},"entitlements":{},"buildId":"6ad766e46e89f16d0373c5d1","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":48},{"language":"default","tag":"Guides","count":20},{"language":"default","tag":"US Market","count":19},{"language":"default","tag":"Market Endpoints","count":18},{"language":"default","tag":"Company Endpoints","count":17},{"language":"default","tag":"WebSocket","count":11},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Index Endpoints","count":6},{"language":"default","tag":"Examples","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"#navbar a[href=\"/\"] p,#navbar a[href=\"/\"] span,[class*=Brand] span,[class*=Logo] p,[class*=Logo] span,[class*=Navbar] a:first-child span,[class*=brand] span,[class*=logo] p,[class*=logo] span,[class*=navbar] a:first-child span,[class*=site-name],[class*=siteName],header a[href=\"/\"] p,header a[href=\"/\"] span,nav a[href=\"/\"] p,nav a[href=\"/\"] span{font-size:.75rem!important;font-weight:600!important;letter-spacing:-.01em!important}table{width:100%!important;display:table!important}td,th{white-space:normal}.prompt-card{border:1px solid rgba(0,0,0,.08);border-radius:12px;background:#fafafa;padding:1rem;margin:1rem 0}.prompt-card-subtitle{font-size:.8rem;color:rgba(0,0,0,.55);margin:0 0 .75rem}.prompt-card-scroll{max-height:260px;overflow-y:auto;border-radius:8px}.prompt-card-scroll pre{margin:0!important}.prompt-card-actions{display:flex;justify-content:flex-end;padding-top:.6rem}.prompt-copy-btn{display:inline-flex;align-items:center;gap:.4rem;font-size:.8rem;font-weight:500;padding:.35rem .75rem;border-radius:8px;border:1px solid rgba(0,0,0,.12);background:#fff;color:#16a34a;cursor:pointer;transition:background .15s ease,border-color .15s ease,color .15s ease}.prompt-copy-btn:hover{background:#f0fdf4;border-color:#22c55e}.prompt-copy-btn.copied{background:#16a34a;border-color:#16a34a;color:#fff}@media (prefers-color-scheme:dark){.prompt-card{background:rgba(255,255,255,.03);border-color:rgba(255,255,255,.1)}.prompt-card-subtitle{color:rgba(255,255,255,.55)}.prompt-copy-btn{background:rgba(255,255,255,.04);border-color:rgba(255,255,255,.14);color:#4ade80}.prompt-copy-btn:hover{background:rgba(34,197,94,.12);border-color:#22c55e}}.dark .prompt-card{background:rgba(255,255,255,.03);border-color:rgba(255,255,255,.1)}.dark .prompt-card-subtitle{color:rgba(255,255,255,.55)}.dark .prompt-copy-btn{background:rgba(255,255,255,.04);border-color:rgba(255,255,255,.14);color:#4ade80}.dark .prompt-copy-btn:hover{background:rgba(34,197,94,.12);border-color:#22c55e}"}],"page":{"pagePath":"api-reference/insiders/clusters","slug":"/api-reference/insiders/clusters","pageMetadata":{"title":"Director-Dealings Clusters","description":"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.","sidebarTitle":"Trading Clusters","openapi":"GET /insiders/clusters","keywords":["NGX director dealings cluster detection API","insider transaction pattern API"],"href":"/api-reference/insiders/clusters"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns groups of distinct insiders who traded the same symbol in the same direction within a configurable lookback window. By default, a cluster requires at least three distinct insiders, and you can adjust both the lookback period and minimum number of insiders.`}),`\n`,_jsx(_components.p,{children:`The endpoint identifies patterns in the available filings. It does not determine whether the trades were coordinated or what motivated them.`}),`\n`,_jsx(_components.p,{children:`This endpoint requires a Business plan.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Check `,_jsx(_components.code,{children:`insider_type_breakdown`}),` before interpreting a cluster. It shows the types of insiders represented in the group, which can help distinguish activity spread across employees from activity concentrated among directors or senior officers. For example, a cluster dominated by `,_jsx(_components.code,{children:`employee`}),`/`,_jsx(_components.code,{children:`staff`}),` records may reflect broader employee participation. Both patterns can produce the same basic “N insiders traded” count, so the breakdown provides important context. A cluster should be treated as a pattern in the filings, not as evidence of coordinated intent or investment conviction.`]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Last 60 days, default threshold`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.ngnmarket.com/v1/insiders/clusters\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer ngm_live_YOUR_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Wider window, higher threshold`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.ngnmarket.com/v1/insiders/clusters?days=90\u0026min_insiders=5\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer ngm_live_YOUR_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`5`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` res`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.ngnmarket.com/v1/insiders/clusters?days=90\u0026min_insiders=5'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer ngm_live_YOUR_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`res `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.ngnmarket.com/v1/insiders/clusters'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'days'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`90`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'min_insiders'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer ngm_live_YOUR_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` res.json()[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'data'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Director-Dealings Clusters","description":"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.","sidebarTitle":"Trading Clusters","openapi":"GET /insiders/clusters","keywords":["NGX director dealings cluster detection API","insider transaction pattern API"],"href":"/api-reference/insiders/clusters"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getInsiderClusters","summary":"Director-dealings clusters","description":"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.","tags":["Insiders"],"parameters":["dbb08a93-cb96-4362-9e9b-426e06225119","e59c6a2f-a736-4ef5-8d71-57fc8fd1cdc9"],"responses":{"200":"e0e1fbb0-08ce-4002-a20e-388aba333fe9","401":"8044515b-bb42-4690-a656-0b5a92b744fa","403":"4ef87e5a-5c80-4f19-b5e6-41ef7f7e1317","429":"1c8c694d-3d7f-4225-ae83-380a34bdd342","500":"e7578976-354c-4d0e-abfc-d908651129e3"},"method":"get","type":"path","servers":["855b438d-88fc-45d1-a7e0-25a01a39d4e7"],"security":["73950ca2-6b21-4095-bcbd-e702cc7aaed9"],"path":"/insiders/clusters","baseUrlOptions":["https://api.ngnmarket.com/v1"],"title":"Director-dealings clusters","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dbb08a93-cb96-4362-9e9b-426e06225119":{"name":"days","in":"query","description":"Lookback window in days.","schema":{"type":"integer","minimum":7,"maximum":365,"default":60,"description":"Lookback window in days.","uniqueKey":"","typeLabel":"integer"}},"e59c6a2f-a736-4ef5-8d71-57fc8fd1cdc9":{"name":"min_insiders","in":"query","description":"Minimum distinct insiders required to qualify as a cluster.","schema":{"type":"integer","minimum":2,"maximum":20,"default":3,"description":"Minimum distinct insiders required to qualify as a cluster.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"e0e1fbb0-08ce-4002-a20e-388aba333fe9":{"description":"Clusters retrieved successfully.","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"meta":{"type":"object","description":"Quota and plan metadata included on every authenticated response.","properties":{"plan":{"type":"string","description":"Current plan name.","enum":["free","hobby","starter","pro","business","enterprise"],"example":"starter","uniqueKey":"meta.plan","typeLabel":"enum\u003cstring>"},"calls_used":{"type":"integer","description":"Total calls made in the current usage period across all your keys.","example":4821,"uniqueKey":"meta.calls_used","typeLabel":"integer"},"calls_remaining":{"type":"integer","description":"Calls remaining before your quota is exhausted.","example":95179,"uniqueKey":"meta.calls_remaining","typeLabel":"integer"},"reset_at":{"type":"string","format":"date-time","description":"ISO 8601 UTC timestamp of your next quota reset (your account's billing renewal date, not the calendar month start).","example":"2026-06-15T23:57:00.000Z","uniqueKey":"meta.reset_at","typeLabel":"string\u003cdate-time>"},"market":{"type":"string","enum":["US"],"description":"Present on US endpoint responses.","uniqueKey":"meta.market","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USD"],"description":"Quote currency. Present on US endpoint responses.","uniqueKey":"meta.currency","typeLabel":"enum\u003cstring>"},"as_of":{"oneOf":[{"type":"string","format":"date-time","description":"Oldest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.as_of.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Oldest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.as_of.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.as_of","typeLabel":"string\u003cdate-time> | null"},"newest":{"oneOf":[{"type":"string","format":"date-time","description":"Newest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.newest.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Newest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.newest.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.newest","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"meta","typeLabel":"object"},"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A group of distinct insiders trading the same symbol in the same direction within a lookback window. Identifies a pattern in the filings, not coordination or intent.","properties":{"company_symbol":{"type":"string","uniqueKey":"data.data.items.[INDEX].company_symbol","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"data.data.items.[INDEX].company_name","typeLabel":"string"},"side":{"type":"string","enum":["buy","sell"],"uniqueKey":"data.data.items.[INDEX].side","typeLabel":"enum\u003cstring>"},"insiders":{"type":"integer","description":"Count of distinct insiders in this cluster.","uniqueKey":"data.data.items.[INDEX].insiders","typeLabel":"integer"},"trades":{"type":"integer","uniqueKey":"data.data.items.[INDEX].trades","typeLabel":"integer"},"value":{"type":"number","uniqueKey":"data.data.items.[INDEX].value","typeLabel":"number"},"insider_type_breakdown":{"type":"object","description":"Count of filings per insider_type within this cluster. Shows the types of insiders represented in the group, which can help distinguish activity spread across employees from activity concentrated among directors or senior officers. Does not indicate whether the trades were coordinated.","additionalProperties":{"type":"integer","uniqueKey":"data.data.items.[INDEX].insider_type_breakdown.additionalProperties","typeLabel":"integer"},"example":{"senior_officer":4,"executive_director":1},"uniqueKey":"data.data.items.[INDEX].insider_type_breakdown","typeLabel":"object"},"first_date":{"type":"string","format":"date","uniqueKey":"data.data.items.[INDEX].first_date","typeLabel":"string\u003cdate>"},"last_date":{"type":"string","format":"date","uniqueKey":"data.data.items.[INDEX].last_date","typeLabel":"string\u003cdate>"}},"uniqueKey":"data.data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.data","typeLabel":"object[]"},"days":{"type":"integer","example":60,"uniqueKey":"data.days","typeLabel":"integer"},"min_insiders":{"type":"integer","example":3,"uniqueKey":"data.min_insiders","typeLabel":"integer"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"clusters":{"title":"clusters","value":{"success":true,"data":{"data":[{"company_symbol":"TRANSCORP","company_name":"TRANSNATIONAL CORPORATION PLC","side":"buy","insiders":5,"trades":5,"value":93580528.5,"insider_type_breakdown":{"senior_officer":4,"executive_director":1},"first_date":"2026-07-25","last_date":"2026-07-25"}],"days":60,"min_insiders":3},"meta":{"plan":"business","calls_used":4023,"calls_remaining":1995977,"reset_at":"2026-10-01T00:00:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"8044515b-bb42-4690-a656-0b5a92b744fa":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error identifier.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description.","example":"Resource not found.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"required_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Minimum plan needed.","uniqueKey":"error.required_plan","typeLabel":"string"},"current_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Your current plan.","uniqueKey":"error.current_plan","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingKey":{"title":"missingKey","value":{"success":false,"error":{"code":"MISSING_API_KEY","message":"Provide your API key via: Authorization: Bearer \u003ckey>"}}},"invalidKey":{"title":"invalidKey","value":{"success":false,"error":{"code":"INVALID_API_KEY","message":"API key not found or revoked."}}}},"exampleType":"examples"}},"exampleType":"examples"},"4ef87e5a-5c80-4f19-b5e6-41ef7f7e1317":{"description":"Endpoint requires a higher plan.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error identifier.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description.","example":"Resource not found.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"required_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Minimum plan needed.","uniqueKey":"error.required_plan","typeLabel":"string"},"current_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Your current plan.","uniqueKey":"error.current_plan","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"PLAN_REQUIRED","message":"This endpoint requires a starter plan or higher.","required_plan":"starter","current_plan":"free"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"PLAN_REQUIRED","message":"This endpoint requires a starter plan or higher.","required_plan":"starter","current_plan":"free"}}}},"exampleType":"examples"}},"exampleType":"examples"},"1c8c694d-3d7f-4225-ae83-380a34bdd342":{"description":"Monthly call limit reached.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error identifier.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description.","example":"Resource not found.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"required_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Minimum plan needed.","uniqueKey":"error.required_plan","typeLabel":"string"},"current_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Your current plan.","uniqueKey":"error.current_plan","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Quota and plan metadata included on every authenticated response.","properties":{"plan":{"type":"string","description":"Current plan name.","enum":["free","hobby","starter","pro","business","enterprise"],"example":"starter","uniqueKey":"meta.plan","typeLabel":"enum\u003cstring>"},"calls_used":{"type":"integer","description":"Total calls made in the current usage period across all your keys.","example":4821,"uniqueKey":"meta.calls_used","typeLabel":"integer"},"calls_remaining":{"type":"integer","description":"Calls remaining before your quota is exhausted.","example":95179,"uniqueKey":"meta.calls_remaining","typeLabel":"integer"},"reset_at":{"type":"string","format":"date-time","description":"ISO 8601 UTC timestamp of your next quota reset (your account's billing renewal date, not the calendar month start).","example":"2026-06-15T23:57:00.000Z","uniqueKey":"meta.reset_at","typeLabel":"string\u003cdate-time>"},"market":{"type":"string","enum":["US"],"description":"Present on US endpoint responses.","uniqueKey":"meta.market","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USD"],"description":"Quote currency. Present on US endpoint responses.","uniqueKey":"meta.currency","typeLabel":"enum\u003cstring>"},"as_of":{"oneOf":[{"type":"string","format":"date-time","description":"Oldest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.as_of.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Oldest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.as_of.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.as_of","typeLabel":"string\u003cdate-time> | null"},"newest":{"oneOf":[{"type":"string","format":"date-time","description":"Newest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.newest.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Newest quote timestamp represented in a US response, or `null` when it contains no quote timestamps.","uniqueKey":"meta.newest.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.newest","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"QUOTA_EXCEEDED","message":"Monthly call limit of 100,000 reached. Resets on 2026-05-01T00:00:00.000Z."},"meta":{"plan":"starter","calls_used":100000,"calls_remaining":0,"reset_at":"2026-05-15T23:57:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"QUOTA_EXCEEDED","message":"Monthly call limit of 100,000 reached. Resets on 2026-05-01T00:00:00.000Z."},"meta":{"plan":"starter","calls_used":100000,"calls_remaining":0,"reset_at":"2026-05-15T23:57:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"e7578976-354c-4d0e-abfc-d908651129e3":{"description":"Unexpected server-side failure. Safe to retry with backoff.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error identifier.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description.","example":"Resource not found.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"required_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Minimum plan needed.","uniqueKey":"error.required_plan","typeLabel":"string"},"current_plan":{"type":"string","description":"_(PLAN_REQUIRED only)_ Your current plan.","uniqueKey":"error.current_plan","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"SERVER_ERROR","message":"Something went wrong on our end. Please try again."}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"SERVER_ERROR","message":"Something went wrong on our end. Please try again."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"73950ca2-6b21-4095-bcbd-e702cc7aaed9":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"ngm_live_*","description":"Pass your API key as a Bearer token: `Authorization: Bearer ngm_live_YOUR_KEY`.\nGenerate keys at [ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer).\n","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"855b438d-88fc-45d1-a7e0-25a01a39d4e7":{"url":"https://api.ngnmarket.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"ngm_live_*","description":"Pass your API key as a Bearer token: `Authorization: Bearer ngm_live_YOUR_KEY`.\nGenerate keys at [ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer).\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Pass your API key as a Bearer token: `Authorization: Bearer ngm_live_YOUR_KEY`.\nGenerate keys at [ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer).\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"ngnmarket","siteName":"NGN Market API","title":"Director-Dealings Clusters - NGN Market API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T22:57:37.072Z","originalFileLocation":"api-reference/insiders/clusters.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\">\u003cmeta data-mint-head name=\"application-name\" content=\"NGN Market API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Director-Dealings Clusters - NGN Market API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"NGN Market API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ngnmarket.com/api-reference/insiders/clusters\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ngnmarket.mintlify.app/_mintlify/api/og/v2?division=Insider+Endpoints\u0026amp;title=Director-Dealings+Clusters\u0026amp;description=Groups+of+multiple+distinct+insiders+trading+the+same+symbol+in+the+same+direction+within+a+given+period.\u0026amp;theme=49cf227b27187d4286c9c6ef\u0026amp;signature=2c828f6d82a0e18193135d475e034a696bf24c7bdd37d420c8c587d85ab8616b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Director-Dealings Clusters - NGN Market API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ngnmarket.mintlify.app/_mintlify/api/og/v2?division=Insider+Endpoints\u0026amp;title=Director-Dealings+Clusters\u0026amp;description=Groups+of+multiple+distinct+insiders+trading+the+same+symbol+in+the+same+direction+within+a+given+period.\u0026amp;theme=49cf227b27187d4286c9c6ef\u0026amp;signature=2c828f6d82a0e18193135d475e034a696bf24c7bdd37d420c8c587d85ab8616b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ngnmarket/ILiVsXrEyOhqXsfO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"NGN Market API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1a6b3c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ngnmarket.com/api-reference/insiders/clusters\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/insiders/clusters.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ngnmarket.com/#organization\",\"name\":\"NGN Market API\",\"url\":\"https://docs.ngnmarket.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ngnmarket.com#website\",\"name\":\"NGN Market API\",\"url\":\"https://docs.ngnmarket.com\",\"publisher\":{\"@id\":\"https://docs.ngnmarket.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters#webpage\",\"url\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters\",\"name\":\"Director-Dealings Clusters\",\"description\":\"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\",\"dateModified\":\"2026-09-11T22:57:37.072Z\",\"isPartOf\":{\"@id\":\"https://docs.ngnmarket.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Insider Endpoints\",\"item\":\"https://docs.ngnmarket.com/api-reference/insiders/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Director-Dealings Clusters\",\"item\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters#apireference\",\"headline\":\"Director-Dealings Clusters\",\"name\":\"Director-Dealings Clusters\",\"description\":\"Groups of multiple distinct insiders trading the same symbol in the same direction within a given period.\",\"url\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ngnmarket.com/api-reference/insiders/clusters#webpage\"},\"dateModified\":\"2026-09-11T22:57:37.072Z\",\"keywords\":\"NGX director dealings cluster detection API, insider transaction pattern API\",\"publisher\":{\"@id\":\"https://docs.ngnmarket.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ngnmarket.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"NGN Market API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"NGN Market API","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://ngnmarket.com/dashboard"},{"anchor":"Blog","icon":"newspaper","href":"https://ngnmarket.com/blog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Using the API","pages":[{"title":"API Reference","sidebarTitle":"Overview","href":"/api-reference/introduction"}]},{"group":"Market Endpoints","pages":[{"title":"Market Status","sidebarTitle":"Market Status","openapi":"GET /market/status","href":"/api-reference/market/status"},{"title":"Market Holidays","sidebarTitle":"Market Holidays","openapi":"GET /market/holidays","href":"/api-reference/market/holidays"},{"title":"Market Snapshot","sidebarTitle":"Market Snapshot","openapi":"GET /market/snapshot","href":"/api-reference/market/snapshot"},{"title":"Top Trades","sidebarTitle":"Top Trades","openapi":"GET /market/top-trades","href":"/api-reference/market/top-trades"},{"title":"Market Movers","sidebarTitle":"Gainers \u0026 Losers","openapi":"GET /market/movers","href":"/api-reference/market/movers"},{"title":"Market Breadth","sidebarTitle":"Market Breadth","openapi":"GET /market/breadth","href":"/api-reference/market/breadth"},{"title":"Sectors","sidebarTitle":"Sectors","openapi":"GET /market/sectors","href":"/api-reference/market/sectors"},{"title":"YTD Performers","sidebarTitle":"YTD Performers","openapi":"GET /market/ytd-performers","href":"/api-reference/market/ytd-performers"},{"title":"Available Dates","sidebarTitle":"Available Dates","openapi":"GET /market/available-dates","href":"/api-reference/market/available-dates"}]},{"group":"Company Endpoints","pages":[{"title":"List Companies","sidebarTitle":"List Companies","openapi":"GET /companies","href":"/api-reference/companies/list"},{"title":"Company Profile","sidebarTitle":"Company Profile","openapi":"GET /companies/{symbol}","href":"/api-reference/companies/detail"},{"title":"Price Chart","sidebarTitle":"Price Chart","openapi":"GET /companies/{symbol}/chart","href":"/api-reference/companies/chart"},{"title":"Dividend History","sidebarTitle":"Dividend History","openapi":"GET /companies/{symbol}/dividends","href":"/api-reference/companies/dividends"},{"title":"Financial Statements","sidebarTitle":"Financial Statements","openapi":"GET /companies/{symbol}/financials","href":"/api-reference/companies/financials"},{"title":"Income Statement","sidebarTitle":"Income Statement","openapi":"GET /companies/{symbol}/financials/income","href":"/api-reference/companies/financials-income"},{"title":"Balance Sheet","sidebarTitle":"Balance Sheet","openapi":"GET /companies/{symbol}/financials/balance-sheet","href":"/api-reference/companies/financials-balance-sheet"},{"title":"Cash Flow Statement","sidebarTitle":"Cash Flow Statement","openapi":"GET /companies/{symbol}/financials/cash-flow","href":"/api-reference/companies/financials-cash-flow"},{"title":"Financial Ratios","sidebarTitle":"Financial Ratios","openapi":"GET /companies/{symbol}/financials/ratios","href":"/api-reference/companies/financials-ratios"},{"title":"Trailing Twelve Month Financials","sidebarTitle":"TTM Financials","openapi":"GET /companies/{symbol}/financials/ttm","href":"/api-reference/companies/financials-ttm"},{"title":"Financial Statement Growth","sidebarTitle":"Financial Growth","openapi":"GET /companies/{symbol}/financials/growth","href":"/api-reference/companies/financials-growth"},{"title":"Company News","sidebarTitle":"Company News","openapi":"GET /companies/{symbol}/news","href":"/api-reference/companies/news"},{"title":"Company Disclosures","sidebarTitle":"Company Disclosures","openapi":"GET /companies/{symbol}/disclosures","href":"/api-reference/companies/disclosures"},{"title":"Company Disclosure Categories","sidebarTitle":"Disclosure Categories","openapi":"GET /companies/{symbol}/disclosures/categories","href":"/api-reference/companies/disclosures-categories"},{"title":"Director Dealings","sidebarTitle":"Director Dealings","openapi":"GET /companies/{symbol}/director-dealings","href":"/api-reference/companies/director-dealings"},{"title":"Director Dealings Summary","sidebarTitle":"Director Dealings Summary","openapi":"GET /companies/{symbol}/director-dealings/summary","href":"/api-reference/companies/director-dealings-summary"},{"title":"Ticker Symbols","sidebarTitle":"Ticker Symbols","openapi":"GET /companies/identifiers","href":"/api-reference/companies/identifiers"}]},{"group":"Dividend Endpoints","pages":[{"title":"Upcoming Dividends","sidebarTitle":"Upcoming Dividends","openapi":"GET /dividends/upcoming","href":"/api-reference/dividends/upcoming"},{"title":"Recent Dividends","sidebarTitle":"Recent Dividends","openapi":"GET /dividends/recent","href":"/api-reference/dividends/recent"}]},{"group":"Forex Endpoints","pages":[{"title":"Current Forex Rates","sidebarTitle":"Current Rates","openapi":"GET /forex/current","href":"/api-reference/forex/current"},{"title":"Historical Forex Rates","sidebarTitle":"Historical Rates","openapi":"GET /forex/history","href":"/api-reference/forex/history"}]},{"group":"Index Endpoints","pages":[{"title":"List Indices","sidebarTitle":"All Indices","openapi":"GET /indices","href":"/api-reference/indices/list"},{"title":"Index Detail","sidebarTitle":"Index Detail","openapi":"GET /indices/{symbol}","href":"/api-reference/indices/detail"},{"title":"Index Chart","sidebarTitle":"Index Chart","openapi":"GET /indices/{symbol}/chart","href":"/api-reference/indices/chart"}]},{"group":"ETF Endpoints","pages":[{"title":"List ETFs","sidebarTitle":"All ETFs","openapi":"GET /etfs","href":"/api-reference/etfs/list"},{"title":"ETF Detail","sidebarTitle":"ETF Detail","openapi":"GET /etfs/{symbol}","href":"/api-reference/etfs/detail"},{"title":"ETF Chart","sidebarTitle":"ETF Chart","openapi":"GET /etfs/{symbol}/chart","href":"/api-reference/etfs/chart"}]},{"group":"Bond Endpoints","pages":[{"title":"List Bonds","sidebarTitle":"List Bonds","openapi":"GET /bonds","href":"/api-reference/bonds/list"}]},{"group":"Disclosure Endpoints","pages":[{"title":"List Disclosures","sidebarTitle":"List Disclosures","openapi":"GET /disclosures","href":"/api-reference/disclosures/list"},{"title":"Disclosure Types","sidebarTitle":"Disclosure Types","openapi":"GET /disclosures/types","href":"/api-reference/disclosures/types"},{"title":"Disclosure Categories","sidebarTitle":"Disclosure Categories","openapi":"GET /disclosures/categories","href":"/api-reference/disclosures/categories"}]},{"group":"Insider Endpoints","pages":[{"title":"Market-Wide Director Dealings","description":"Structured director-dealings feed across covered NGX-listed companies.","sidebarTitle":"List Dealings","openapi":"GET /insiders","href":"/api-reference/insiders/list"},{"title":"Director-Dealings Clusters","sidebarTitle":"Trading Clusters","openapi":"GET /insiders/clusters","href":"/api-reference/insiders/clusters"}]},{"group":"Blog Endpoints","pages":[{"title":"List Blog Posts","description":"Paginated, filterable feed of all published NGN Market blog posts.","sidebarTitle":"List Posts","openapi":"GET /blog/posts","href":"/api-reference/blog/posts"},{"title":"Get Blog Post","sidebarTitle":"Post Detail","openapi":"GET /blog/posts/{slug}","href":"/api-reference/blog/post-detail"},{"title":"Search Blog Posts","sidebarTitle":"Search Posts","openapi":"GET /blog/search","href":"/api-reference/blog/search"}]},{"group":"Account Endpoints","pages":[{"title":"Account Usage","sidebarTitle":"Usage \u0026 Analytics","openapi":"GET /account/usage","href":"/api-reference/account/usage"},{"title":"Account Logs","sidebarTitle":"Request Logs","openapi":"GET /account/logs","href":"/api-reference/account/logs"}]}]},{"tab":"US Market","pages":[{"title":"US Market","href":"/us/introduction"}]},{"tab":"WebSocket","pages":[{"title":"WebSocket","href":"/websocket/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/live-price-ticker"}]}]},"title":"Director-Dealings Clusters - NGN Market API","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}