Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Instrument Data

Get Instrument Income Statements

client.V1.InstrumentData.GetInstrumentIncomeStatements(ctx, instrumentID, query) (*V1InstrumentDataGetInstrumentIncomeStatementsResponse, error)
GET/v1/instruments/{instrument_id}/income-statements

Retrieves quarterly income statements for a specific instrument, sorted by fiscal period (most recent first).

Date range defaults:

  • from_date: None (no lower bound)
  • to_date: None (no upper bound)
ParametersExpand Collapse

OEMS instrument UUID

formatuuid
query V1InstrumentDataGetInstrumentIncomeStatementsParams
FromDate param.Field[string]Optional

The start date for the query range, inclusive (YYYY-MM-DD).

PageSize param.Field[int64]Optional

The number of items to return per page. Only used when page_token is not provided.

formatint64
maximum1000
minimum1
PageToken param.Field[string]Optional

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

formatbyte
ToDate param.Field[string]Optional

The end date for the query range, inclusive (YYYY-MM-DD).

ReturnsExpand Collapse
type V1InstrumentDataGetInstrumentIncomeStatementsResponse struct{…}
AcceptedDate Time

The date and time when the filing was accepted by the SEC

formatdate-time
FilingDate Time

The date the financial statement was filed

formatdate
Period string

The fiscal period identifier (e.g., “Q1”, “Q2”, “Q3”, “Q4”)

PeriodType FiscalPeriodType

The type of fiscal period

One of the following:
const FiscalPeriodTypeQuarterly FiscalPeriodType = "QUARTERLY"
const FiscalPeriodTypeAnnual FiscalPeriodType = "ANNUAL"
const FiscalPeriodTypeTtm FiscalPeriodType = "TTM"
const FiscalPeriodTypeBiannual FiscalPeriodType = "BIANNUAL"
ReportedCurrency string

The currency in which the statement is reported (ISO 4217)

Year int64

The fiscal year of the statement

formatint32
BottomLineNetIncome stringOptional

Bottom line net income after all adjustments

CostAndExpenses stringOptional

Total costs and expenses

CostOfRevenue stringOptional

Direct costs attributable to producing goods sold

DepreciationAndAmortization stringOptional

Depreciation and amortization expenses

Ebit stringOptional

Earnings before interest and taxes

Ebitda stringOptional

Earnings before interest, taxes, depreciation, and amortization

Eps stringOptional

Basic earnings per share

EpsDiluted stringOptional

Diluted earnings per share

GeneralAndAdministrativeExpenses stringOptional

General administrative overhead expenses

GrossProfit stringOptional

Revenue minus cost of revenue

IncomeBeforeTax stringOptional

Income before income tax expense

IncomeTaxExpense stringOptional

Income tax expense for the period

InterestExpense stringOptional

Interest paid on debt

InterestIncome stringOptional

Interest earned on investments and cash

NetIncome stringOptional

Total net income for the period

NetIncomeDeductions stringOptional

Deductions from net income

NetIncomeFromContinuingOperations stringOptional

Net income from continuing operations

NetIncomeFromDiscontinuedOperations stringOptional

Net income from discontinued operations

NetInterestIncome stringOptional

Net interest income (interest income minus interest expense)

NonOperatingIncomeExcludingInterest stringOptional

Non-operating income excluding interest

OperatingExpenses stringOptional

Total operating expenses

OperatingIncome stringOptional

Income from core business operations

OtherAdjustmentsToNetIncome stringOptional

Other adjustments to net income

OtherExpenses stringOptional

Other miscellaneous expenses

ResearchAndDevelopmentExpenses stringOptional

Expenditure on research and development activities

Revenue stringOptional

Total revenue from sales of goods and services

SellingAndMarketingExpenses stringOptional

Expenditure on marketing and sales activities

SellingGeneralAndAdministrativeExpenses stringOptional

Combined selling, general, and administrative expenses

TotalOtherIncomeExpensesNet stringOptional

Net of other income and expenses

WeightedAverageShsOut stringOptional

Weighted average shares outstanding (basic)

WeightedAverageShsOutDil stringOptional

Weighted average shares outstanding (diluted)

Get Instrument Income Statements

package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.InstrumentData.GetInstrumentIncomeStatements(
    context.TODO(),
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    clearstreet.V1InstrumentDataGetInstrumentIncomeStatementsParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}

{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "cost_of_revenue": "52080000000",
      "eps": "1.40",
      "eps_diluted": "1.38",
      "filing_date": "2025-05-01",
      "gross_profit": "42850000000",
      "net_income": "22200000000",
      "operating_income": "26550000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "reported_currency": "USD",
      "revenue": "94930000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "total_items": 20,
    "total_pages": 2
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}
Returns Examples
{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "cost_of_revenue": "52080000000",
      "eps": "1.40",
      "eps_diluted": "1.38",
      "filing_date": "2025-05-01",
      "gross_profit": "42850000000",
      "net_income": "22200000000",
      "operating_income": "26550000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "reported_currency": "USD",
      "revenue": "94930000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "total_items": 20,
    "total_pages": 2
  }
}
{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAP"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}