GET
/stocks/financials/v1/float
Float
Retrieve float data (shares available for trading) for public companies.
Endpoint Details
| HTTP Method | GET |
|---|---|
| Path | /stocks/financials/v1/float |
| Version | stocks/financials/v1 |
| Minimum Plan | free |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key |
string | Required | Your API key for authentication |
cik |
string | Optional | Company Central Index Key (CIK) |
tickers |
string | Optional | Filter by ticker symbol |
period_end |
string | Optional | Period end date (YYYY-MM-DD) |
filing_date |
string | Optional | Filing date (YYYY-MM-DD) |
fiscal_year |
number | Optional | Fiscal year |
fiscal_quarter |
number | Optional | Fiscal quarter (1-4) |
timeframe |
string | Optional | Reporting period type (quarterly, annual, trailing_twelve_months) |
limit |
integer | Optional | Maximum number of results (default: 100, max: 50000) |
sort |
string | Optional | Sort columns with direction (e.g., period_end.desc) |
Example Request
curl "https://mail.tradeiqai.com/api/stocks/financials/v1/float?api_key=YOUR_API_KEY"
Note: Replace YOUR_API_KEY with your actual API key.
Response Attributes
| Attribute | Type | Description |
|---|---|---|
ok | boolean | Indicates if the request was successful (e.g., 1) |
data | object | Response data object |
data.status | string | Response status (typically "OK") (e.g., OK) |
data.results | object|array | Empty array |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": null,
"results": [],
"next_url": null
}
}