API reference / Wealth / MF

MF NAV history

Latest + historical NAV (AMFI).

GET/v1/mf/nav
Authentication
Bearer token
Scope
mf:read

Before you integrate

  • This reply has no balance_minor. A scheme with no NAV on record returns NOT_FOUND.

Query parameters

FieldTypeRequiredDescription
scheme_codestringYesThe mutual-fund scheme code published by AMFI, for example 120503.

Sample code

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

curl -sS -X GET 'https://grappi.ai/v1/mf/nav?scheme_code=120503' \
  -H "Authorization: Bearer $GRAPPI_API_KEY"

Sample response

{
  "request_id": "req_01HZY3K8M2",
  "result": {
    "latest": {
      "date": "2024-03-01",
      "nav_minor": 5120000
    },
    "history": [
      {
        "date": "2024-01-01",
        "nav_minor": 5000000
      },
      {
        "date": "2024-02-01",
        "nav_minor": 5060000
      },
      {
        "date": "2024-03-01",
        "nav_minor": 5120000
      }
    ]
  }
}

Response fields

FieldTypeDescription
latestobjectThe most recent NAV.
latest.datestringNAV date, ISO 8601.
latest.nav_minorintegerNAV per unit in paise.
historyarrayNAV history, oldest first.
history[].datestringNAV date, ISO 8601.
history[].nav_minorintegerNAV per unit in paise.

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.