Quickstart

Make your first request

REST endpoints for filings, funds, financial statements, and events.

Choose a workflow

Guides for NAV, disclosures, filings, dividends, and board changes.

Use the SDK

Python tooling for webhook verification, event parsing, and API reads.

Receive webhooks

Signed push delivery for market events.

1. Get an API key

The key is shown once. Copy it to your secret manager or .env file immediately.

2. Pick your integration path

Start with webhooks for production event delivery. Use event feeds for initial history and checks for missed deliveries.

See Webhooks and Event Feeds for the trade-offs, and SDKs if you want a typed client instead of raw HTTP.

2a. Pick a workflow package

Start with a workflow, not a raw endpoint list. Fund Monitoring covers NAV, disclosures, and fund updates. Issuer Monitoring covers filings, dividends, and board changes.

3. Make your first request

curl -sG https://sandbox-api.rangler.co/v1/financials/statements \
  -H "X-API-Key: rgl_test_your_key_here" \
  --data-urlencode "ticker=ACCESSCORP" \
  --data-urlencode "country_code=NG" \
  --data-urlencode "granularity=annual" \
  --data-urlencode "include_sources=false" | python3 -m json.tool

curl -s https://sandbox-api.rangler.co/v1/filings?limit=5 \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

curl -s https://sandbox-api.rangler.co/v1/funds?limit=5 \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

curl -s "https://sandbox-api.rangler.co/v1/events?limit=10" \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

Responses are JSON. Errors follow Errors.

The Financials example requires a paid organization with the data scope. A sandbox key still observes the organization's plan entitlement.

4. Explore the data

Try:

Endpoint	What it returns
`GET /v1/financials/statements?ticker=ACCESSCORP&country_code=NG`	Standardized financial statements, ratios, and optional filing sources
`GET /v1/companies`	Listed companies with market, sector, and ticker
`GET /v1/companies/{id}/filings`	Filings for a specific company
`GET /v1/funds/{id}`	Fund detail with `latest_snapshot` (most recent NAV) and `latest_holdings_snapshot` (most recent disclosure with holdings)
`GET /v1/funds/{id}/snapshots`	Historical fund snapshots with month-over-month and year-over-year deltas
`GET /v1/events?type=dividend.declared`	Filter the event feed by type

See Financial data, Response Conventions, and the API Reference for details.

5. Add Rangler SDKs

Use ranglerpy for webhook verification, typed event parsing, duplicate-delivery helpers, and API reads. See SDKs. Production receivers still require shared, durable storage for processed event IDs.