Snapshot

GET

financial-metrics

snapshot

Get a live financial-metrics snapshot

curl --request GET \
  --url https://financialdatasets.rip/financial-metrics/snapshot \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financial-metrics/snapshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financial-metrics/snapshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financial-metrics/snapshot"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financial-metrics/snapshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "snapshot": {
    "ticker": "AAPL",
    "market_cap": 4674544794120,
    "enterprise_value": 4698970959518,
    "price_to_earnings_ratio": 36.26,
    "price_to_book_ratio": 43.48,
    "price_to_sales_ratio": 10.01,
    "enterprise_value_to_ebitda_ratio": 27.98,
    "gross_margin": 0.4865291555900202,
    "operating_margin": 0.3317,
    "net_margin": 0.27618604910212224
  }
}

This route returns a single current snapshot, market cap, P/E, EV/EBITDA, and margins, sourced from Monid’s DefiLlama /equities/v1/summary endpoint. Because this snapshot carries a live price, its valuation fields are populated where Historical leaves them out.

What this answers

What a company’s current market cap and P/E ratio are, right now.

Coverage


Provider chain	DefiLlama `/equities/v1/summary`
Measured cost	$0.0006 per call
Cache TTL	60 seconds, see Caching

Query rules

ticker is required, and it is the only parameter this route accepts. Fields the FinancialMetricSnapshot schema declares but our own live captures never populate: currency, enterprise_value_to_revenue_ratio, free_cash_flow_yield, peg_ratio, return_on_equity, return_on_assets, return_on_invested_capital, asset_turnover, inventory_turnover, receivables_turnover, days_sales_outstanding, operating_cycle, working_capital_turnover, current_ratio, quick_ratio, cash_ratio, operating_cash_flow_ratio, debt_to_equity, debt_to_assets, interest_coverage, revenue_growth, earnings_growth, book_value_growth, earnings_per_share_growth, free_cash_flow_growth, operating_income_growth, ebitda_growth, payout_ratio, earnings_per_share, book_value_per_share, free_cash_flow_per_share. These are schema-legal and left out of the response rather than guessed.

Worked example

curl

curl -s 'https://financialdatasets.rip/financial-metrics/snapshot?ticker=AAPL' \
  -H 'X-API-KEY: <your-api-key>'

Response

{
  "snapshot": {
    "ticker": "AAPL",
    "market_cap": 4674544794120,
    "enterprise_value": 4698970959518,
    "price_to_earnings_ratio": 36.26,
    "price_to_book_ratio": 43.48,
    "price_to_sales_ratio": 10.01,
    "enterprise_value_to_ebitda_ratio": 27.98,
    "gross_margin": 0.4865291555900202,
    "operating_margin": 0.3317,
    "net_margin": 0.27618604910212224
  }
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

required

Uppercase-normalized ticker symbol (1-20 letters/digits/dots/hyphens).

Response

Real AAPL snapshot captured from our own live API (docs/our-live-samples/metrics_snapshot.json).

Snapshot envelope: {"snapshot": {...}}.

snapshot

FinancialMetricSnapshot · object

required

Live financial-metric snapshot for one ticker, derived from the current market summary. Every field is a pointer with omitempty in the Go source: unsourced values are omitted from the response, never nulled or fabricated.

Show child attributes

Get a live financial-metrics snapshot

curl --request GET \
  --url https://financialdatasets.rip/financial-metrics/snapshot \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financial-metrics/snapshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financial-metrics/snapshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financial-metrics/snapshot"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financial-metrics/snapshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "snapshot": {
    "ticker": "AAPL",
    "market_cap": 4674544794120,
    "enterprise_value": 4698970959518,
    "price_to_earnings_ratio": 36.26,
    "price_to_book_ratio": 43.48,
    "price_to_sales_ratio": 10.01,
    "enterprise_value_to_ebitda_ratio": 27.98,
    "gross_margin": 0.4865291555900202,
    "operating_margin": 0.3317,
    "net_margin": 0.27618604910212224
  }
}

Overview

Integrations

Datasets

Guides

MCP Tools

What this answers

Coverage

Query rules

Worked example

Authorizations

Query Parameters

Response

​What this answers

​Coverage

​Query rules

​Worked example

Authorizations

Query Parameters

Response

What this answers

Coverage

Query rules

Worked example