SkillAgentSearch skills...

nse-corporate-actions

NSE corp actions: dividends, bonus, splits, rights, buybacks

Install / Use

npx skills add taracodlabs/aiden --skill nse-corporate-actions

Installs into whichever agent you are using.

About this skill
šŸ“„

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Universal

Our assessment of nse-corporate-actions

nse-corporate-actions scores 85/100 on our quality scale, 2733rd of 4,702 Development & Engineering skills we index.

Its SKILL.md is 4.6 KB long, well organised into 10 sections with 5 code examples: a solid amount of guidance for an agent.

It has 843 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
20/20
Description
12/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so nse-corporate-actions is actively maintained.
  • Our last check on 2026-11-05 found the source still online.
  • It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

nse-corporate-actions compared with similar skills

All 4 of these similar skills score higher than nse-corporate-actions; compare them before choosing.

SkillScoreStarsUpdatedFormat
nse-corporate-actions (this skill)by taracodlabs858432mo agoSKILL.md
taste-skillby Leonxlnx100117.6k9d agoCLAUDE.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.3ktodayCLAUDE.md

Frequently asked questions

How do I install nse-corporate-actions?
Run npx skills add taracodlabs/aiden --skill nse-corporate-actions. The install tabs above show the steps for each supported agent.
Which AI agents does nse-corporate-actions work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is nse-corporate-actions safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is nse-corporate-actions still maintained?
The repository was last updated about 2 months ago, so nse-corporate-actions is actively maintained.

name: nse-corporate-actions description: "NSE corp actions: dividends, bonus, splits, rights, buybacks" category: india version: 1.0.0 tags: nse, corporate-actions, dividend, bonus, split, rights, buyback, india, equity license: Apache-2.0

NSE Corporate Actions

Fetch upcoming and recent corporate actions for NSE-listed stocks — dividends, bonus issues, stock splits, rights issues, and buybacks — using NSE's public API.

When to Use

  • User asks "when is the next dividend for Infosys?"
  • User wants to know about upcoming bonus issues or stock splits
  • User asks about ex-dates, record dates, or payment dates for dividends
  • User wants to check if a stock has an upcoming buyback offer
  • User asks for a company's full corporate action history

How to Use

Get corporate actions for a specific stock

$symbol = "INFY"
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers | Out-Null
$resp = Invoke-RestMethod `
  -Uri "https://www.nseindia.com/api/corporates-corporateActions?index=equities&symbol=$symbol" `
  -Headers $headers -WebSession $nse
$resp | Select-Object subject, exDate, recordDate, bcStartDate, bcEndDate, series |
  Sort-Object exDate -Descending | Select-Object -First 10

Get upcoming dividends across the market

$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers | Out-Null
$today = (Get-Date).ToString("dd-MM-yyyy")
$resp = Invoke-RestMethod `
  -Uri "https://www.nseindia.com/api/corporates-corporateActions?index=equities&from_date=$today&category=dividend" `
  -Headers $headers -WebSession $nse
$resp | Select-Object symbol, subject, exDate, series |
  Sort-Object exDate | Select-Object -First 20

Get upcoming bonus issues

$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers | Out-Null
$resp = Invoke-RestMethod `
  -Uri "https://www.nseindia.com/api/corporates-corporateActions?index=equities&category=bonus" `
  -Headers $headers -WebSession $nse
$resp | Select-Object symbol, subject, exDate, bcStartDate | Sort-Object exDate

Get upcoming stock splits

$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers | Out-Null
$resp = Invoke-RestMethod `
  -Uri "https://www.nseindia.com/api/corporates-corporateActions?index=equities&category=splits" `
  -Headers $headers -WebSession $nse
$resp | Select-Object symbol, subject, exDate | Sort-Object exDate

Check if a stock's ex-date has passed (for dividend eligibility)

$symbol = "TCS"
$headers = @{ "User-Agent" = "Mozilla/5.0"; "Referer" = "https://www.nseindia.com" }
Invoke-WebRequest -Uri "https://www.nseindia.com" -SessionVariable nse -Headers $headers | Out-Null
$resp = Invoke-RestMethod `
  -Uri "https://www.nseindia.com/api/corporates-corporateActions?index=equities&symbol=$symbol" `
  -Headers $headers -WebSession $nse
$latest = $resp | Where-Object { $_.subject -match "dividend" } |
  Sort-Object exDate -Descending | Select-Object -First 1
if ($latest) {
  $exDate = [DateTime]::ParseExact($latest.exDate, "dd-MMM-yyyy", $null)
  $status = if ($exDate -gt (Get-Date)) { "UPCOMING (buy before $($latest.exDate))" } else { "PAST (ex-date was $($latest.exDate))" }
  Write-Host "$symbol dividend: $($latest.subject) | Ex-date: $status"
}

Examples

"When is TCS next dividend and what is the ex-date?" → Fetch corporate actions for TCS filtered by dividend, sort by exDate, display the most recent upcoming entry.

"Are there any bonus issues this month?" → Fetch bonus category from corporate actions API, filter by exDate within current month.

"Has Wipro announced a stock split?" → Fetch splits category for WIPRO and check if any entries exist.

Cautions

  • You must hold the stock before the ex-date to be eligible for dividends — buying on ex-date does not qualify
  • Corporate action data from NSE is updated periodically — always cross-check with the company's official BSE/NSE filings for critical decisions
  • Bonus shares and splits do not add value — they only change the face value and share count proportionally
  • NSE session cookie required — always initialize session before API calls
  • Rights issue applications require demat account access and ASBA — Aiden can fetch info but cannot apply on the user's behalf

Related Skills

View on GitHub
GitHub Stars843
CategoryDevelopment
Updated2mo ago
Forks147

Languages

TypeScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
nse-corporate-actions — Universal Skill: Install & Safety Check | SkillAgent