# Markets API guide



## Choose a Markets operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Posts and media



- [Price history](https://www.monocrawl.com/docs/endpoints/finance/history) — OHLCV bars for one instrument over a range at an interval.



### Other operations



- [Instrument news](https://www.monocrawl.com/docs/endpoints/finance/news) — Recent news articles about one instrument: title, publisher, link, time and related tickers.

- [Options chain](https://www.monocrawl.com/docs/endpoints/finance/options) — The nearest expiry's options chain for one instrument: calls and puts with strike, last, bid, ask, volume, open interest and implied volatility, plus the other expiries.

- [Company financial statements](https://www.monocrawl.com/docs/endpoints/finance/statements) — Income statement, balance sheet or cash-flow statement of a listed company, one row per fiscal period: annual rows for each fiscal year, quarter-end rows with trailing-twelve-month figures, plus the latest trailing twelve months.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/finance` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## finance/history

`GET /v1/finance/history`

OHLCV bars for one instrument over a range at an interval.

*Price history*

| Parameter | Required | Description |
| --- | --- | --- |
| `symbol` | yes | Ticker symbol — e.g. `AAPL` |
| `interval` | no | 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo or 3mo Accepted values: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1d` |
| `range` | no | 1d, 5d, 7d, 15d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd or max Accepted values: 1d, 5d, 7d, 15d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1mo` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/finance/history?symbol=AAPL" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "currency": "example",
  "exchange": "example",
  "has_more": false,
  "interval": "example",
  "items": [
    {
      "adjusted_close": 0,
      "close": 0,
      "date": "2026-09-01T12:00:00Z",
      "high": 0,
      "low": 0,
      "open": 0,
      "time": "example",
      "volume": 0
    }
  ],
  "name": "example",
  "previous_close": 0,
  "price": 0,
  "range": "example",
  "symbol": "example",
  "timezone": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/finance/history#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/finance/history.json)


## finance/news

`GET /v1/finance/news`

Recent news articles about one instrument: title, publisher, link, time and related tickers.

*Instrument news*

| Parameter | Required | Description |
| --- | --- | --- |
| `symbol` | yes | Ticker symbol — e.g. `AAPL` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/finance/news?symbol=AAPL" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "id": "example",
      "image": "https://example.com/example",
      "published_at": "2026-09-01T12:00:00Z",
      "publisher": "example",
      "related_symbols": [
        "example"
      ],
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "symbol": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/finance/news#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/finance/news.json)


## finance/options

`GET /v1/finance/options`

The nearest expiry's options chain for one instrument: calls and puts with strike, last, bid, ask, volume, open interest and implied volatility, plus the other expiries.

*Options chain*

| Parameter | Required | Description |
| --- | --- | --- |
| `symbol` | yes | Ticker symbol — e.g. `AAPL` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/finance/options?symbol=AAPL" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "calls": [
    {
      "ask": 0,
      "bid": 0,
      "change": 0,
      "change_percent": 0,
      "implied_volatility": 0,
      "in_the_money": false,
      "last": 0,
      "open_interest": 0,
      "strike": 0,
      "symbol": "example",
      "volume": 0
    }
  ],
  "expiries": [
    "example"
  ],
  "expiry": "example",
  "has_mini_options": false,
  "puts": [
    {
      "ask": 0,
      "bid": 0,
      "change": 0,
      "change_percent": 0,
      "implied_volatility": 0,
      "in_the_money": false,
      "last": 0,
      "open_interest": 0,
      "strike": 0,
      "symbol": "example",
      "volume": 0
    }
  ],
  "quote": {
    "as_of": "example",
    "change": 0,
    "change_percent": 0,
    "currency": "example",
    "day_high": 0,
    "day_low": 0,
    "exchange": "example",
    "fifty_two_week_high": 0,
    "fifty_two_week_low": 0,
    "market_cap": 0,
    "market_state": "example",
    "name": "example",
    "open": 0,
    "previous_close": 0,
    "price": 0,
    "shares_outstanding": 0,
    "symbol": "example",
    "type": "example",
    "volume": 0
  },
  "strikes": [
    0
  ],
  "symbol": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/finance/options#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/finance/options.json)


## finance/statements

`GET /v1/finance/statements`

Income statement, balance sheet or cash-flow statement of a listed company, one row per fiscal period: annual rows for each fiscal year, quarter-end rows with trailing-twelve-month figures, plus the latest trailing twelve months.

*Company financial statements*

| Parameter | Required | Description |
| --- | --- | --- |
| `symbol` | yes | Ticker symbol — e.g. `AAPL` |
| `statement` | no | income, balance or cash Accepted values: income, balance, cash. Case, spaces, hyphens and underscores are interchangeable. — e.g. `income` |
| `period` | no | all, annual or quarterly Accepted values: all, annual, quarterly. Case, spaces, hyphens and underscores are interchangeable. — e.g. `all` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/finance/statements?symbol=AAPL" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "note": "example",
  "period": "example",
  "periods": [
    {
      "basis": "example",
      "metric_count": 0,
      "metrics": {
        "basicAverageShares": 0,
        "basicEPS": 0,
        "costOfRevenue": 0,
        "dilutedAverageShares": 0,
        "dilutedEPS": 0,
        "dilutedNIAvailtoComStockholders": 0,
        "eBIT": 0,
        "eBITDA": 0,
        "grossProfit": 0,
        "interestExpense": 0,
        "interestExpenseNonOperating": 0,
        "interestIncome": 0,
        "interestIncomeNonOperating": 0,
        "netIncome": 0,
        "netIncomeCommonStockholders": 0,
        "netIncomeContinuousOperations": 0,
        "netIncomeFromContinuingAndDiscontinuedOperation": 0,
        "netIncomeFromContinuingOperationNetMinorityInterest": 0,
        "netIncomeIncludingNoncontrollingInterests": 0,
        "netInterestIncome": 0,
        "netNonOperatingInterestIncomeExpense": 0,
        "normalizedEBITDA": 0,
        "normalizedIncome": 0,
        "operatingExpense": 0,
        "operatingIncome": 0,
        "operatingRevenue": 0,
        "otherIncomeExpense": 0,
        "otherNonOperatingIncomeExpenses": 0,
        "pretaxIncome": 0,
        "reconciledCostOfRevenue": 0,
        "reconciledDepreciation": 0,
        "researchAndDevelopment": 0,
        "sellingGeneralAndAdministration": 0,
        "taxEffectOfUnusualItems": 0,
        "taxProvision": 0,
        "taxRateForCalcs": 0,
        "totalExpenses": 0,
        "totalOperatingIncomeAsReported": 0,
        "totalRevenue": 0
      },
      "period_end": "example"
    }
  ],
  "platform": "example",
  "statement": "example",
  "symbol": "example",
  "trailing_twelve_months": {
    "basis": "example",
    "metric_count": 0,
    "metrics": {
      "basicAverageShares": 0,
      "basicEPS": 0,
      "costOfRevenue": 0,
      "dilutedAverageShares": 0,
      "dilutedEPS": 0,
      "dilutedNIAvailtoComStockholders": 0,
      "eBIT": 0,
      "eBITDA": 0,
      "grossProfit": 0,
      "interestExpense": 0,
      "interestExpenseNonOperating": 0,
      "interestIncome": 0,
      "interestIncomeNonOperating": 0,
      "netIncome": 0,
      "netIncomeCommonStockholders": 0,
      "netIncomeContinuousOperations": 0,
      "netIncomeFromContinuingAndDiscontinuedOperation": 0,
      "netIncomeFromContinuingOperationNetMinorityInterest": 0,
      "netIncomeIncludingNoncontrollingInterests": 0,
      "netInterestIncome": 0,
      "netNonOperatingInterestIncomeExpense": 0,
      "normalizedEBITDA": 0,
      "normalizedIncome": 0,
      "operatingExpense": 0,
      "operatingIncome": 0,
      "operatingRevenue": 0,
      "otherIncomeExpense": 0,
      "otherNonOperatingIncomeExpenses": 0,
      "pretaxIncome": 0,
      "reconciledCostOfRevenue": 0,
      "reconciledDepreciation": 0,
      "researchAndDevelopment": 0,
      "sellingGeneralAndAdministration": 0,
      "taxEffectOfUnusualItems": 0,
      "taxProvision": 0,
      "taxRateForCalcs": 0,
      "totalExpenses": 0,
      "totalOperatingIncomeAsReported": 0,
      "totalRevenue": 0
    }
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/finance/statements#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/finance/statements.json)