Metadata-Version: 2.4
Name: moexapi
Version: 1.7.26
Summary: Python API for MOEX ISS
Author-email: Aliaksei Rak <kventinel@gmail.com>
License: MIT License
        
        Copyright (c) 2023 Rak Alexey
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/kventinel/moexapi
Keywords: moex
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: beautifulsoup4
Requires-Dist: requests
Requires-Dist: numpy
Dynamic: license-file

# MOEXAPI

Библиотека для парсинга данных MOEX

## Install

Установить можно одним из способов:
- `pip install moexapi`
- `git clone https://github.com/kventinel/moexapi.git`

## Examples

### Ticker

```
In [2]: moexapi.get_ticker('GAZP')
Out[2]: Ticker(secid='GAZP', alias='GAZP', is_traded=True, market=shares, shortname='ГАЗПРОМ ао', isin='RU0007661625', subtype=None, listlevel=1, boards=['TQBR', 'SMAL', 'SPEQ'], raw_price=166.15, price=166.15, accumulated_coupon=0, value=1198036323)
```

### Candles

```
In [4]: moexapi.get_candles(moexapi.get_ticker('GAZP'), start_date=datetime.date(2023, 10, 2), end_date=datetime.date(2023, 10, 2))
Out[4]: [Candle(date=datetime.date(2023, 10, 2), low=165.51, high=168.86, open=167.83, close=166.08, mid_price=167.16, numtrades=117852, volume=24391830, value=4077382279.5)]
```

### Bonds

`get_history()` returns `History.accrued_interest` from the historical ISS `ACCINT` column.
It is accrued coupon cash per security in `History.currency` (settlement
currency), not a percentage or a ruble conversion. Missing values remain `None`;
zero is a valid observation. Same-day board merges retain one matching value
and reject conflicting known values; if any merged observation is missing the
result is `None`. Split adjustments scale accrued cash with per-security prices.

```
In [5]: moexapi.Bond(moexapi.get_ticker('SU26238RMFS4'))
Out[5]: Bond(secid='SU26238RMFS4', shortname='ОФЗ 26238', amortization=[Amortization(date=datetime.date(2041, 5, 15), value=1000, initialfacevalue=1000)], coupons=[Coupon(date=2021-12-08, value=34.04), Coupon(date=2022-06-08, value=35.4), Coupon(date=2022-12-07, value=35.4), Coupon(date=2023-06-07, value=35.4), Coupon(date=2023-12-06, value=35.4), Coupon(date=2024-06-05, value=35.4), Coupon(date=2024-12-04, value=35.4), Coupon(date=2025-06-04, value=35.4), Coupon(date=2025-12-03, value=35.4), Coupon(date=2026-06-03, value=35.4), Coupon(date=2026-12-02, value=35.4), Coupon(date=2027-06-02, value=35.4), Coupon(date=2027-12-01, value=35.4), Coupon(date=2028-05-31, value=35.4), Coupon(date=2028-11-29, value=35.4), Coupon(date=2029-05-30, value=35.4), Coupon(date=2029-11-28, value=35.4), Coupon(date=2030-05-29, value=35.4), Coupon(date=2030-11-27, value=35.4), Coupon(date=2031-05-28, value=35.4), Coupon(date=2031-11-26, value=35.4), Coupon(date=2032-05-26, value=35.4), Coupon(date=2032-11-24, value=35.4), Coupon(date=2033-05-25, value=35.4), Coupon(date=2033-11-23, value=35.4), Coupon(date=2034-05-24, value=35.4), Coupon(date=2034-11-22, value=35.4), Coupon(date=2035-05-23, value=35.4), Coupon(date=2035-11-21, value=35.4), Coupon(date=2036-05-21, value=35.4), Coupon(date=2036-11-19, value=35.4), Coupon(date=2037-05-20, value=35.4), Coupon(date=2037-11-18, value=35.4), Coupon(date=2038-05-19, value=35.4), Coupon(date=2038-11-17, value=35.4), Coupon(date=2039-05-18, value=35.4), Coupon(date=2039-11-16, value=35.4), Coupon(date=2040-05-16, value=35.4), Coupon(date=2040-11-14, value=35.4), Coupon(date=2041-05-15, value=35.4)], offers=[])
```

### Missing historical volume

For equity and currency history, absent/null `VOLUME` is estimated as
`value / mid_price` from the same historical board/day. Explicit values,
including zero, are preserved. Currency turnover uses `VOLRUR` in RUB.
The estimate requires finite nonnegative turnover and a finite positive price;
if turnover is also unavailable, volume remains `None`. Bond volume is not
estimated this way because bond prices are percentage-of-face-value quotes.
Recovery precedes board merging and split adjustments.

### Unreported historical splits

For equity `get_history()`, prices are also checked against same-date daily
ISS candles (`interval=24`). ISS may adjust candle OHLC for a split missing
from its split directory, while historical OHLC and candle volumes retain
their original scale. When all four OHLC ratios agree on a whole-number split
or consolidation, history prices (including `mid_price`) and volumes are
adjusted accordingly; turnover and trade counts are preserved. Reported
split factors are accounted for to avoid double adjustment. This also works
for a requested range entirely before the action and for former tickers.
This check loads daily candles for the requested equity history in addition
to the history endpoint. Missing candles or inconsistent ratios provide no
additional adjustment; a price jump alone never triggers a correction.
