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
| Field | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Trading 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
| Field | Type | Description |
|---|---|---|
symbol | string | The symbol, in capitals. |
ltp_minor | integer | Last traded price in the smallest unit of currency (paise for INR). |
open_minor | integer | Day's opening price. |
high_minor | integer | Day's high. |
low_minor | integer | Day's low. |
prev_close_minor | integer | Previous close. |
change_pct | number | Change from the previous close, in percent. |
currency | string | Currency of the prices, for example INR. |
redistributable | boolean | Whether you may show this data to your own users. |
attribution | string | Credit line to display next to the data wherever you show it; present only when one is required. |
disclaimer | string | Anything 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.