sentisense 0.66.0 → 0.67.0
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/README.md +14 -0
- package/dist/cli.cjs +20 -2
- package/dist/index.cjs +20 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.mts +167 -6
- package/dist/index.d.ts +167 -6
- package/dist/index.mjs +20 -2
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -304,9 +304,23 @@ for (const update of detail.timeline) {
|
|
|
304
304
|
client.institutional.getQuarters()
|
|
305
305
|
client.institutional.getFlows("2025-02-14", { limit: 20 })
|
|
306
306
|
client.institutional.getHolders("AAPL", "2025-02-14")
|
|
307
|
+
client.institutional.getHolders("AAPL") // no date: the ticker's latest settled quarter
|
|
307
308
|
client.institutional.getActivists("2025-02-14")
|
|
308
309
|
```
|
|
309
310
|
|
|
311
|
+
**Pick a filed quarter by its flag.** `getQuarters()` is newest first, and its first entry is usually still filing. Each `Quarter` carries `pending`, `ownershipEligible` and `ownershipEligibleAt`, so select on the flag rather than by position:
|
|
312
|
+
|
|
313
|
+
```typescript
|
|
314
|
+
const quarters = await client.institutional.getQuarters();
|
|
315
|
+
const latest = quarters.find((q) => !q.pending)?.reportDate;
|
|
316
|
+
if (latest) {
|
|
317
|
+
const holders = await client.institutional.getHolders("AAPL", latest, { limit: 25 });
|
|
318
|
+
console.log(holders.data.selection?.status, holders.data.earlyFilers?.reportDate);
|
|
319
|
+
}
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
The holders payload also says how its quarter was chosen (`selection`), reports a newer still-filing quarter separately (`earlyFilersStatus`, `earlyFilers`), lists well-known institutions matched against the full roster (`notableHolders`), and summarizes the quarter-over-quarter comparison (`comparisonReportDate`, `comparisonStatus`). Each holder row carries its own `comparisonStatus`; only `AVAILABLE` on that row supports its change figures.
|
|
323
|
+
|
|
310
324
|
`positionsHeld` on an institution detail counts the full portfolio's held positions:
|
|
311
325
|
`max(0, holdingsCount - soldOutPositions)`, even when the holdings list is truncated.
|
|
312
326
|
`getInstitutionDetail` keeps its `Promise<unknown>` signature. The exported all-optional
|
package/dist/cli.cjs
CHANGED
|
@@ -1409,7 +1409,7 @@ var flowsCommand = {
|
|
|
1409
1409
|
};
|
|
1410
1410
|
|
|
1411
1411
|
// src/version.ts
|
|
1412
|
-
var VERSION = "0.
|
|
1412
|
+
var VERSION = "0.67.0";
|
|
1413
1413
|
|
|
1414
1414
|
// src/resources/analyst.ts
|
|
1415
1415
|
var Analyst = class {
|
|
@@ -2071,7 +2071,13 @@ var Institutional = class {
|
|
|
2071
2071
|
constructor(client) {
|
|
2072
2072
|
this.client = client;
|
|
2073
2073
|
}
|
|
2074
|
-
/**
|
|
2074
|
+
/**
|
|
2075
|
+
* Get available 13F reporting quarters, newest first.
|
|
2076
|
+
*
|
|
2077
|
+
* The first entry is usually the quarter that is still filing, so pick by the flag rather
|
|
2078
|
+
* than by position: `quarters.find((q) => !q.pending)?.reportDate`. Each row also carries
|
|
2079
|
+
* `ownershipEligible` and `ownershipEligibleAt`.
|
|
2080
|
+
*/
|
|
2075
2081
|
async getQuarters() {
|
|
2076
2082
|
return this.client.get("/api/v1/institutional/quarters");
|
|
2077
2083
|
}
|
|
@@ -2094,6 +2100,11 @@ var Institutional = class {
|
|
|
2094
2100
|
/**
|
|
2095
2101
|
* Get institutional holders for a specific stock.
|
|
2096
2102
|
*
|
|
2103
|
+
* `reportDate` is optional: omit it (or pass `undefined` ahead of `options`) and the
|
|
2104
|
+
* request carries no date, so the server serves this ticker's latest settled quarter,
|
|
2105
|
+
* echoes it in `data.reportDate` with `data.selection.mode` set to `DEFAULT`, and reports
|
|
2106
|
+
* any newer still-filing quarter separately in `data.earlyFilers`.
|
|
2107
|
+
*
|
|
2097
2108
|
* Returns the preview envelope wrapping a {@link TickerHolders} object, so the rows
|
|
2098
2109
|
* are two levels down: `(await getHolders(t, d)).data.holders`, alongside ticker-level
|
|
2099
2110
|
* totals like `holderCount`. Free callers get a truncated `holders` array with
|
|
@@ -2107,6 +2118,13 @@ var Institutional = class {
|
|
|
2107
2118
|
* `returnedCount`, `offset`, and a `notableChanges` summary, so you can walk the list
|
|
2108
2119
|
* without re-counting it. Without it, `offset` / `sortBy` / `sortDir` are ignored by the
|
|
2109
2120
|
* server and you get the full unsorted list back with a 200.
|
|
2121
|
+
*
|
|
2122
|
+
* The payload also says how its quarter was chosen (`selection`), reports a newer
|
|
2123
|
+
* still-filing quarter separately (`earlyFilersStatus`, `earlyFilers`), lists well-known
|
|
2124
|
+
* institutions matched against the full roster (`notableHolders`), and summarizes the
|
|
2125
|
+
* quarter-over-quarter comparison (`comparisonReportDate`, `comparisonStatus`). Each
|
|
2126
|
+
* holder row has its own `comparisonStatus`; only `AVAILABLE` on that row supports its
|
|
2127
|
+
* change figures.
|
|
2110
2128
|
*/
|
|
2111
2129
|
async getHolders(ticker, reportDate, options) {
|
|
2112
2130
|
return this.client.get(
|
package/dist/index.cjs
CHANGED
|
@@ -742,7 +742,13 @@ var Institutional = class {
|
|
|
742
742
|
constructor(client) {
|
|
743
743
|
this.client = client;
|
|
744
744
|
}
|
|
745
|
-
/**
|
|
745
|
+
/**
|
|
746
|
+
* Get available 13F reporting quarters, newest first.
|
|
747
|
+
*
|
|
748
|
+
* The first entry is usually the quarter that is still filing, so pick by the flag rather
|
|
749
|
+
* than by position: `quarters.find((q) => !q.pending)?.reportDate`. Each row also carries
|
|
750
|
+
* `ownershipEligible` and `ownershipEligibleAt`.
|
|
751
|
+
*/
|
|
746
752
|
async getQuarters() {
|
|
747
753
|
return this.client.get("/api/v1/institutional/quarters");
|
|
748
754
|
}
|
|
@@ -765,6 +771,11 @@ var Institutional = class {
|
|
|
765
771
|
/**
|
|
766
772
|
* Get institutional holders for a specific stock.
|
|
767
773
|
*
|
|
774
|
+
* `reportDate` is optional: omit it (or pass `undefined` ahead of `options`) and the
|
|
775
|
+
* request carries no date, so the server serves this ticker's latest settled quarter,
|
|
776
|
+
* echoes it in `data.reportDate` with `data.selection.mode` set to `DEFAULT`, and reports
|
|
777
|
+
* any newer still-filing quarter separately in `data.earlyFilers`.
|
|
778
|
+
*
|
|
768
779
|
* Returns the preview envelope wrapping a {@link TickerHolders} object, so the rows
|
|
769
780
|
* are two levels down: `(await getHolders(t, d)).data.holders`, alongside ticker-level
|
|
770
781
|
* totals like `holderCount`. Free callers get a truncated `holders` array with
|
|
@@ -778,6 +789,13 @@ var Institutional = class {
|
|
|
778
789
|
* `returnedCount`, `offset`, and a `notableChanges` summary, so you can walk the list
|
|
779
790
|
* without re-counting it. Without it, `offset` / `sortBy` / `sortDir` are ignored by the
|
|
780
791
|
* server and you get the full unsorted list back with a 200.
|
|
792
|
+
*
|
|
793
|
+
* The payload also says how its quarter was chosen (`selection`), reports a newer
|
|
794
|
+
* still-filing quarter separately (`earlyFilersStatus`, `earlyFilers`), lists well-known
|
|
795
|
+
* institutions matched against the full roster (`notableHolders`), and summarizes the
|
|
796
|
+
* quarter-over-quarter comparison (`comparisonReportDate`, `comparisonStatus`). Each
|
|
797
|
+
* holder row has its own `comparisonStatus`; only `AVAILABLE` on that row supports its
|
|
798
|
+
* change figures.
|
|
781
799
|
*/
|
|
782
800
|
async getHolders(ticker, reportDate, options) {
|
|
783
801
|
return this.client.get(
|
|
@@ -1423,7 +1441,7 @@ var Trackers = class {
|
|
|
1423
1441
|
};
|
|
1424
1442
|
|
|
1425
1443
|
// src/version.ts
|
|
1426
|
-
var VERSION = "0.
|
|
1444
|
+
var VERSION = "0.67.0";
|
|
1427
1445
|
|
|
1428
1446
|
// src/client.ts
|
|
1429
1447
|
var DEFAULT_BASE_URL = "https://app.sentisense.ai";
|