API reference / Market Data

Equity quote

LTP / OHLC / change% for a symbol.

GET/v1/marketdata/equity
Authentication
Bearer token
Scope
marketdata:read

Before you integrate

  • An unknown symbol returns NOT_FOUND and is not charged.

Query parameters

FieldTypeRequiredDescription
symbolstringYesTrading symbol, 1 to 20 characters, for example RELIANCE.

Sample code

Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.

curl -sS -X GET 'https://grappi.ai/v1/marketdata/equity?symbol=RELIANCE' \
  -H "Authorization: Bearer $GRAPPI_API_KEY"

Sample response

{
  "request_id": "req_01HZY3K8M2",
  "result": {
    "symbol": "RELIANCE",
    "ltp_minor": 295000,
    "open_minor": 292659,
    "high_minor": 296475,
    "low_minor": 291781,
    "prev_close_minor": 292659,
    "change_pct": 0.8,
    "currency": "INR",
    "redistributable": true
  }
}

Response fields

FieldTypeDescription
symbolstringThe symbol, in capitals.
ltp_minorintegerLast traded price in the smallest unit of currency (paise for INR).
open_minorintegerDay's opening price.
high_minorintegerDay's high.
low_minorintegerDay's low.
prev_close_minorintegerPrevious close.
change_pctnumberChange from the previous close, in percent.
currencystringCurrency of the prices, for example INR.
redistributablebooleanWhether you may show this data to your own users.
attributionstringCredit line to display next to the data wherever you show it; present only when one is required.
disclaimerstringAnything you must know before relying on the figures; present only when there is one.

Errors

Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.