Skip to main content
GET
/
api
/
v2.1
/
calendar
/
guidance
가이던스 데이터를 반환합니다.
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/guidance?token=' \
  --header 'accept: <accept>'
{
  "guidance": [
    {
      "confirmed": true,
      "currency": "USD",
      "cusip": 37833100,
      "date": "2024-01-09T00:00:00.000Z",
      "eps_guidance_est": "1.55",
      "eps_guidance_max": "1.60",
      "eps_guidance_min": "1.50",
      "eps_guidance_prior_max": "1.45",
      "eps_guidance_prior_min": "1.35",
      "eps_type": "GAAP",
      "exchange": "NASDAQ",
      "id": "60a7f5e8e4b0f5a3c8e9f5b1",
      "importance": 4,
      "is_primary": "true",
      "name": "Apple Inc.",
      "notes": "Raised guidance above analyst expectations",
      "period": "Q2",
      "period_year": 2024,
      "prelim": "false",
      "revenue_guidance_est": "93000000000",
      "revenue_guidance_max": "95000000000",
      "revenue_guidance_min": "91000000000",
      "revenue_guidance_prior_max": "89000000000",
      "revenue_guidance_prior_min": "87000000000",
      "revenue_type": "GAAP",
      "ticker": "AAPL",
      "time": "16:05:00",
      "updated": 1704819600
    }
  ]
}

Authorizations

token
string
query
required

Headers

accept
enum<string>
default:application/json
required

반환 형식을 지정합니다. 두 형식 모두에서 쿼리 매개변수는 동일하게 작동합니다.

Available options:
application/json

Query Parameters

page
integer
default:0

페이지 오프셋 값입니다. 최적화, 성능 및 기술적인 이유로 페이지 오프셋은 0에서 100000 사이로 제한됩니다. 날짜와 같은 다른 매개변수로 쿼리 결과를 제한하세요.

pagesize
integer

반환되는 결과 수입니다. 최대 1000개입니다.

parameters[date]
string<YYYY-MM-DD>

calendar 데이터를 조회할 날짜입니다. date_from과 date_to가 동일한 경우 이 둘을 대신하는 축약형 파라미터입니다. 지정하지 않으면 최신 날짜가 기본값으로 사용됩니다.

parameters[date_from]
string<YYYY-MM-DD>

조회 기준 시점 날짜

parameters[date_to]
string<YYYY-MM-DD>

조회할 시점을 지정하는 날짜

parameters[importance]
enum<integer>

필터링에 사용할 중요도 수준입니다. 지정한 중요도(이상, Greater Than or Equal To)에 해당하는 항목만 포함됩니다.

Available options:
0,
1,
2,
3,
4,
5
parameters[is_primary]
enum<string>
default:Y

반환되는 guidance가 기본(primary), 보조(secondary) 또는 전체(all) 중 무엇인지 지정합니다. 기본값은 Y입니다.

Available options:
Y,
N,
All
parameters[tickers]
string<csv>

하나 이상의 티커를 콤마로 구분해 입력합니다. 최대 50개까지 가능합니다

parameters[updated]
integer

레코드가 마지막으로 업데이트된 Unix 타임스탬프(UTC)입니다. 이 값을 지정하면 정렬 순서는 지정한 타임스탬프 이상(크거나 같음)으로만 적용됩니다

Response

성공

가이던스 레코드의 배열을 포함하는 API 응답

guidance
object[]