Metadata-Version: 2.4
Name: nepse-sdk
Version: 0.1.0
Summary: Unofficial Python SDK and CLI for the Nepal Stock Exchange (NEPSE)
Keywords: nepse,nepal,stock,exchange,finance,sdk,cli
Author: Ankur Gajurel
Author-email: Ankur Gajurel <ankurgajurel02@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Typing :: Typed
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: wasmtime>=42.0.0
Requires-Python: >=3.13
Project-URL: Issues, https://github.com/ankurgajurel/nepse-sdk/issues
Project-URL: Repository, https://github.com/ankurgajurel/nepse-sdk
Description-Content-Type: text/markdown

# nepse-sdk

Unofficial Python SDK and CLI for the Nepal Stock Exchange (NEPSE).

## Installation

```
pip install nepse-sdk
```

## SDK Usage

```python
from nepse import NepseClient

with NepseClient() as client:
    for item in client.market_summary():
        print(item.detail, f"{item.value:,.2f}")

    detail = client.security_detail("ADBL")
    print(detail.info.symbol, detail.trade.last_traded_price)

    for record in client.dividends("ADBL"):
        print(record.fiscal_year_nepali, f"Cash: {record.cash_dividend}%")
```

All methods return fully typed dataclasses — no raw dicts.

## CLI Commands

```
nepse market-summary           # market turnover, traded shares, transactions, capitalization
nepse top-gainers              # top gaining stocks (use -a for all)
nepse top-losers               # top losing stocks (use -a for all)
nepse securities               # list all non-delisted securities
nepse security ADBL            # detail view for a security by symbol
nepse dividends ADBL           # dividend history for a security
```

## Disclaimer

This is an unofficial tool and is not affiliated with or endorsed by NEPSE (Nepal Stock Exchange) or Nepal Stock Exchange Ltd. Use at your own risk.

## License

MIT
