position-sizing-data 0.1.0__tar.gz

position_sizing_data-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PositionSizeTool
+
+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.

position_sizing_data-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: position-sizing-data
+Version: 0.1.0
+Summary: Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures
+Author: JUN YI
+License-Expression: MIT
+Project-URL: Homepage, https://positionsizetool.com/
+Project-URL: Repository, https://github.com/tk25719/position-sizing-data
+Project-URL: Zenodo, https://doi.org/10.5281/zenodo.22840538
+Keywords: position sizing,risk management,forex,trading,crypto
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# position-sizing-data
+
+Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures.
+
+The same tables are published as a citable dataset: [doi:10.5281/zenodo.22840538](https://doi.org/10.5281/zenodo.22840538), and used by the web calculator at [https://positionsizetool.com/](https://positionsizetool.com/). Source repository: [https://github.com/tk25719/position-sizing-data](https://github.com/tk25719/position-sizing-data).
+
+## Install
+
+```console
+pip install position-sizing-data
+```
+
+## What is in it
+
+| Function | Returns |
+| --- | --- |
+| `contract_specifications()` | Pip size, contract size and minimum unit step for 131 instruments, across forex pairs, metals, energies, indices, crypto futures, stocks and ETFs. |
+| `pip_values()` | Pip value and the loss on a 20 pip move for standard, mini, micro and nano lots. |
+| `losing_streak_equity()` | Equity remaining after 1 to 20 consecutive losses at 0.5%, 1% and 2% risk per trade. |
+| `drawdown_recovery()` | Gain required on the reduced balance to return to the original balance, for drawdowns from 5% to 90%. |
+| `position_size(...)` | The risk-to-units calculation itself. |
+
+Read the tables:
+
+```python
+from position_sizing_data import contract_specifications
+
+rows = contract_specifications()
+print(rows[0])
+```
+
+Compute a size:
+
+```python
+from position_sizing_data import position_size
+
+result = position_size(
+    balance=10000.0,
+    risk_percent=1.0,
+    entry=1.1000,
+    stop=1.0980,
+    unit_step=1000.0,   # 0.01 lot
+)
+print(result)
+# {'risk_budget': 100.0, 'units': 50000.0, 'tradable_units': 50000.0, 'worst_case_loss': 100.0}
+```
+
+## The formula
+
+```
+units = (risk_budget - commission) / ((|entry - stop| + spread) x quote_rate)
+```
+
+The tradable size is that number rounded **down** to `unit_step`. `position_size` returns the worst-case loss recomputed from the rounded size, which is what the account actually loses when the stop is hit.
+
+## Where the numbers come from
+
+The rows in `contract_specifications()` are typical retail contract specifications, not exchange-published official values. Verify the contract size and unit step against your own broker before placing an order. The other three tables are closed-form arithmetic:
+
+- losing streak: `remaining = (1 - risk)^n`
+- drawdown recovery: `gain_required = 1 / (1 - drawdown) - 1`
+- pip value: `pip_value = units x pip_size`
+
+## Licence
+
+MIT for the code. Data files are CC0 1.0 Universal, to the extent applicable. This is not investment advice.

position_sizing_data-0.1.0/README.md

@@ -0,0 +1,66 @@
+# position-sizing-data
+
+Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures.
+
+The same tables are published as a citable dataset: [doi:10.5281/zenodo.22840538](https://doi.org/10.5281/zenodo.22840538), and used by the web calculator at [https://positionsizetool.com/](https://positionsizetool.com/). Source repository: [https://github.com/tk25719/position-sizing-data](https://github.com/tk25719/position-sizing-data).
+
+## Install
+
+```console
+pip install position-sizing-data
+```
+
+## What is in it
+
+| Function | Returns |
+| --- | --- |
+| `contract_specifications()` | Pip size, contract size and minimum unit step for 131 instruments, across forex pairs, metals, energies, indices, crypto futures, stocks and ETFs. |
+| `pip_values()` | Pip value and the loss on a 20 pip move for standard, mini, micro and nano lots. |
+| `losing_streak_equity()` | Equity remaining after 1 to 20 consecutive losses at 0.5%, 1% and 2% risk per trade. |
+| `drawdown_recovery()` | Gain required on the reduced balance to return to the original balance, for drawdowns from 5% to 90%. |
+| `position_size(...)` | The risk-to-units calculation itself. |
+
+Read the tables:
+
+```python
+from position_sizing_data import contract_specifications
+
+rows = contract_specifications()
+print(rows[0])
+```
+
+Compute a size:
+
+```python
+from position_sizing_data import position_size
+
+result = position_size(
+    balance=10000.0,
+    risk_percent=1.0,
+    entry=1.1000,
+    stop=1.0980,
+    unit_step=1000.0,   # 0.01 lot
+)
+print(result)
+# {'risk_budget': 100.0, 'units': 50000.0, 'tradable_units': 50000.0, 'worst_case_loss': 100.0}
+```
+
+## The formula
+
+```
+units = (risk_budget - commission) / ((|entry - stop| + spread) x quote_rate)
+```
+
+The tradable size is that number rounded **down** to `unit_step`. `position_size` returns the worst-case loss recomputed from the rounded size, which is what the account actually loses when the stop is hit.
+
+## Where the numbers come from
+
+The rows in `contract_specifications()` are typical retail contract specifications, not exchange-published official values. Verify the contract size and unit step against your own broker before placing an order. The other three tables are closed-form arithmetic:
+
+- losing streak: `remaining = (1 - risk)^n`
+- drawdown recovery: `gain_required = 1 / (1 - drawdown) - 1`
+- pip value: `pip_value = units x pip_size`
+
+## Licence
+
+MIT for the code. Data files are CC0 1.0 Universal, to the extent applicable. This is not investment advice.

position_sizing_data-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "position-sizing-data"
+version = "0.1.0"
+description = "Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "JUN YI" }]
+keywords = ["position sizing", "risk management", "forex", "trading", "crypto"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://positionsizetool.com/"
+Repository = "https://github.com/tk25719/position-sizing-data"
+Zenodo = "https://doi.org/10.5281/zenodo.22840538"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+position_sizing_data = ["data/*.csv"]

position_sizing_data-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

position_sizing_data-0.1.0/src/position_sizing_data/__init__.py

@@ -0,0 +1,109 @@
+"""Reference data and arithmetic for risk-based position sizing.
+
+This package ships the same CSV tables and the same risk-to-units formula that
+are published as the Zenodo dataset 10.5281/zenodo.22840538 and used by the web
+calculator at https://positionsizetool.com/.
+
+The tables are plain data. The one function that computes something,
+``position_size``, implements the formula::
+
+    units = (risk_budget - commission) / ((|entry - stop| + spread) x rate)
+
+and rounds the result DOWN to the instrument's minimum unit step, because
+rounding up raises risk without showing it anywhere.
+"""
+
+from __future__ import annotations
+
+import csv
+import math
+from importlib import resources
+from typing import Dict, List
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "load_csv",
+    "contract_specifications",
+    "pip_values",
+    "losing_streak_equity",
+    "drawdown_recovery",
+    "position_size",
+]
+
+CSV_FILES = {
+    "contract-specifications.csv",
+    "pip-value-by-lot-size.csv",
+    "losing-streak-equity.csv",
+    "drawdown-recovery.csv",
+}
+
+
+def load_csv(name: str) -> List[Dict[str, str]]:
+    """Return one of the packaged CSV files as a list of dicts."""
+    if name not in CSV_FILES:
+        raise ValueError("unknown data file: " + name)
+    resource = resources.files(__package__).joinpath("data", name)
+    text = resource.read_text(encoding="utf-8-sig")
+    reader = csv.DictReader(text.splitlines())
+    return [dict(row) for row in reader]
+
+
+def contract_specifications() -> List[Dict[str, str]]:
+    """Pip size, contract size and minimum step per instrument (131 rows)."""
+    return load_csv("contract-specifications.csv")
+
+
+def pip_values() -> List[Dict[str, str]]:
+    """Pip value and loss on a 20 pip move for standard, mini, micro and nano lots."""
+    return load_csv("pip-value-by-lot-size.csv")
+
+
+def losing_streak_equity() -> List[Dict[str, str]]:
+    """Equity remaining after n consecutive losses at 0.5%, 1% and 2% risk."""
+    return load_csv("losing-streak-equity.csv")
+
+
+def drawdown_recovery() -> List[Dict[str, str]]:
+    """Gain required on the reduced balance to return to the original balance."""
+    return load_csv("drawdown-recovery.csv")
+
+
+def position_size(
+    balance: float,
+    risk_percent: float,
+    entry: float,
+    stop: float,
+    spread: float = 0.0,
+    commission: float = 0.0,
+    quote_rate: float = 1.0,
+    unit_step: float = 0.01,
+) -> Dict[str, float]:
+    """Convert a risk budget into a tradable unit count.
+
+    ``balance`` and ``commission`` are in account currency. ``risk_percent`` is
+    expressed as a number (1 means 1%). ``quote_rate`` converts one unit of the
+    quote currency into account currency; leave it at 1.0 when they are the
+    same. ``unit_step`` is the broker's minimum increment.
+
+    The returned ``worst_case_loss`` is recomputed from the ROUNDED size, which
+    is the number that actually matters: it is what the account loses if the
+    stop is hit.
+    """
+    budget = balance * risk_percent / 100.0
+    stop_distance = abs(entry - stop) + spread
+    if stop_distance <= 0:
+        raise ValueError("stop distance must be greater than zero")
+    if quote_rate <= 0:
+        raise ValueError("quote_rate must be greater than zero")
+    if unit_step <= 0:
+        raise ValueError("unit_step must be greater than zero")
+    units = (budget - commission) / (stop_distance * quote_rate)
+    tradable = math.floor(units / unit_step) * unit_step
+    worst_case = tradable * stop_distance * quote_rate + commission
+    return {
+        "risk_budget": budget,
+        "units": units,
+        "tradable_units": tradable,
+        "worst_case_loss": worst_case,
+    }

position_sizing_data-0.1.0/src/position_sizing_data/data/contract-specifications.csv

@@ -0,0 +1,132 @@
+symbol,asset_class,quote_currency,pip_size,contract_size,unit_step
+AUD/USD,forex,USD,0.0001,100000,1000
+EUR/USD,forex,USD,0.0001,100000,1000
+GBP/USD,forex,USD,0.0001,100000,1000
+NZD/USD,forex,USD,0.0001,100000,1000
+USD/JPY,forex,JPY,0.01,100000,1000
+USD/CHF,forex,CHF,0.0001,100000,1000
+USD/CAD,forex,CAD,0.0001,100000,1000
+USD/MXN,forex,MXN,0.0001,100000,1000
+USD/ZAR,forex,ZAR,0.0001,100000,1000
+USD/TRY,forex,TRY,0.0001,100000,1000
+USD/SEK,forex,SEK,0.0001,100000,1000
+USD/NOK,forex,NOK,0.0001,100000,1000
+USD/DKK,forex,DKK,0.0001,100000,1000
+USD/PLN,forex,PLN,0.0001,100000,1000
+USD/HUF,forex,HUF,0.0001,100000,1000
+USD/CZK,forex,CZK,0.0001,100000,1000
+USD/SGD,forex,SGD,0.0001,100000,1000
+USD/HKD,forex,HKD,0.0001,100000,1000
+USD/CNH,forex,CNH,0.0001,100000,1000
+USD/THB,forex,THB,0.0001,100000,1000
+USD/MYR,forex,MYR,0.0001,100000,1000
+USD/PHP,forex,PHP,0.0001,100000,1000
+USD/IDR,forex,IDR,0.0001,100000,1000
+USD/INR,forex,INR,0.0001,100000,1000
+USD/KRW,forex,KRW,0.0001,100000,1000
+EUR/JPY,forex,JPY,0.01,100000,1000
+GBP/JPY,forex,JPY,0.01,100000,1000
+AUD/JPY,forex,JPY,0.01,100000,1000
+CAD/JPY,forex,JPY,0.01,100000,1000
+CHF/JPY,forex,JPY,0.01,100000,1000
+NZD/JPY,forex,JPY,0.01,100000,1000
+EUR/GBP,forex,GBP,0.0001,100000,1000
+EUR/AUD,forex,AUD,0.0001,100000,1000
+EUR/CAD,forex,CAD,0.0001,100000,1000
+EUR/CHF,forex,CHF,0.0001,100000,1000
+EUR/NZD,forex,NZD,0.0001,100000,1000
+EUR/SEK,forex,SEK,0.0001,100000,1000
+EUR/NOK,forex,NOK,0.0001,100000,1000
+EUR/DKK,forex,DKK,0.0001,100000,1000
+EUR/PLN,forex,PLN,0.0001,100000,1000
+EUR/TRY,forex,TRY,0.0001,100000,1000
+EUR/ZAR,forex,ZAR,0.0001,100000,1000
+EUR/MXN,forex,MXN,0.0001,100000,1000
+EUR/HUF,forex,HUF,0.0001,100000,1000
+EUR/CZK,forex,CZK,0.0001,100000,1000
+EUR/SGD,forex,SGD,0.0001,100000,1000
+EUR/HKD,forex,HKD,0.0001,100000,1000
+GBP/AUD,forex,AUD,0.0001,100000,1000
+GBP/CAD,forex,CAD,0.0001,100000,1000
+GBP/CHF,forex,CHF,0.0001,100000,1000
+GBP/NZD,forex,NZD,0.0001,100000,1000
+GBP/SEK,forex,SEK,0.0001,100000,1000
+GBP/NOK,forex,NOK,0.0001,100000,1000
+GBP/PLN,forex,PLN,0.0001,100000,1000
+GBP/ZAR,forex,ZAR,0.0001,100000,1000
+GBP/TRY,forex,TRY,0.0001,100000,1000
+GBP/SGD,forex,SGD,0.0001,100000,1000
+AUD/CAD,forex,CAD,0.0001,100000,1000
+AUD/CHF,forex,CHF,0.0001,100000,1000
+AUD/NZD,forex,NZD,0.0001,100000,1000
+AUD/SGD,forex,SGD,0.0001,100000,1000
+AUD/HKD,forex,HKD,0.0001,100000,1000
+CAD/CHF,forex,CHF,0.0001,100000,1000
+NZD/CAD,forex,CAD,0.0001,100000,1000
+NZD/CHF,forex,CHF,0.0001,100000,1000
+NZD/SGD,forex,SGD,0.0001,100000,1000
+CHF/PLN,forex,PLN,0.0001,100000,1000
+XAU/USD,metal,USD,0.01,100,1
+XAG/USD,metal,USD,0.001,5000,1
+XPT/USD,metal,USD,0.01,100,1
+XPD/USD,metal,USD,0.01,100,1
+WTI/USD,energy,USD,0.01,1000,1
+BRENT/USD,energy,USD,0.01,1000,1
+NATGAS/USD,energy,USD,0.001,10000,1
+US30,index,USD,1,1,1
+US500,index,USD,1,1,1
+USTEC,index,USD,1,1,1
+DE40,index,USD,1,1,1
+UK100,index,USD,1,1,1
+JP225,index,USD,1,1,1
+AUS200,index,USD,1,1,1
+FRA40,index,USD,1,1,1
+EU50,index,USD,1,1,1
+SPA35,index,USD,1,1,1
+HK50,index,USD,1,1,1
+CHINA50,index,USD,1,1,1
+BTCUSDT,crypto,USD,0.01,1,0.001
+ETHUSDT,crypto,USD,0.01,1,0.001
+SOLUSDT,crypto,USD,0.01,1,0.001
+XRPUSDT,crypto,USD,0.01,1,0.001
+ADAUSDT,crypto,USD,0.01,1,0.001
+DOGEUSDT,crypto,USD,0.01,1,0.001
+AVAXUSDT,crypto,USD,0.01,1,0.001
+LINKUSDT,crypto,USD,0.01,1,0.001
+DOTUSDT,crypto,USD,0.01,1,0.001
+TONUSDT,crypto,USD,0.01,1,0.001
+LTCUSDT,crypto,USD,0.01,1,0.001
+BCHUSDT,crypto,USD,0.01,1,0.001
+UNIUSDT,crypto,USD,0.01,1,0.001
+ATOMUSDT,crypto,USD,0.01,1,0.001
+TRXUSDT,crypto,USD,0.01,1,0.001
+XLMUSDT,crypto,USD,0.01,1,0.001
+NEARUSDT,crypto,USD,0.01,1,0.001
+APTUSDT,crypto,USD,0.01,1,0.001
+ARBUSDT,crypto,USD,0.01,1,0.001
+OPUSDT,crypto,USD,0.01,1,0.001
+SUIUSDT,crypto,USD,0.01,1,0.001
+ICPUSDT,crypto,USD,0.01,1,0.001
+FILUSDT,crypto,USD,0.01,1,0.001
+INJUSDT,crypto,USD,0.01,1,0.001
+AAVEUSDT,crypto,USD,0.01,1,0.001
+GRTUSDT,crypto,USD,0.01,1,0.001
+THETAUSDT,crypto,USD,0.01,1,0.001
+EOSUSDT,crypto,USD,0.01,1,0.001
+CHZUSDT,crypto,USD,0.01,1,0.001
+SANDUSDT,crypto,USD,0.01,1,0.001
+MANAUSDT,crypto,USD,0.01,1,0.001
+AXSUSDT,crypto,USD,0.01,1,0.001
+GALAUSDT,crypto,USD,0.01,1,0.001
+IMXUSDT,crypto,USD,0.01,1,0.001
+RUNEUSDT,crypto,USD,0.01,1,0.001
+TIAUSDT,crypto,USD,0.01,1,0.001
+SEIUSDT,crypto,USD,0.01,1,0.001
+PEPEUSDT,crypto,USD,0.01,1,0.001
+ORDIUSDT,crypto,USD,0.01,1,0.001
+WIFUSDT,crypto,USD,0.01,1,0.001
+BNBUSDT,crypto,USD,0.01,1,0.001
+ETCUSDT,crypto,USD,0.01,1,0.001
+VETUSDT,crypto,USD,0.01,1,0.001
+Stock (your ticker),stock,USD,0.01,1,1
+Custom instrument,custom,USD,0.0001,1,0.001

position_sizing_data-0.1.0/src/position_sizing_data/data/drawdown-recovery.csv

@@ -0,0 +1,13 @@
+drawdown_pct,gain_required_pct_to_recover
+5%,5.3%
+10%,11.1%
+15%,17.6%
+20%,25.0%
+25%,33.3%
+30%,42.9%
+40%,66.7%
+50%,100.0%
+60%,150.0%
+70%,233.3%
+80%,400.0%
+90%,900.0%

position_sizing_data-0.1.0/src/position_sizing_data/data/losing-streak-equity.csv

@@ -0,0 +1,21 @@
+consecutive_losses,equity_remaining_0.5pct,equity_remaining_1pct,equity_remaining_2pct
+1,99.50%,99.00%,98.00%
+2,99.00%,98.01%,96.04%
+3,98.51%,97.03%,94.12%
+4,98.01%,96.06%,92.24%
+5,97.52%,95.10%,90.39%
+6,97.04%,94.15%,88.58%
+7,96.55%,93.21%,86.81%
+8,96.07%,92.27%,85.08%
+9,95.59%,91.35%,83.37%
+10,95.11%,90.44%,81.71%
+11,94.64%,89.53%,80.07%
+12,94.16%,88.64%,78.47%
+13,93.69%,87.75%,76.90%
+14,93.22%,86.87%,75.36%
+15,92.76%,86.01%,73.86%
+16,92.29%,85.15%,72.38%
+17,91.83%,84.29%,70.93%
+18,91.37%,83.45%,69.51%
+19,90.92%,82.62%,68.12%
+20,90.46%,81.79%,66.76%

position_sizing_data-0.1.0/src/position_sizing_data/data/pip-value-by-lot-size.csv

@@ -0,0 +1,5 @@
+lot,units,pip_value_usd_on_usd_quote_pair,pip_value_usd_on_jpy_pair_at_150_00,loss_on_20_pip_move_usd,spread_cost_of_1_pip_usd
+standard,100000,10.0000,6.6667,200.00,10.0000
+mini,10000,1.0000,0.6667,20.00,1.0000
+micro,1000,0.1000,0.0667,2.00,0.1000
+nano,100,0.0100,0.0067,0.20,0.0100

position_sizing_data-0.1.0/src/position_sizing_data.egg-info/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: position-sizing-data
+Version: 0.1.0
+Summary: Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures
+Author: JUN YI
+License-Expression: MIT
+Project-URL: Homepage, https://positionsizetool.com/
+Project-URL: Repository, https://github.com/tk25719/position-sizing-data
+Project-URL: Zenodo, https://doi.org/10.5281/zenodo.22840538
+Keywords: position sizing,risk management,forex,trading,crypto
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# position-sizing-data
+
+Reference data and arithmetic for risk-based position sizing across forex, stocks and crypto futures.
+
+The same tables are published as a citable dataset: [doi:10.5281/zenodo.22840538](https://doi.org/10.5281/zenodo.22840538), and used by the web calculator at [https://positionsizetool.com/](https://positionsizetool.com/). Source repository: [https://github.com/tk25719/position-sizing-data](https://github.com/tk25719/position-sizing-data).
+
+## Install
+
+```console
+pip install position-sizing-data
+```
+
+## What is in it
+
+| Function | Returns |
+| --- | --- |
+| `contract_specifications()` | Pip size, contract size and minimum unit step for 131 instruments, across forex pairs, metals, energies, indices, crypto futures, stocks and ETFs. |
+| `pip_values()` | Pip value and the loss on a 20 pip move for standard, mini, micro and nano lots. |
+| `losing_streak_equity()` | Equity remaining after 1 to 20 consecutive losses at 0.5%, 1% and 2% risk per trade. |
+| `drawdown_recovery()` | Gain required on the reduced balance to return to the original balance, for drawdowns from 5% to 90%. |
+| `position_size(...)` | The risk-to-units calculation itself. |
+
+Read the tables:
+
+```python
+from position_sizing_data import contract_specifications
+
+rows = contract_specifications()
+print(rows[0])
+```
+
+Compute a size:
+
+```python
+from position_sizing_data import position_size
+
+result = position_size(
+    balance=10000.0,
+    risk_percent=1.0,
+    entry=1.1000,
+    stop=1.0980,
+    unit_step=1000.0,   # 0.01 lot
+)
+print(result)
+# {'risk_budget': 100.0, 'units': 50000.0, 'tradable_units': 50000.0, 'worst_case_loss': 100.0}
+```
+
+## The formula
+
+```
+units = (risk_budget - commission) / ((|entry - stop| + spread) x quote_rate)
+```
+
+The tradable size is that number rounded **down** to `unit_step`. `position_size` returns the worst-case loss recomputed from the rounded size, which is what the account actually loses when the stop is hit.
+
+## Where the numbers come from
+
+The rows in `contract_specifications()` are typical retail contract specifications, not exchange-published official values. Verify the contract size and unit step against your own broker before placing an order. The other three tables are closed-form arithmetic:
+
+- losing streak: `remaining = (1 - risk)^n`
+- drawdown recovery: `gain_required = 1 / (1 - drawdown) - 1`
+- pip value: `pip_value = units x pip_size`
+
+## Licence
+
+MIT for the code. Data files are CC0 1.0 Universal, to the extent applicable. This is not investment advice.

position_sizing_data-0.1.0/src/position_sizing_data.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/position_sizing_data/__init__.py
+src/position_sizing_data.egg-info/PKG-INFO
+src/position_sizing_data.egg-info/SOURCES.txt
+src/position_sizing_data.egg-info/dependency_links.txt
+src/position_sizing_data.egg-info/top_level.txt
+src/position_sizing_data/data/contract-specifications.csv
+src/position_sizing_data/data/drawdown-recovery.csv
+src/position_sizing_data/data/losing-streak-equity.csv
+src/position_sizing_data/data/pip-value-by-lot-size.csv

position_sizing_data-0.1.0/src/position_sizing_data.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

position_sizing_data-0.1.0/src/position_sizing_data.egg-info/top_level.txt

@@ -0,0 +1 @@
+position_sizing_data