How do I read the Gap Index?
Use GET /api/v1/gap-index. It returns GapIndexDto.
curl https://api.squeeze.plus/api/v1/gap-index| Field | Type | Meaning |
|---|---|---|
ts | number | Reading time, Unix seconds |
value | number or null | Depth-weighted mean gap size, percent |
meanSigned | number or null | Same, with the sign kept |
countComparable | number | Stocks in the reading |
countAbove, countBelow | number | Stocks above or below base |
depthUsd | number or null | Total weight, USD |
freshPairs24h | number | Meme pairs made in 24 hours |
pairsTotal | number | All stock pairs ever found |
widest | object or null | symbol, gapPct, depthUsd |
methodologyVersion | number | Method version, 1 today |
dataStatus | object | state and notes |
dataStatus.state is old when the reading is over 60 seconds old.
Use GET /api/v1/gap-index/history?range=24h for history. It returns GapIndexPointDto[]. range can be 1h, 6h, 24h, or 7d. At most 600 points come back. Each point has ts, value, meanSigned, and countComparable.
Sample
Section titled “Sample”value: null with countComparable: 0 means no stock was usable. Do not draw it as zero.