Financial Datasets Guidance

Name: Financial Datasets Guidance
Price: 0.03 USD
Availability: InStock
Author: Financial Datasets

https://api.sandbase.ai/v1/api/financial-datasets/kpi-guidance

Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.

Try this API Get API key

Price: $0.03USD / call
Method: POST
Response: JSON
Parameters: 1 required · 6 optional

Production route

Try the model

Playground

Open playground

Input

Cursor(string)

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Limit(integer)

Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`. Maximum: 50.

Metric Name(string)

Filter to a specific metric.

Period(string)

Filter by period type: quarterly or annual. Allowed values: quarterly, annual.

Report Period Gte(string)

Only return guidance on or after this date (YYYY-MM-DD).

Report Period Lte(string)

Only return guidance on or before this date (YYYY-MM-DD).

Ticker(string)

The ticker symbol.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.03 / run

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

ticker: string · required
cursor: string · optional
limit: integer · optional
metric_name: string · optional
period: string (quarterly, annual) · optional
report_period_gte: string · optional
report_period_lte: string · optional

Access

Provider: Financial Datasets
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/financial-datasets/kpi-guidance
Authentication: Bearer API key

API README

Financial Datasets Guidance API

Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.

The response is the official Financial Datasets API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "financial-datasets/kpi-guidance", "ticker": "<ticker>"}'

Parameters

Name	Type	Required	Description
`cursor`	string	No	Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original reques
`limit`	integer	No	Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`.
`metric_name`	string	No	Filter to a specific metric.
`period`	string	No	Filter by period type: quarterly or annual.
`report_period_gte`	string	No	Only return guidance on or after this date (YYYY-MM-DD).
`report_period_lte`	string	No	Only return guidance on or before this date (YYYY-MM-DD).
`ticker`	string	Yes	The ticker symbol.

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/financial-datasets/kpi-guidance

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/financial-datasets/kpi-guidance" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "limit": 4,
  "period": "quarterly"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Financial Datasets GuidanceThis API `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026
Financial Datasets Get Analyst Estimates `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026
Financial Datasets Get Company Facts `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026
Financial Datasets Get Earnings Data `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026
Financial Datasets Get Company SEC Filings `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026
Financial Datasets Get SEC Filing Items `Financial Datasets`	$0.03 per call	JSON	Oct 30, 2026

Questions

FAQ

How do I use the Financial Datasets Guidance API?

Send a POST request to https://api.sandbase.ai/v1/api/financial-datasets/kpi-guidance with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Financial Datasets Guidance API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Financial Datasets Guidance API accept?

Required: ticker (string). Optional: cursor (string), limit (integer), metric_name (string), period (one of quarterly, annual), report_period_gte (string) and report_period_lte (string). The Parameters table and the Playground on this page list every field.

What does the Financial Datasets Guidance API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Financial Datasets developer account or API key?

No. Financial Datasets Guidance runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Financial Datasets API access separately.