Fincore API documentation

Build a valuation request in minutes.

Fincore is a REST API that turns financial assumptions into structured valuation calculations. Every endpoint returns JSON and uses standard HTTP authentication.

Base URLhttps://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live

Authentication

Send the API key as a Bearer token in the Authorization header. Do not expose the key in public frontend code.

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/tenBagger?ticker=NVDA&years=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Errors

Check the HTTP status before using the response. Invalid or missing input returns an error rather than a valuation.

200Calculation completed

400Missing or invalid parameter

401 / 403Missing, invalid or exhausted API key

5xxTemporary service error

GET/priceToEarnings

P/E analysis

Calculates current P/E, forward P/E, expected EPS growth and PEG from the values you provide.

ParameterTypeRequiredDescription

tickerstringYesStock ticker used as the response label

epsnumberYesCurrent earnings per share

futureEpsnumberYesExpected earnings per share

stockPricenumberYesCurrent share price

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/priceToEarnings?ticker=SPOT&eps=12.90&futureEps=15.74&stockPrice=497" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/futurePrice

Future price

Projects EPS over a chosen period and applies a future P/E multiple to estimate a future share price.

ParameterTypeRequiredDescription

tickerstringYesStock ticker used as the response label

epsnumberYesStarting earnings per share

growthnumberYesExpected annual EPS growth in percent

yearsnumberYesProjection period in years

futurePEnumberYesP/E multiple applied in the final year

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/futurePrice?ticker=META&eps=32&growth=15&years=5&futurePE=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/ruleOf40

Rule of 40

Adds revenue growth and free cash flow margin to evaluate the balance between growth and cash generation.

ParameterTypeRequiredDescription

tickerstringYesCompany ticker used as the response label

revenueGrowthnumberYesRevenue growth in percent

fcfMarginnumberYesFree cash flow margin in percent

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/ruleOf40?ticker=CRWD&revenueGrowth=28&fcfMargin=15" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "ticker": "CRWD",
  "revenueGrowth": 28,
  "fcfMargin": 15,
  "ruleOf40Score": 43,
  "assessment": "Strong"
}

GET/fairValueRange

Fair value range

Applies bear, base and bull P/E assumptions to expected future EPS.

ParameterTypeRequiredDescription

tickerstringYesStock ticker used as the response label

futureEpsnumberYesExpected future earnings per share

lowPEnumberYesBear-case P/E multiple

basePEnumberYesBase-case P/E multiple

highPEnumberYesBull-case P/E multiple

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/fairValueRange?ticker=META&futureEps=45&lowPE=18&basePE=24&highPE=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "ticker": "META",
  "futureEps": 45,
  "lowPE": 18,
  "basePE": 24,
  "highPE": 30,
  "bearCasePrice": 810,
  "baseCasePrice": 1080,
  "bullCasePrice": 1350,
  "fairValueRange": "810 - 1350"
}

GET/tenBagger

Ten bagger

Calculates the annual return required for an investment to increase tenfold over a chosen horizon.

ParameterTypeRequiredDescription

tickerstringYesStock ticker used as the response label

yearsnumberYesInvestment horizon in years

curl "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/tenBagger?ticker=NVDA&years=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "ticker": "NVDA",
  "years": 10,
  "targetMultiple": 10,
  "requiredAnnualReturnPercent": 25.89,
  "assessment": "Very high growth required"
}

Excel Power Query

Create a blank query in Excel and open Advanced Editor. Replace YOUR_API_KEY and the assumptions below.

let
  Url = "https://vgd7fxh1sj.execute-api.eu-north-1.amazonaws.com/live/fairValueRange?ticker=META&futureEps=45&lowPE=18&basePE=24&highPE=30",
  Source = Json.Document(
    Web.Contents(Url, [Headers=[Authorization="Bearer YOUR_API_KEY"]])
  )
in
  Source

Keep keys private.Do not publish a workbook containing an active API key.