@fullstackcraftllc/floe 0.0.16 → 0.0.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/hedgeflow/index.d.ts +2 -0
- package/dist/hedgeflow/index.js +4 -1
- package/dist/hedgeflow/pressurecloud.d.ts +166 -0
- package/dist/hedgeflow/pressurecloud.js +243 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +4 -2
- package/package.json +5 -2
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { ExposurePerExpiry, IVSurface } from '../types';
|
|
2
2
|
import { HedgeImpulseConfig, CharmIntegralConfig, HedgeFlowAnalysis } from './types';
|
|
3
3
|
export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, } from './types';
|
|
4
|
+
export type { HedgeContractEstimates, PressureZone, RegimeEdge, PressureLevel, PressureCloudConfig, PressureCloud, } from './pressurecloud';
|
|
4
5
|
export { deriveRegimeParams, interpolateIVAtStrike } from './regime';
|
|
5
6
|
export { computeHedgeImpulseCurve } from './curve';
|
|
6
7
|
export { computeCharmIntegral } from './charm';
|
|
8
|
+
export { computePressureCloud } from './pressurecloud';
|
|
7
9
|
/**
|
|
8
10
|
* Compute a complete hedge flow analysis for a single expiration.
|
|
9
11
|
*
|
package/dist/hedgeflow/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = void 0;
|
|
3
|
+
exports.computePressureCloud = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = void 0;
|
|
4
4
|
exports.analyzeHedgeFlow = analyzeHedgeFlow;
|
|
5
5
|
const regime_1 = require("./regime");
|
|
6
6
|
const curve_1 = require("./curve");
|
|
@@ -14,6 +14,9 @@ var curve_2 = require("./curve");
|
|
|
14
14
|
Object.defineProperty(exports, "computeHedgeImpulseCurve", { enumerable: true, get: function () { return curve_2.computeHedgeImpulseCurve; } });
|
|
15
15
|
var charm_2 = require("./charm");
|
|
16
16
|
Object.defineProperty(exports, "computeCharmIntegral", { enumerable: true, get: function () { return charm_2.computeCharmIntegral; } });
|
|
17
|
+
// Re-export pressure cloud
|
|
18
|
+
var pressurecloud_1 = require("./pressurecloud");
|
|
19
|
+
Object.defineProperty(exports, "computePressureCloud", { enumerable: true, get: function () { return pressurecloud_1.computePressureCloud; } });
|
|
17
20
|
/**
|
|
18
21
|
* Compute a complete hedge flow analysis for a single expiration.
|
|
19
22
|
*
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import { HedgeImpulseCurve } from './types';
|
|
2
|
+
import { RegimeParams } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Expected dealer hedge volume in futures contracts for a 1-point spot move.
|
|
5
|
+
* Positive = dealers buying, negative = dealers selling.
|
|
6
|
+
*/
|
|
7
|
+
export interface HedgeContractEstimates {
|
|
8
|
+
/** E-mini Nasdaq 100 (multiplier: 20) */
|
|
9
|
+
nq: number;
|
|
10
|
+
/** Micro E-mini Nasdaq 100 (multiplier: 2) */
|
|
11
|
+
mnq: number;
|
|
12
|
+
/** E-mini S&P 500 (multiplier: 50) */
|
|
13
|
+
es: number;
|
|
14
|
+
/** Micro E-mini S&P 500 (multiplier: 5) */
|
|
15
|
+
mes: number;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* A zone where price is likely to stabilize (positive impulse)
|
|
19
|
+
* or accelerate (negative impulse).
|
|
20
|
+
*/
|
|
21
|
+
export interface PressureZone {
|
|
22
|
+
/** Center price of the zone (peak of the impulse) */
|
|
23
|
+
center: number;
|
|
24
|
+
/** Lower bound of the zone (25th percentile of the peak width) */
|
|
25
|
+
lower: number;
|
|
26
|
+
/** Upper bound of the zone (75th percentile of the peak width) */
|
|
27
|
+
upper: number;
|
|
28
|
+
/** Normalized strength 0-1 (relative to the strongest zone found) */
|
|
29
|
+
strength: number;
|
|
30
|
+
/** Whether this zone is above or below current spot */
|
|
31
|
+
side: 'above-spot' | 'below-spot';
|
|
32
|
+
/**
|
|
33
|
+
* Trade type this zone favors:
|
|
34
|
+
* - Stability zones below spot → long (buy the bounce)
|
|
35
|
+
* - Stability zones above spot → short (sell the rejection)
|
|
36
|
+
* - Acceleration zones below spot → short (momentum downside)
|
|
37
|
+
* - Acceleration zones above spot → long (momentum upside / squeeze)
|
|
38
|
+
*/
|
|
39
|
+
tradeType: 'long' | 'short';
|
|
40
|
+
/**
|
|
41
|
+
* Hedge execution type:
|
|
42
|
+
* - passive: dealers post resting limit orders (positive gamma → absorption)
|
|
43
|
+
* - aggressive: dealers send market orders (negative gamma → sweeping)
|
|
44
|
+
*/
|
|
45
|
+
hedgeType: 'passive' | 'aggressive';
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* A regime boundary where behavior flips between mean-reverting and trend-amplifying.
|
|
49
|
+
*/
|
|
50
|
+
export interface RegimeEdge {
|
|
51
|
+
/** Price at which the impulse curve crosses zero */
|
|
52
|
+
price: number;
|
|
53
|
+
/** Direction of the transition relative to a downward price move */
|
|
54
|
+
transitionType: 'stable-to-unstable' | 'unstable-to-stable';
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Per-price-level detail for the full pressure overlay.
|
|
58
|
+
*/
|
|
59
|
+
export interface PressureLevel {
|
|
60
|
+
/** Price level */
|
|
61
|
+
price: number;
|
|
62
|
+
/**
|
|
63
|
+
* Stability score: positive means mean-reverting pressure at this level.
|
|
64
|
+
* Higher = stronger buffering. Weighted by proximity to spot.
|
|
65
|
+
*/
|
|
66
|
+
stabilityScore: number;
|
|
67
|
+
/**
|
|
68
|
+
* Acceleration score: positive means trend-amplifying pressure at this level.
|
|
69
|
+
* Higher = stronger momentum fuel. Weighted by proximity to spot.
|
|
70
|
+
*/
|
|
71
|
+
accelerationScore: number;
|
|
72
|
+
/**
|
|
73
|
+
* Expected signed hedge contracts (positive = dealers buy, negative = dealers sell)
|
|
74
|
+
* for a 1-point spot move toward this level. Units depend on product.
|
|
75
|
+
* @deprecated Use hedgeContracts instead for multi-product estimates.
|
|
76
|
+
*/
|
|
77
|
+
expectedHedgeContracts: number;
|
|
78
|
+
/** Multi-product hedge contract estimates */
|
|
79
|
+
hedgeContracts: HedgeContractEstimates;
|
|
80
|
+
/**
|
|
81
|
+
* Whether dealers would hedge passively (limit orders / absorption)
|
|
82
|
+
* or aggressively (market orders / sweeping) at this level.
|
|
83
|
+
*/
|
|
84
|
+
hedgeType: 'passive' | 'aggressive';
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Configuration for pressure cloud computation.
|
|
88
|
+
*/
|
|
89
|
+
export interface PressureCloudConfig {
|
|
90
|
+
/**
|
|
91
|
+
* Product multiplier for contract conversion.
|
|
92
|
+
* NQ = 20, MNQ = 2, ES = 50, MES = 5, SPY = 100 (shares).
|
|
93
|
+
* Default: 20 (NQ)
|
|
94
|
+
*/
|
|
95
|
+
contractMultiplier?: number;
|
|
96
|
+
/** Product type hint for primary contract display. Default: 'NQ' */
|
|
97
|
+
product?: 'NQ' | 'MNQ' | 'ES' | 'MES' | 'SPY';
|
|
98
|
+
/**
|
|
99
|
+
* How many expected-daily-moves to consider "reachable".
|
|
100
|
+
* Levels beyond this get heavily penalized. Default: 2.0
|
|
101
|
+
*/
|
|
102
|
+
reachabilityMultiple?: number;
|
|
103
|
+
/**
|
|
104
|
+
* Minimum impulse magnitude (as fraction of mean abs impulse) to
|
|
105
|
+
* qualify as a zone. Default: 0.15
|
|
106
|
+
*/
|
|
107
|
+
zoneThreshold?: number;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Complete pressure cloud analysis combining stability and acceleration zones.
|
|
111
|
+
*/
|
|
112
|
+
export interface PressureCloud {
|
|
113
|
+
/** Current spot price */
|
|
114
|
+
spot: number;
|
|
115
|
+
/** Expiration timestamp */
|
|
116
|
+
expiration: number;
|
|
117
|
+
/** Timestamp when this cloud was computed */
|
|
118
|
+
computedAt: number;
|
|
119
|
+
/**
|
|
120
|
+
* Stability zones: levels where positive dealer impulse creates
|
|
121
|
+
* mean-reverting pressure. Price decelerates into these zones.
|
|
122
|
+
* Trade approach: reversal / bounce entries.
|
|
123
|
+
*/
|
|
124
|
+
stabilityZones: PressureZone[];
|
|
125
|
+
/**
|
|
126
|
+
* Acceleration zones: levels where negative dealer impulse creates
|
|
127
|
+
* trend-amplifying pressure. Price accelerates through these zones.
|
|
128
|
+
* Trade approach: momentum / breakout continuation.
|
|
129
|
+
*/
|
|
130
|
+
accelerationZones: PressureZone[];
|
|
131
|
+
/**
|
|
132
|
+
* Regime edges: prices where the impulse curve crosses zero,
|
|
133
|
+
* marking transitions between mean-reverting and trend-amplifying behavior.
|
|
134
|
+
*/
|
|
135
|
+
regimeEdges: RegimeEdge[];
|
|
136
|
+
/**
|
|
137
|
+
* Per-price-level detail for the full chart overlay.
|
|
138
|
+
* Every point on the impulse curve grid, enriched with scores and contract estimates.
|
|
139
|
+
*/
|
|
140
|
+
priceLevels: PressureLevel[];
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Compute a pressure cloud from an existing hedge impulse curve.
|
|
144
|
+
*
|
|
145
|
+
* The pressure cloud translates the raw impulse curve into actionable
|
|
146
|
+
* trading zones:
|
|
147
|
+
*
|
|
148
|
+
* - **Stability zones** (positive impulse peaks, weighted by proximity):
|
|
149
|
+
* Where dealer hedging creates counter-trend flow. These are bounce/rejection
|
|
150
|
+
* targets — price decelerates into them and often stalls or reverses.
|
|
151
|
+
*
|
|
152
|
+
* - **Acceleration zones** (negative impulse troughs, weighted by proximity):
|
|
153
|
+
* Where dealer hedging creates with-trend flow. If price reaches these levels,
|
|
154
|
+
* dealers amplify the move. These are momentum/breakout zones — price
|
|
155
|
+
* accelerates through them.
|
|
156
|
+
*
|
|
157
|
+
* - **Regime edges** (zero crossings):
|
|
158
|
+
* Where behavior flips. Critical for understanding "if price breaks past X,
|
|
159
|
+
* the character of the tape changes."
|
|
160
|
+
*
|
|
161
|
+
* @param impulseCurve - A previously computed hedge impulse curve
|
|
162
|
+
* @param regimeParams - Regime parameters (for expected daily move / reachability)
|
|
163
|
+
* @param config - Optional tuning parameters
|
|
164
|
+
* @returns Complete pressure cloud analysis
|
|
165
|
+
*/
|
|
166
|
+
export declare function computePressureCloud(impulseCurve: HedgeImpulseCurve, regimeParams: RegimeParams, config?: PressureCloudConfig): PressureCloud;
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.computePressureCloud = computePressureCloud;
|
|
4
|
+
/** Product multipliers for contract conversion */
|
|
5
|
+
const PRODUCT_MULTIPLIERS = {
|
|
6
|
+
NQ: 20,
|
|
7
|
+
MNQ: 2,
|
|
8
|
+
ES: 50,
|
|
9
|
+
MES: 5,
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Convert a dollar impulse value to hedge contracts for a given product multiplier.
|
|
13
|
+
* contracts = impulse / (multiplier * spot * 0.01)
|
|
14
|
+
*/
|
|
15
|
+
function impulseToContracts(impulse, multiplier, spot) {
|
|
16
|
+
const denominator = multiplier * spot * 0.01;
|
|
17
|
+
return denominator > 0 ? sanitize(impulse / denominator) : 0;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Compute multi-product hedge contract estimates from a dollar impulse value.
|
|
21
|
+
*/
|
|
22
|
+
function computeHedgeContractEstimates(impulse, spot) {
|
|
23
|
+
return {
|
|
24
|
+
nq: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.NQ, spot),
|
|
25
|
+
mnq: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.MNQ, spot),
|
|
26
|
+
es: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.ES, spot),
|
|
27
|
+
mes: impulseToContracts(impulse, PRODUCT_MULTIPLIERS.MES, spot),
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
// ============================================================================
|
|
31
|
+
// Implementation
|
|
32
|
+
// ============================================================================
|
|
33
|
+
/**
|
|
34
|
+
* Compute a pressure cloud from an existing hedge impulse curve.
|
|
35
|
+
*
|
|
36
|
+
* The pressure cloud translates the raw impulse curve into actionable
|
|
37
|
+
* trading zones:
|
|
38
|
+
*
|
|
39
|
+
* - **Stability zones** (positive impulse peaks, weighted by proximity):
|
|
40
|
+
* Where dealer hedging creates counter-trend flow. These are bounce/rejection
|
|
41
|
+
* targets — price decelerates into them and often stalls or reverses.
|
|
42
|
+
*
|
|
43
|
+
* - **Acceleration zones** (negative impulse troughs, weighted by proximity):
|
|
44
|
+
* Where dealer hedging creates with-trend flow. If price reaches these levels,
|
|
45
|
+
* dealers amplify the move. These are momentum/breakout zones — price
|
|
46
|
+
* accelerates through them.
|
|
47
|
+
*
|
|
48
|
+
* - **Regime edges** (zero crossings):
|
|
49
|
+
* Where behavior flips. Critical for understanding "if price breaks past X,
|
|
50
|
+
* the character of the tape changes."
|
|
51
|
+
*
|
|
52
|
+
* @param impulseCurve - A previously computed hedge impulse curve
|
|
53
|
+
* @param regimeParams - Regime parameters (for expected daily move / reachability)
|
|
54
|
+
* @param config - Optional tuning parameters
|
|
55
|
+
* @returns Complete pressure cloud analysis
|
|
56
|
+
*/
|
|
57
|
+
function computePressureCloud(impulseCurve, regimeParams, config = {}) {
|
|
58
|
+
const { contractMultiplier = 20, // NQ default
|
|
59
|
+
reachabilityMultiple = 2.0, zoneThreshold = 0.15, } = config;
|
|
60
|
+
const { spot, curve, extrema, zeroCrossings } = impulseCurve;
|
|
61
|
+
const expectedMove = regimeParams.expectedDailySpotMove * spot;
|
|
62
|
+
// Compute reachability-weighted scores for each price level
|
|
63
|
+
const priceLevels = computePriceLevels(curve, spot, expectedMove, reachabilityMultiple, contractMultiplier);
|
|
64
|
+
// Extract stability zones from positive impulse peaks
|
|
65
|
+
const stabilityZones = extractStabilityZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold);
|
|
66
|
+
// Extract acceleration zones from negative impulse troughs
|
|
67
|
+
const accelerationZones = extractAccelerationZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold);
|
|
68
|
+
// Convert zero crossings to regime edges
|
|
69
|
+
const regimeEdges = convertZeroCrossingsToEdges(zeroCrossings, spot);
|
|
70
|
+
return {
|
|
71
|
+
spot,
|
|
72
|
+
expiration: impulseCurve.expiration,
|
|
73
|
+
computedAt: Date.now(),
|
|
74
|
+
stabilityZones,
|
|
75
|
+
accelerationZones,
|
|
76
|
+
regimeEdges,
|
|
77
|
+
priceLevels,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Compute per-price-level detail from the impulse curve.
|
|
82
|
+
*/
|
|
83
|
+
function computePriceLevels(curve, spot, expectedMove, reachabilityMultiple, contractMultiplier) {
|
|
84
|
+
const reachRange = expectedMove * reachabilityMultiple;
|
|
85
|
+
return curve.map((point) => {
|
|
86
|
+
const distance = Math.abs(point.price - spot);
|
|
87
|
+
const proximity = Math.exp(-((distance / reachRange) ** 2));
|
|
88
|
+
// Stability: positive impulse weighted by proximity
|
|
89
|
+
const stabilityScore = point.impulse > 0
|
|
90
|
+
? point.impulse * proximity
|
|
91
|
+
: 0;
|
|
92
|
+
// Acceleration: negative impulse magnitude weighted by proximity
|
|
93
|
+
const accelerationScore = point.impulse < 0
|
|
94
|
+
? Math.abs(point.impulse) * proximity
|
|
95
|
+
: 0;
|
|
96
|
+
// Convert dollar impulse to signed contract count.
|
|
97
|
+
// impulse is $ of hedging per 1% move. For contracts per 1 point:
|
|
98
|
+
// contracts = impulse / (contractMultiplier * spot * 0.01)
|
|
99
|
+
const contractDenominator = contractMultiplier * spot * 0.01;
|
|
100
|
+
const expectedHedgeContracts = contractDenominator > 0
|
|
101
|
+
? point.impulse / contractDenominator
|
|
102
|
+
: 0;
|
|
103
|
+
return {
|
|
104
|
+
price: point.price,
|
|
105
|
+
stabilityScore,
|
|
106
|
+
accelerationScore,
|
|
107
|
+
expectedHedgeContracts: sanitize(expectedHedgeContracts),
|
|
108
|
+
hedgeContracts: computeHedgeContractEstimates(point.impulse, spot),
|
|
109
|
+
hedgeType: point.impulse >= 0 ? 'passive' : 'aggressive',
|
|
110
|
+
};
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Extract stability zones from positive impulse peaks (basins).
|
|
115
|
+
*/
|
|
116
|
+
function extractStabilityZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold) {
|
|
117
|
+
const basins = extrema.filter((e) => e.type === 'basin');
|
|
118
|
+
if (basins.length === 0)
|
|
119
|
+
return [];
|
|
120
|
+
const reachRange = expectedMove * reachabilityMultiple;
|
|
121
|
+
const maxImpulse = Math.max(...basins.map((b) => Math.abs(b.impulse)), 1e-10);
|
|
122
|
+
// Filter by threshold
|
|
123
|
+
const significant = basins.filter((b) => Math.abs(b.impulse) / maxImpulse >= zoneThreshold);
|
|
124
|
+
// Build zones
|
|
125
|
+
const zones = significant.map((basin) => {
|
|
126
|
+
const proximity = Math.exp(-((Math.abs(basin.price - spot) / reachRange) ** 2));
|
|
127
|
+
const rawStrength = (Math.abs(basin.impulse) / maxImpulse) * proximity;
|
|
128
|
+
// Find zone width: where impulse drops to 50% of peak
|
|
129
|
+
const halfPeak = basin.impulse * 0.5;
|
|
130
|
+
const { lower, upper } = findZoneBounds(curve, basin.price, halfPeak);
|
|
131
|
+
const side = basin.price >= spot ? 'above-spot' : 'below-spot';
|
|
132
|
+
const tradeType = side === 'below-spot' ? 'long' : 'short';
|
|
133
|
+
return {
|
|
134
|
+
center: basin.price,
|
|
135
|
+
lower,
|
|
136
|
+
upper,
|
|
137
|
+
strength: Math.min(1, rawStrength),
|
|
138
|
+
side,
|
|
139
|
+
tradeType,
|
|
140
|
+
hedgeType: 'passive',
|
|
141
|
+
};
|
|
142
|
+
});
|
|
143
|
+
// Sort by strength descending
|
|
144
|
+
return zones.sort((a, b) => b.strength - a.strength);
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Extract acceleration zones from negative impulse troughs (peaks in the type system).
|
|
148
|
+
*/
|
|
149
|
+
function extractAccelerationZones(extrema, curve, spot, expectedMove, reachabilityMultiple, zoneThreshold) {
|
|
150
|
+
const peaks = extrema.filter((e) => e.type === 'peak');
|
|
151
|
+
if (peaks.length === 0)
|
|
152
|
+
return [];
|
|
153
|
+
const reachRange = expectedMove * reachabilityMultiple;
|
|
154
|
+
const maxImpulse = Math.max(...peaks.map((p) => Math.abs(p.impulse)), 1e-10);
|
|
155
|
+
const significant = peaks.filter((p) => Math.abs(p.impulse) / maxImpulse >= zoneThreshold);
|
|
156
|
+
const zones = significant.map((peak) => {
|
|
157
|
+
const proximity = Math.exp(-((Math.abs(peak.price - spot) / reachRange) ** 2));
|
|
158
|
+
const rawStrength = (Math.abs(peak.impulse) / maxImpulse) * proximity;
|
|
159
|
+
const halfTrough = peak.impulse * 0.5;
|
|
160
|
+
const { lower, upper } = findZoneBounds(curve, peak.price, halfTrough);
|
|
161
|
+
const side = peak.price >= spot ? 'above-spot' : 'below-spot';
|
|
162
|
+
// Acceleration below spot → momentum short (waterfall)
|
|
163
|
+
// Acceleration above spot → momentum long (squeeze)
|
|
164
|
+
const tradeType = side === 'below-spot' ? 'short' : 'long';
|
|
165
|
+
return {
|
|
166
|
+
center: peak.price,
|
|
167
|
+
lower,
|
|
168
|
+
upper,
|
|
169
|
+
strength: Math.min(1, rawStrength),
|
|
170
|
+
side,
|
|
171
|
+
tradeType,
|
|
172
|
+
hedgeType: 'aggressive',
|
|
173
|
+
};
|
|
174
|
+
});
|
|
175
|
+
return zones.sort((a, b) => b.strength - a.strength);
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* Find the price bounds where impulse drops to the given threshold
|
|
179
|
+
* around a peak/trough center price.
|
|
180
|
+
*/
|
|
181
|
+
function findZoneBounds(curve, centerPrice, thresholdImpulse) {
|
|
182
|
+
// Find the center index
|
|
183
|
+
let centerIdx = 0;
|
|
184
|
+
let minDist = Infinity;
|
|
185
|
+
for (let i = 0; i < curve.length; i++) {
|
|
186
|
+
const d = Math.abs(curve[i].price - centerPrice);
|
|
187
|
+
if (d < minDist) {
|
|
188
|
+
minDist = d;
|
|
189
|
+
centerIdx = i;
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
const isPositive = thresholdImpulse > 0;
|
|
193
|
+
// Scan left for lower bound
|
|
194
|
+
let lowerIdx = centerIdx;
|
|
195
|
+
for (let i = centerIdx - 1; i >= 0; i--) {
|
|
196
|
+
if (isPositive ? curve[i].impulse < thresholdImpulse : curve[i].impulse > thresholdImpulse) {
|
|
197
|
+
lowerIdx = i;
|
|
198
|
+
break;
|
|
199
|
+
}
|
|
200
|
+
lowerIdx = i;
|
|
201
|
+
}
|
|
202
|
+
// Scan right for upper bound
|
|
203
|
+
let upperIdx = centerIdx;
|
|
204
|
+
for (let i = centerIdx + 1; i < curve.length; i++) {
|
|
205
|
+
if (isPositive ? curve[i].impulse < thresholdImpulse : curve[i].impulse > thresholdImpulse) {
|
|
206
|
+
upperIdx = i;
|
|
207
|
+
break;
|
|
208
|
+
}
|
|
209
|
+
upperIdx = i;
|
|
210
|
+
}
|
|
211
|
+
return {
|
|
212
|
+
lower: curve[lowerIdx].price,
|
|
213
|
+
upper: curve[upperIdx].price,
|
|
214
|
+
};
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* Convert impulse zero crossings into regime edge descriptors.
|
|
218
|
+
*/
|
|
219
|
+
function convertZeroCrossingsToEdges(crossings, spot) {
|
|
220
|
+
return crossings.map((crossing) => {
|
|
221
|
+
// A "falling" crossing means impulse goes from positive to negative.
|
|
222
|
+
// If this is below spot, moving down into it means going from
|
|
223
|
+
// stable (positive impulse) to unstable (negative impulse).
|
|
224
|
+
// If above spot, it's the reverse perspective.
|
|
225
|
+
const isBelow = crossing.price < spot;
|
|
226
|
+
let transitionType;
|
|
227
|
+
if (crossing.direction === 'falling') {
|
|
228
|
+
// Impulse goes + → -
|
|
229
|
+
transitionType = isBelow ? 'stable-to-unstable' : 'unstable-to-stable';
|
|
230
|
+
}
|
|
231
|
+
else {
|
|
232
|
+
// Impulse goes - → +
|
|
233
|
+
transitionType = isBelow ? 'unstable-to-stable' : 'stable-to-unstable';
|
|
234
|
+
}
|
|
235
|
+
return {
|
|
236
|
+
price: crossing.price,
|
|
237
|
+
transitionType,
|
|
238
|
+
};
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
function sanitize(value) {
|
|
242
|
+
return isFinite(value) && !isNaN(value) ? value : 0;
|
|
243
|
+
}
|
package/dist/index.d.ts
CHANGED
|
@@ -14,8 +14,8 @@ export { buildOCCSymbol, parseOCCSymbol, generateStrikesAroundSpot, generateOCCS
|
|
|
14
14
|
export type { OCCSymbolParams, ParsedOCCSymbol, StrikeGenerationParams, } from './utils/occ';
|
|
15
15
|
export { estimateImpliedProbabilityDistribution, estimateImpliedProbabilityDistributions, getProbabilityInRange, getCumulativeProbability, getQuantile, estimateExposureAdjustedPDF, getEdgeAtPrice, getSignificantAdjustmentLevels, DEFAULT_ADJUSTMENT_CONFIG, LOW_VOL_CONFIG, CRISIS_CONFIG, OPEX_CONFIG, } from './impliedpdf';
|
|
16
16
|
export type { StrikeProbability, ImpliedProbabilityDistribution, ImpliedPDFResult, ExposureAdjustmentConfig, AdjustedPDFResult, PDFComparison, } from './impliedpdf';
|
|
17
|
-
export { deriveRegimeParams, interpolateIVAtStrike, computeHedgeImpulseCurve, computeCharmIntegral, analyzeHedgeFlow, } from './hedgeflow';
|
|
18
|
-
export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, } from './hedgeflow';
|
|
17
|
+
export { deriveRegimeParams, interpolateIVAtStrike, computeHedgeImpulseCurve, computeCharmIntegral, computePressureCloud, analyzeHedgeFlow, } from './hedgeflow';
|
|
18
|
+
export type { MarketRegime, RegimeParams, HedgeImpulseConfig, HedgeImpulsePoint, HedgeImpulseCurve, ZeroCrossing, ImpulseExtremum, DirectionalAsymmetry, ImpulseRegime, CharmIntegralConfig, CharmBucket, CharmIntegral, HedgeFlowAnalysis, HedgeContractEstimates, PressureZone, RegimeEdge, PressureLevel, PressureCloudConfig, PressureCloud, } from './hedgeflow';
|
|
19
19
|
export { FloeClient, Broker } from './client/FloeClient';
|
|
20
20
|
export { TradierClient } from './client/brokers/TradierClient';
|
|
21
21
|
export { TastyTradeClient } from './client/brokers/TastyTradeClient';
|
package/dist/index.js
CHANGED
|
@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
20
20
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
21
21
|
};
|
|
22
22
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
23
|
-
exports.computeRealizedVolatility = exports.computeImpliedVolatility = exports.computeVarianceSwapIV = exports.createOptionChain = exports.getAdapter = exports.brokerAdapters = exports.tdaAdapter = exports.ibkrAdapter = exports.schwabAdapter = exports.genericAdapter = exports.TradeStationClient = exports.TastyTradeClient = exports.TradierClient = exports.Broker = exports.FloeClient = exports.analyzeHedgeFlow = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = exports.OPEX_CONFIG = exports.CRISIS_CONFIG = exports.LOW_VOL_CONFIG = exports.DEFAULT_ADJUSTMENT_CONFIG = exports.getSignificantAdjustmentLevels = exports.getEdgeAtPrice = exports.estimateExposureAdjustedPDF = exports.getQuantile = exports.getCumulativeProbability = exports.getProbabilityInRange = exports.estimateImpliedProbabilityDistributions = exports.estimateImpliedProbabilityDistribution = exports.generateOCCSymbolsAroundSpot = exports.generateOCCSymbolsForStrikes = exports.generateStrikesAroundSpot = exports.parseOCCSymbol = exports.buildOCCSymbol = exports.normalPDF = exports.cumulativeNormalDistribution = exports.calculateSharesNeededToCover = exports.calculateGammaVannaCharmExposures = exports.smoothTotalVarianceSmile = exports.getIVForStrike = exports.getIVSurfaces = exports.getTimeToExpirationInYears = exports.getMillisecondsToExpiration = exports.calculateImpliedVolatility = exports.calculateGreeks = exports.blackScholes = void 0;
|
|
23
|
+
exports.computeRealizedVolatility = exports.computeImpliedVolatility = exports.computeVarianceSwapIV = exports.createOptionChain = exports.getAdapter = exports.brokerAdapters = exports.tdaAdapter = exports.ibkrAdapter = exports.schwabAdapter = exports.genericAdapter = exports.TradeStationClient = exports.TastyTradeClient = exports.TradierClient = exports.Broker = exports.FloeClient = exports.analyzeHedgeFlow = exports.computePressureCloud = exports.computeCharmIntegral = exports.computeHedgeImpulseCurve = exports.interpolateIVAtStrike = exports.deriveRegimeParams = exports.OPEX_CONFIG = exports.CRISIS_CONFIG = exports.LOW_VOL_CONFIG = exports.DEFAULT_ADJUSTMENT_CONFIG = exports.getSignificantAdjustmentLevels = exports.getEdgeAtPrice = exports.estimateExposureAdjustedPDF = exports.getQuantile = exports.getCumulativeProbability = exports.getProbabilityInRange = exports.estimateImpliedProbabilityDistributions = exports.estimateImpliedProbabilityDistribution = exports.generateOCCSymbolsAroundSpot = exports.generateOCCSymbolsForStrikes = exports.generateStrikesAroundSpot = exports.parseOCCSymbol = exports.buildOCCSymbol = exports.normalPDF = exports.cumulativeNormalDistribution = exports.calculateSharesNeededToCover = exports.calculateGammaVannaCharmExposures = exports.smoothTotalVarianceSmile = exports.getIVForStrike = exports.getIVSurfaces = exports.getTimeToExpirationInYears = exports.getMillisecondsToExpiration = exports.calculateImpliedVolatility = exports.calculateGreeks = exports.blackScholes = void 0;
|
|
24
24
|
// Core types
|
|
25
25
|
__exportStar(require("./types"), exports);
|
|
26
26
|
// Black-Scholes pricing and Greeks
|
|
@@ -67,7 +67,7 @@ Object.defineProperty(exports, "DEFAULT_ADJUSTMENT_CONFIG", { enumerable: true,
|
|
|
67
67
|
Object.defineProperty(exports, "LOW_VOL_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.LOW_VOL_CONFIG; } });
|
|
68
68
|
Object.defineProperty(exports, "CRISIS_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.CRISIS_CONFIG; } });
|
|
69
69
|
Object.defineProperty(exports, "OPEX_CONFIG", { enumerable: true, get: function () { return impliedpdf_1.OPEX_CONFIG; } });
|
|
70
|
-
// Hedge flow analysis (impulse curve, charm integral, regime derivation)
|
|
70
|
+
// Hedge flow analysis (impulse curve, charm integral, regime derivation, pressure cloud)
|
|
71
71
|
var hedgeflow_1 = require("./hedgeflow");
|
|
72
72
|
// Regime derivation from IV surface
|
|
73
73
|
Object.defineProperty(exports, "deriveRegimeParams", { enumerable: true, get: function () { return hedgeflow_1.deriveRegimeParams; } });
|
|
@@ -76,6 +76,8 @@ Object.defineProperty(exports, "interpolateIVAtStrike", { enumerable: true, get:
|
|
|
76
76
|
Object.defineProperty(exports, "computeHedgeImpulseCurve", { enumerable: true, get: function () { return hedgeflow_1.computeHedgeImpulseCurve; } });
|
|
77
77
|
// Charm integral
|
|
78
78
|
Object.defineProperty(exports, "computeCharmIntegral", { enumerable: true, get: function () { return hedgeflow_1.computeCharmIntegral; } });
|
|
79
|
+
// Pressure cloud (stability/acceleration zones)
|
|
80
|
+
Object.defineProperty(exports, "computePressureCloud", { enumerable: true, get: function () { return hedgeflow_1.computePressureCloud; } });
|
|
79
81
|
// Combined analysis
|
|
80
82
|
Object.defineProperty(exports, "analyzeHedgeFlow", { enumerable: true, get: function () { return hedgeflow_1.analyzeHedgeFlow; } });
|
|
81
83
|
// Client
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fullstackcraftllc/floe",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.17",
|
|
4
4
|
"description": "Production-ready options analytics toolkit. Normalize broker data structures and calculate Black-Scholes, Greeks, and exposures with a clean, type-safe API. Built for trading platforms and fintech applications.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -8,7 +8,9 @@
|
|
|
8
8
|
"build": "tsc",
|
|
9
9
|
"test": "jest",
|
|
10
10
|
"prepublishOnly": "npm run build",
|
|
11
|
-
"type-check": "tsc --noEmit"
|
|
11
|
+
"type-check": "tsc --noEmit",
|
|
12
|
+
"prepare": "husky",
|
|
13
|
+
"copy-whitepaper": "cp whitepaper/whitepaper.pdf site/public/whitepaper.pdf"
|
|
12
14
|
},
|
|
13
15
|
"keywords": [
|
|
14
16
|
"options",
|
|
@@ -42,6 +44,7 @@
|
|
|
42
44
|
"@types/jest": "^29.5.0",
|
|
43
45
|
"@types/node": "^20.0.0",
|
|
44
46
|
"dotenv": "^17.2.3",
|
|
47
|
+
"husky": "^9.1.7",
|
|
45
48
|
"jest": "^29.5.0",
|
|
46
49
|
"ts-jest": "^29.1.0",
|
|
47
50
|
"typescript": "^5.9.3"
|