> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rangler.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Company intelligence

> Combine price history, forecasts, recommendations, trades, meetings, corporate changes, mentions, news, and market time for a listed company.

Use this workflow when you need a company view rather than one isolated dataset. Every request uses your organization API key.

```http theme={null}
X-API-Key: rgl_live_your_key_here
```

## 1. Resolve the company

Most company endpoints require a Rangler company UUID. Find it once by ticker or name and save the returned `id`.

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies?q=MTNN&country_code=NG" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

Use the UUID in the remaining examples as `COMPANY_ID`.

## 2. Read forecasts and analyst views

Fetch the complete forecast grid when you need all available metrics and fiscal periods.

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/$COMPANY_ID/estimates/grid" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

Use the metric endpoints when you need contributor values, revisions, or source evidence for one metric. Forecast access through API keys is read-only: you cannot submit, revise, or withdraw a forecast.

Add recommendations and dividend history to the same company view:

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/$COMPANY_ID/analyst-recommendations?limit=50" \
  -H "X-API-Key: $RANGLER_API_KEY"

curl -s "https://api.rangler.co/v1/companies/$COMPANY_ID/dividends?limit=100" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

## 3. Build a price chart

The chart endpoint accepts either a ticker or a company UUID. Request compact line points for every available close:

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/MTNN/chart?period=max&format=line" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

Request complete daily candles for a specific period:

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/MTNN/chart?from=2025-01-01&to=2026-08-21&format=ohlcv" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

Rangler returns end-of-day observations for ordinary chart requests. The one-day
window and the optional hourly one-week interval return intraday observations in
`format=detailed`. `format=ohlcv` omits incomplete or internally inconsistent candles
instead of inventing usable OHLCV data. Inspect `coverage` for the actual line-history
range, candle-ready range, omitted points, frequency, freshness, and corporate-action
adjustment status.

See [Price charts](/price-charts) for response formats and rendering examples.

## 4. Track meetings

The calendar provides scheduled and reported board meetings, AGMs, EGMs, financial results, corporate actions, and earnings forecasts.

```bash theme={null}
curl -s "https://api.rangler.co/v1/calendar/events?from=2026-08-01&to=2026-12-31&company_id=$COMPANY_ID&type=board_meeting&type=agm&type=egm" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

Meeting media is separate because its lifecycle can continue from scheduled to live, ended, and replay available.

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/$COMPANY_ID/meeting-media?limit=20" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

## 5. Monitor board changes and insider dealings

Use the board-change feed to find affected companies. Then request that company's board-change filings to read the extracted changes and source details.

```bash theme={null}
curl -s "https://api.rangler.co/v1/filings/board-change-companies?country_code=NG" \
  -H "X-API-Key: $RANGLER_API_KEY"

curl -s "https://api.rangler.co/v1/filings?company_id=$COMPANY_ID&type=board_change" \
  -H "X-API-Key: $RANGLER_API_KEY"

curl -s "https://api.rangler.co/v1/filings/insider-dealings?company_id=$COMPANY_ID&limit=100" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

## 6. Follow company mentions

`mentioned-by` answers “which other issuers mentioned this company?” Each result includes the source filing and text evidence.

```bash theme={null}
curl -s "https://api.rangler.co/v1/companies/$COMPANY_ID/mentioned-by?limit=50" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

To inspect every company mentioned by one filing, reverse the lookup:

```bash theme={null}
curl -s "https://api.rangler.co/v1/filings/$FILING_ID/mentions" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

## 7. Add current context

Combine company news, upcoming events, and the market clock when you need a current monitoring view.

```bash theme={null}
curl -s "https://api.rangler.co/v1/news/developments?company_id=$COMPANY_ID&period=30d" \
  -H "X-API-Key: $RANGLER_API_KEY"

curl -s "https://api.rangler.co/v1/events/upcoming?symbol=MTNN&limit=25" \
  -H "X-API-Key: $RANGLER_API_KEY"

curl -s "https://api.rangler.co/v1/markets/clock?country_code=NG&market_code=NGX" \
  -H "X-API-Key: $RANGLER_API_KEY"
```

The NGX clock reports regular weekday hours. Check `holiday_adjusted`; a value of `false` means the response does not account for exchange holidays.

For authentication, error handling, and response rules, see [Authentication](/authentication), [Errors](/errors), and [Response conventions](/responses).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.