Consensus History Query

GET 
/v1/basic/consensus/measure/:ticker

Retrieves the consensus history for the stock corresponding to the ticker.

Request

Path Parameters

ticker stringrequired

stock code

Query Parameters

page int32

page number

size int32

Page Size

sort string

Possible values: [ASC, DESC]

Default value: ASC

Sorting criterion (ASC or DESC)

Header Parameters

Accept-Country stringrequired

Default value: KR

Country Code (KR or US)

Accept-Currency string

Default value: KRW

Currency Code (KRW or USD)

Accept-Language string

Default value: EN

Language Code (KO or EN)

Responses

200

Success

application/json

Schema

Schema

data

object[]

Array [

ticker string

Stock code

countryCode string

Country code

consensusItemCode string

Consensus code

consensusItemName string

Consensus name

reportingBasis string

Accounting Standards

valueType string

Value Classification

valueScale integer

Value Scale

valueUnit string

Value Unit

valueCurrencyCode string

Currency Value

section string

Report Type

relativePeriodType string

Relative Period Type (interim/annual)

relativePeriodNumber integer

Relative Period Value

fiscalPeriodYear integer

Fiscal Year

fiscalPeriodType string

Fiscal Period Type

calendarYear integer

Calendar Year

calendarMonth integer

Calendar Month

actualReportDate date-time

Disclosure Base Date

actualCurrencyCode string

Disclosure Base Currency Code

actualReported double

Disclosure Base Value

actualReportedAdj double

Disclosure standard value (with adjustment factor considered)

actualRestated double

Disclosure corrected value

actualRestatedAdj double

Disclosure corrected value (with adjustment factor considered)

actualRestatedDate date-time

Actual Restated Date

actualSurprisePercent double

Actual Values Over/Under Percentage

actualSurpriseMean double

Average Exceeding/Falling Below Actual Values

actualSurpriseMeanAdj double

Actual Value Exceeding/Falling Below (with Adjustment Factor)

actualStandardizedUnexpectedEarnings double

Standardized Exceeding/Falling Below Value

actualStandardizedUnexpectedEarningsAdj double

Standardized Exceed/Deficit Values (Adjustment Factor Considered)

actualNumberOfEstimates integer

Number of institutions providing estimates (as of the date of announcement)

estimateCurrencyCode string

Estimate Currency Code

estimateMean double

average value of estimates

estimateMeanAdj double

average value of estimates (adjusted for correction factor)

estimateHigh double

Maximum estimate

estimateHighAdj double

Maximum estimate (adjusted)

estimateLow double

Minimum estimate

estimateLowAdj double

Estimated minimum value (adjustment factor applied)

estimateNumberOfEstimates integer

Number of estimating institutions

estimateMedian double

Estimated median value

estimateMedianAdj double

Estimated median value (with adjustment factor)

estimateStandardDeviation double

Estimated standard deviation

estimateStandardDeviationAdj double

Estimated Standard Deviation (Adjusted Coefficient)

estimateRevisionStatisticsList string

Estimate Revision Statistics

estimateRevisionCluster string

Estimate Revision Statistical Information

estimatePredictedSurpriseValue double

Average compared to smart estimate

estimatePredictedSurpriseValueAdj double

Average compared to smart estimate (with adjustment factor)

estimatePredictedSurpriseUnit string

Unit of deviation from smart estimate

estimatePredictedSurpriseIsSignificant boolean

Relevance of Over/Under Achievement Compared to Smart Estimate

estimateSmartEstimate double

Smart Estimate

estimateSmartEstimateAdj double

Smart Estimate (Adjustment Factor Applied)

estimateSnapshots string

Estimate Snapshot Information

]

page integer

Default value: 0

Page number (default: 0)

size integer

Default value: 5

Page size (default: 5)

totalPage integer

Default value: 0

Total number of pages

totalCount integer

Default value: 0

Total number of items

code string

Response code

status integer

Response status code

message string

Response message

timestamp string

Response timestamp

Example (from schema)

{
  "data": [
    {
      "ticker": "string",
      "countryCode": "string",
      "consensusItemCode": "string",
      "consensusItemName": "string",
      "reportingBasis": "string",
      "valueType": "string",
      "valueScale": 0,
      "valueUnit": "string",
      "valueCurrencyCode": "string",
      "section": "string",
      "relativePeriodType": "string",
      "relativePeriodNumber": 0,
      "fiscalPeriodYear": 0,
      "fiscalPeriodType": "string",
      "calendarYear": 0,
      "calendarMonth": 0,
      "actualReportDate": "2024-07-29T15:51:28.071Z",
      "actualCurrencyCode": "string",
      "actualReported": 0,
      "actualReportedAdj": 0,
      "actualRestated": 0,
      "actualRestatedAdj": 0,
      "actualRestatedDate": "2024-07-29T15:51:28.071Z",
      "actualSurprisePercent": 0,
      "actualSurpriseMean": 0,
      "actualSurpriseMeanAdj": 0,
      "actualStandardizedUnexpectedEarnings": 0,
      "actualStandardizedUnexpectedEarningsAdj": 0,
      "actualNumberOfEstimates": 0,
      "estimateCurrencyCode": "string",
      "estimateMean": 0,
      "estimateMeanAdj": 0,
      "estimateHigh": 0,
      "estimateHighAdj": 0,
      "estimateLow": 0,
      "estimateLowAdj": 0,
      "estimateNumberOfEstimates": 0,
      "estimateMedian": 0,
      "estimateMedianAdj": 0,
      "estimateStandardDeviation": 0,
      "estimateStandardDeviationAdj": 0,
      "estimateRevisionStatisticsList": "string",
      "estimateRevisionCluster": "string",
      "estimatePredictedSurpriseValue": 0,
      "estimatePredictedSurpriseValueAdj": 0,
      "estimatePredictedSurpriseUnit": "string",
      "estimatePredictedSurpriseIsSignificant": true,
      "estimateSmartEstimate": 0,
      "estimateSmartEstimateAdj": 0,
      "estimateSnapshots": "string"
    }
  ],
  "page": 0,
  "size": 5,
  "totalPage": 0,
  "totalCount": 0,
  "code": "string",
  "status": 0,
  "message": "string",
  "timestamp": "string"
}

Loading...