TWRR and XIRR from periods and cashflows.

PMS and AIF Reporting

Send period start and end values with the dated cashflows, and the endpoint returns time-weighted return and money-weighted XIRR for a portfolio. Values are in minor units. The computation is billed per call.

OpenSelf-serve. Grantable on any key, no access request.

Start free in sandbox See endpoints

endpoint in this rail

Open

access tier

Consent

bound on every read

Audit

hash-chained trail

Endpoints

Every endpoint shares auth, idempotency, consent and metering hooks, a unified error envelope, and a hash-chained audit trail.

POST

PMS performance

/v1/pms/performance

TWRR + XIRR from period values + cashflows.

How it works

From signup to a live PMS and AIF Reporting call in four steps.

Create a free account

Unlock the rail

Grant the scope to any key yourself. No access request, no business verification.

Make your first call

Send the sample request to /v1/pms/performance with your sandbox key and read back live JSON.

Go live

Swap the sandbox key for a live key. Every call is metered, itemized, and audit-chained.

Call pms performance

The flagship call for this rail. Swap the sandbox key for your own and you are live.

post-pms-performance.sh

curl -X POST https://api.grappi.in/v1/pms/performance \
  -H "x-api-key: sk_sandbox_••••" \
  -H "content-type: application/json" \
  -d '{"periods":[{"start_value_minor":1000000,"end_value_minor":1100000},{"start_value_minor":1100000,"end_value_minor":1210000}],"cashflows":[{"date":"2023-01-01","amount_minor":-1000000},{"date":"2024-01-01","amount_minor":1210000}]}'

Developer ready

Docs, MCP, and a prompt that does the work

Every rail ships with an integration guide, an MCP server for AI agents, and a ready-to-paste prompt, so your first PMS and AIF Reporting call takes minutes, not days.

Integration guide

The quickstart covers keys, auth, idempotency, the error envelope, and paise money units. The catalog documents every PMS and AIF Reporting endpoint with a live sample you can run from the playground.

Read the quickstart Try it in the playground

MCP server for AI agents

grappi-mcp exposes the API as agent tools over the same gateway, so every tool call keeps auth, consent, metering, and audit. Drop this into your MCP client config.

mcp.json

{
  "mcpServers": {
    "grappi": {
      "command": "npx",
      "args": ["grappi-mcp"],
      "env": {
        "GRAPPI_API_BASE": "https://api.grappi.in",
        "GRAPPI_API_KEY": "sk_sandbox_••••"
      }
    }
  }
}

Prompt-ready integration

Paste this into Claude, Cursor, or any coding agent. It carries the real contract rules, so the generated client matches the gateway on the first try.

integrate-pms-aif.prompt

Integrate the Grappi PMS and AIF Reporting API into my app.

Endpoints:
- POST /v1/pms/performance (PMS performance)

Contract rules: send the key as the x-api-key header, treat all money as integer paise (₹1.00 = 100), send an Idempotency-Key on every POST, and branch on the error envelope error.code (handle 402 insufficient_balance, 403 consent_required, 422 validation_failed, 429 rate_limited).

Write a small typed client for these endpoints plus one worked call, with validation and error handling, in my project's language.

Frequently asked questions

Can I try it for free?

Yes. Signing up creates a sandbox key, so you can call this rail immediately without a card. Sandbox calls run against test data, not production.

What comes with every endpoint?

Auth, idempotency, consent and metering hooks, a unified error envelope, and a hash-chained audit trail — identical across every rail on the platform.

What do I need to go live?

Self-serve. Grantable on any key, no access request. Once live, the same key and the same contract carry over from sandbox.

Is this compliant for regulated use?

Reads are consent-bound and DPDP and RBI-AA aligned. Every call lands in a hash-chained audit trail, and regulated rails stay locked until an access request is approved.

Related products

Other rails on the open tier.

Get started

Start building with PMS and AIF Reporting

Create a free sandbox account, get a prefunded key, and call PMS and AIF Reporting on the same contract as every other rail.

Instant sandbox key, no card required
One key works across every rail
Open rails are live the moment you sign up

Create your free sandbox account Read the quickstart

Consent-bound on every read. DPDP and RBI-AA aligned.