REST API
API Reference
RESTful API over HTTPS with JSON responses. Simple authentication, predictable URLs, and comprehensive data coverage.
Overview
- Base URL:
https://api.datawiser.ai - Authentication: Bearer token in the Authorization header
- Response format: JSON with consistent error handling
- Available via python (details)
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/free-float-events/{ticker} | Retrieve event-level changes in excluded shares and free float, with component ownership breakdowns. |
| GET | /v1/free-float/{ticker} | Retrieve free float snapshots and current factor for one or more tickers, including filing and document timestamps. |
| GET | /v1/shares-outstanding/{ticker} | Retrieve shares outstanding history for a given ticker, with filing and document timing metadata. |
| GET | /v1/reference/{ticker} | Get reference data for a given ticker. |
GET
/v1/free-float-events/{ticker}
Returns event-level changes in excluded shares and free-float attribution for a given ticker. See the methodology for details: Free Float Events Methodology.
Request
curl -X GET "https://api.datawiser.ai/v1/free-float-events/OLP" \-H "Authorization: Bearer YOUR_API_KEY"
Response (Example 1 – Multi-vehicle Ownership Structure)
{"ticker": "OLP","securityId": "OLPzCBoCCmy","events": [{"securityId": "OLPzCBoCCmy","asOf": "2026-01-14","sharesOut": 21600032,"ffFactor": 0.725915,"excludedShares": 5920253.0759,"deltaShares": 135193.4589,"deltaFfFactor": -0.006259,"isRebalanced": false,"components": {"OLPzCIGfrh44P": {"asOf": "2026-01-14","ownerIdentityId": "OLPzCIGfrh44P","name": "GOULD JEFFREY","shares": 2692196.757,"eventMask": 224,"entityType": "individual","deltaShares": 11600,"relType": "direct","isOfficer": true,"components": [{"eventMask": 224,"relType": "direct","shares": 390678.154,"deltaShares": 11600,"isParentEvent": true,"entity": "primary_event","reconciled": true,"isCrossHolding": false},{"eventMask": 1248,"relType": "llc","shares": 144,"deltaShares": 0,"natureOfOwnership": "By Georgetown Partners LLC","reconciled": true,"isCrossHolding": true},{"eventMask": 3296,"relType": "affiliate_subsidiary","shares": 13622,"deltaShares": 0,"natureOfOwnership": "By 130 Store Company","reconciled": true,"isCrossHolding": true},{"eventMask": 274656,"relType": "foundation","shares": 15151.747,"deltaShares": 0,"natureOfOwnership": "By Gould Shenfeld Family Foundation","reconciled": true,"isCrossHolding": true},{"eventMask": 3296,"relType": "affiliate_subsidiary","shares": 2272600.856,"deltaShares": 0,"natureOfOwnership": "By Gould Investors L.P.","reconciled": true,"isCrossHolding": true}],"restrictions": [{"eventMask": 128,"relType": "direct","shares": 11600,"deltaShares": 0,"reconciled": true,"reason": ["shares: These shares were issued as restricted stock on January 14, 2026 under the issuer's 2025 Incentive Plan. Generally, subject to the reporting person's continued relationship with the issuer, the shares vest on or about January 13, 2031."],"includedInTotal": true,"restrictionType": "restricted_stock"}],"options": []}}}]}
Example 2 – Delta Attribution & Restrictions
{"ticker": "OLP","securityId": "OLPzCBoCCmy","events": [{"securityId": "OLPzCBoCCmy","asOf": "2026-01-14","sharesOut": 21600032,"ffFactor": 0.725915,"excludedShares": 5920253.0759,"deltaShares": 135193.4589,"deltaFfFactor": -0.006259,"isRebalanced": false,"delta": {"diff": {"OLPzC085ekEKV": 3499.5849,"OLPzCIGfrh44P": 11600},"src": {"OLPzC085ekEKV": "proxystatement|2025-04-15|OLP8cIGUVTZ|OLP8cIGUVTZ->form4|2026-01-16|712770/0001214659-26-000578|OLP8c5NSMb6","OLPzCIGfrh44P": "form4|2025-08-07|712770/0001214659-25-011703|OLP8ck_P8mt->form4|2026-01-16|712770/0001214659-26-000571|OLP8ciP7qZ3"}},"components": {"OLPzC085ekEKV": {"asOf": "2026-01-14","ownerIdentityId": "OLPzC085ekEKV","name": "Lovejoy Jesse Robert","shares": 111585.5849,"eventMask": 224,"entityType": "individual","deltaShares": 3500,"relType": "direct","isOfficer": false,"components": [{"eventMask": 224,"relType": "direct","shares": 98449,"deltaShares": 3500,"id": "OLPzC085ekEKV-c0-OLPzCxBrlftfK","eventId": "OLPzCxBrlftfK","isParentEvent": true,"reconciled": true,"isCrossHolding": false},{"eventMask": 262368,"relType": "spouse_family","shares": 13136.5849,"deltaShares": 0,"natureOfOwnership": "By spouse","reconciled": true,"isBenOwnerExclusion": true,"isCrossHolding": false}],"restrictions": [{"eventMask": 128,"relType": "direct","shares": 3500,"deltaShares": 0,"sourceEvent": "form4|2026-01-16|712770/0001214659-26-000578|OLP8c5NSMb6","reconciled": true,"reason": ["shares: These shares were issued as restricted stock on January 14, 2026 under the issuer's 2025 Incentive Plan. Generally, subject to the reporting person's continued relationship with the issuer, the shares vest on or about January 13, 2031."],"includedInTotal": true,"restrictionType": "restricted_stock"}],"options": []}}}]}
GET
/v1/reference/{ticker}
Returns enhanced reference data for a given ticker.
Request
curl -X GET "https://api.datawiser.ai/v1/reference?tickers=GOOG,GOOGL" \-H "Authorization: Bearer YOUR_API_KEY"
Response
[{"identifiers": {"figi": "BBG009S4MVF2","tkr": "GOOG","cik": "1652044","ccy": "USD","mic": "XNGS","lei": "5493006MHB84DD0ZWV18","tickerMic": "GOOG.XNGS","tickerCountry": "GOOG.US","securityType": "Ordinary Shares","nameFigi": "ALPHABET INC-CL C","securityTypeFigi": "Common Stock","securityType2Figi": "Common Stock"},"dwIds": {"companyId": "GOOGLtFz6u__j","securityId": "GOOGLzWj4Jw","listingId": "GOOGLP6xCunn"},"enhanced": {"primaryTicker": "GOOG","isPrimary": true,"economicSector": "57","businessSector": "5720","industrySector": "572010"},"securityInfo": {"normalizedSecType": "Common Stock","name": "Alphabet Inc. Class C Capital Stock, $0.001 par value","exchangeName": "NASDAQ","ticker": "GOOG","Security12bTitle": "Class C Capital Stock, $0.001 par value","securityClass": "Class C"},"companyInfo": {"address": "1600 Amphitheatre Parkway","city": "Mountain View","zip": "94043","tin": "61-1767919","name": "Alphabet Inc.","phoneNumber": "253-0000"}},{"identifiers": {"figi": "BBG009S4MT03","tkr": "GOOGL","cik": "1652044","ccy": "USD","mic": "XNGS","lei": "5493006MHB84DD0ZWV18","tickerMic": "GOOGL.XNGS","tickerCountry": "GOOGL.US","securityType": "Ordinary Shares","nameFigi": "ALPHABET INC-CL A","securityTypeFigi": "Common Stock","securityType2Figi": "Common Stock"},"dwIds": {"companyId": "GOOGLftHv3uMg","securityId": "GOOGLLEDOJy","listingId": "GOOGLMNnHgCq"},"enhanced": {"primaryTicker": "GOOGL","isPrimary": true,"economicSector": "57","businessSector": "5720","industrySector": "572010"},"securityInfo": {"normalizedSecType": "Common Stock","name": "Alphabet Inc. Class A Common Stock, $0.001 par value","exchangeName": "NASDAQ","ticker": "GOOGL","Security12bTitle": "Class A Common Stock, $0.001 par value","securityClass": "Class A"},"companyInfo": {"address": "1600 Amphitheatre Parkway","city": "Mountain View","zip": "94043","tin": "61-1767919","name": "Alphabet Inc.","phoneNumber": "253-0000"}}]
GET
/v1/shares-outstanding/{ticker}
Returns historical shares outstanding for a given ticker symbol, along with the filing date and processing timestamps used to derive each observation.
Request
curl -X GET "https://api.datawiser.ai/v1/shares-outstanding/OLP" \-H "Authorization: Bearer YOUR_API_KEY"
Response
{"ticker": "OLP","securityId": "OLPzCBoCCmy","events": [{"lastUpdate": "2025-12-09T01:59:18.660443+08:00","shareType": "latest_practicable_outstanding","shares": 21600032,"asOf": "2025-08-01","source": "10-q","secType": "Common Stock"},{"lastUpdate": "2025-12-09T01:59:02.292982+08:00","shareType": "latest_practicable_outstanding","shares": 21594327,"asOf": "2025-05-01","source": "10-q","secType": "Common Stock"},{"lastUpdate": "2025-12-09T01:58:51.180378+08:00","shareType": "latest_practicable_outstanding","shares": 21586978,"asOf": "2025-02-28","source": "10-k","secType": "Common Stock"}]}
GET
/v1/free-float/{ticker}
Returns the current free float factor and historical snapshots for a given ticker symbol, including filing and document timing metadata for each point. Supports comma‑delimited multi‑ticker queries using the tickers parameter.
Request
curl -X GET "https://api.datawiser.ai/v1/free-float/OLP" \-H "Authorization: Bearer YOUR_API_KEY"
Response
{"ticker": "OLP","securityId": "OLPzCBoCCmy","events": [{"asOf": "2026-01-14","freeFloatFactor": 0.725915,"freeFloatPct": 72.5915,"sharesOutstanding": 21600032,"excludedShares": 5920253.0759},{"asOf": "2025-09-09","freeFloatFactor": 0.732174,"freeFloatPct": 73.2174,"sharesOutstanding": 21600032,"excludedShares": 5785059.617},{"asOf": "2025-09-05","freeFloatFactor": 0.731989,"freeFloatPct": 73.1989,"sharesOutstanding": 21600032,"excludedShares": 5789055.617}]}
Log in to view the interactive API dashboard. The dashboard is available to all users, including free accounts, once an API key is created.
