polymarket-risk-manager 3.1.0 → 3.3.0

package/README.md

@@ -1,6 +1,20 @@
 # polymarket-risk-manager
 
-Kelly-criterion stake sizing for Polymarket-style binary markets.
+Kelly-criterion helpers for Polymarket **Up/Down** binary markets.
+
+## Changelog
+
+### 3.3.0
+
+- Added `roundStake()` for 2dp stake rounding
+
+### 3.2.0
+
+- Added `formatStakeUsd()`
+
+### 3.1.0
+
+- Initial Kelly stake release
 
 ## Install
 
@@ -8,19 +22,10 @@ Kelly-criterion stake sizing for Polymarket-style binary markets.
 npm install polymarket-risk-manager
 ```
 
-## API (3.1.0)
+## API
 
 ```javascript
-const { computeKellyStake } = require('polymarket-risk-manager');
-
-computeKellyStake({
-  probability: 0.58,
-  allInPrice: 0.52,
-  bankroll: 500,
-  maxStake: 25,
-  minStake: 5,
-  kellyFraction: 0.5,
-});
+const { computeKellyStake, formatStakeUsd, roundStake } = require('polymarket-risk-manager');
 ```
 
 ## Licence

package/index.js

@@ -1,29 +1,5 @@
 'use strict';
 
-/** @deprecated use computeKellyStake from 3.2+ for formatted output */
-function computeKellyStake({
-  probability,
-  allInPrice,
-  bankroll,
-  maxStake,
-  minStake = 0,
-  kellyFraction = 0.5,
-}) {
-  if (
-    !Number.isFinite(probability) ||
-    !Number.isFinite(allInPrice) ||
-    !Number.isFinite(bankroll) ||
-    allInPrice <= 0 ||
-    allInPrice >= 1
-  ) {
-    return minStake;
-  }
+const { computeKellyStake, formatStakeUsd, roundStake } = require('./kelly.js');
 
-  const rawKelly = (probability - allInPrice) / (1 - allInPrice);
-  if (rawKelly <= 0) return minStake;
-
-  const stake = bankroll * rawKelly * kellyFraction;
-  return Math.min(maxStake, Math.max(minStake, stake));
-}
-
-module.exports = { computeKellyStake };
+module.exports = { computeKellyStake, formatStakeUsd, roundStake };

package/kelly.js

@@ -0,0 +1,56 @@
+'use strict';
+
+function round(value, dp) {
+  const n = Number(value);
+  const places = Number(dp) || 0;
+  if (!Number.isFinite(n)) return NaN;
+  const p = 10 ** places;
+  return Math.round(n * p) / p;
+}
+
+function format(value, dp) {
+  const n = round(value, dp);
+  if (!Number.isFinite(n)) return String(value);
+  return n.toFixed(dp == null ? 0 : dp);
+}
+
+function computeKellyStake({
+  probability,
+  allInPrice,
+  bankroll,
+  maxStake,
+  minStake = 0,
+  kellyFraction = 0.5,
+}) {
+  if (
+    !Number.isFinite(probability) ||
+    !Number.isFinite(allInPrice) ||
+    !Number.isFinite(bankroll) ||
+    allInPrice <= 0 ||
+    allInPrice >= 1
+  ) {
+    return minStake;
+  }
+
+  const rawKelly = (probability - allInPrice) / (1 - allInPrice);
+  if (rawKelly <= 0) return minStake;
+
+  const stake = bankroll * rawKelly * kellyFraction;
+  return round(Math.min(maxStake, Math.max(minStake, stake)), 2);
+}
+
+function formatStakeUsd(value) {
+  return format(value, 2);
+}
+
+function roundStake(value) {
+  return round(value, 2);
+}
+
+module.exports = {
+  computeKellyStake,
+  formatStakeUsd,
+  roundStake,
+  round,
+  format,
+};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "polymarket-risk-manager",
-  "version": "3.1.0",
-  "description": "Polymarket Kelly stake sizing and decimal-safe rounding for binary markets",
+  "version": "3.3.0",
+  "description": "Kelly stake sizing and decimal-safe rounding for Polymarket binary markets",
   "main": "index.js",
-  "files": ["index.js", "README.md"],
-  "keywords": ["polymarket", "kelly", "prediction-markets", "stake"],
+  "files": ["index.js", "kelly.js", "README.md"],
+  "keywords": ["polymarket", "kelly", "prediction-markets", "stake", "binary"],
   "license": "MIT",
   "type": "commonjs"
 }