# QNB — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access QNB's financial statements, quarterly and annual reports, investor presentations, and earnings call transcripts to analyze comprehensive financial data and ratios. Track share information, regulatory announcements, and financial calendars to stay informed on QNB's investor relations updates and market performance.

**Category:** Finance & Markets | **Website:** [qnb.com/](https://qnb.com/) | **Docs:** [parse.bot/marketplace/d63bba88-d97a-417c-bff6-d7ff66d23827/qnb-com-api](https://parse.bot/marketplace/d63bba88-d97a-417c-bff6-d7ff66d23827/qnb-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get 12 quarter summary

Aggregates quarterly income statement financial data and calculates quarter-over-quarter percentage changes for key metrics (Net Interest Income, Operating Income, Profit for the Period, Profit for the Year). Returns all available quarters with QoQ% change fields appended to each period object.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-12-quarter-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get annual reports listing

Returns all available annual reports from QNB investor relations, spanning from 1966 to the most recent year. Each document includes title, PDF URL, and extracted year.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-annual-reports-listing \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get financial calendar

Retrieves financial calendar events from the QNB Euroland calendar API. Returns upcoming and recent events with dates and highlight status. May return an empty array when no events are currently scheduled.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-financial-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get financial data

Extracts structured financial data from the Euroland Interactive Analysis tool for QNB. Returns a table of periods with metric values. Metrics vary by statement_type: income returns revenue/profit metrics, balance returns asset/liability metrics, ratios returns financial ratios, segments returns business segment breakdowns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period_type` | string | No | Period granularity for the data. |
| `statement_type` | string | No | Financial statement category to retrieve. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-financial-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"period_type":"<string>","statement_type":"<string>"}'
```

### Get investor presentations

Lists all available investor presentation documents from QNB investor relations. Returns titles and PDF URLs ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-investor-presentations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ir call transcripts

Lists all available IR call transcript documents from QNB investor relations. Returns titles and PDF URLs ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-ir-call-transcripts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get quarterly results listing

Returns all available quarterly financial result documents from QNB investor relations. Each document includes title, PDF URL, extracted year, and quarter identifier. Documents are ordered as they appear on the page (newest first).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-quarterly-results-listing \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get regulatory announcements

Lists regulatory announcements and QSE disclosures with titles and document URLs from the QNB investor relations page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-regulatory-announcements \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get share information

Retrieves current share information and market data for QNB (QNBK on Qatar Exchange) including last price, volume, market cap, 52-week range, and YTD performance from the Euroland share series tool. Data is real-time during trading hours.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qnb/get-share-information \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.