# Bcra — 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 regulations, communications, and news from Argentina's Central Bank while retrieving real-time monetary variables and economic indicators. Search BCRA communications by type, date, or number, and monitor the latest financial statistics and homepage data all in one place.

**Category:** Finance & Markets | **Website:** [bcra.gob.ar/](https://bcra.gob.ar/) | **Docs:** [parse.bot/marketplace/b719db67-75e7-4905-a35e-6a34df5d3550/bcra-gob-ar-api](https://parse.bot/marketplace/b719db67-75e7-4905-a35e-6a34df5d3550/bcra-gob-ar-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/bcra/`
**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 homepage indicators

Retrieve key macroeconomic indicators displayed on the BCRA homepage. Includes base monetaria, inflation (monthly, annual, expected), exchange rates, and interest rates. Each indicator includes its serie number for historical data retrieval.

**Estimated cost:** Metered

_No parameters required._

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

### Get latest news

Retrieve the latest news articles and press releases from the BCRA homepage. Returns the most recent posts with title, date, excerpt, permalink, and category tags.

**Estimated cost:** Metered

_No parameters required._

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

### Get monetary variable data

Retrieve historical data for a specific monetary variable by its serie number. Requires solving a Turnstile captcha internally. Use get_monetary_variables to discover available serie numbers. Returns daily data points with date and value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `desde` | string | Yes | Start date in YYYY-MM-DD format. |
| `hasta` | string | Yes | End date in YYYY-MM-DD format. |
| `serie` | string | Yes | Serie number of the variable (e.g. '250' for Base monetaria, '272' for Tipo de Cambio Mayorista). Discoverable via get_monetary_variables. |

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

### Get monetary variables

List available monetary and financial variables from the BCRA, including their current values. Each variable has a 'serie' number that can be used with get_monetary_variable_data to retrieve historical data. Includes exchange rates, inflation, interest rates, reserves, and monetary base.

**Estimated cost:** Metered

_No parameters required._

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

### Search communications by date

Search for BCRA communications within a specific date range. Returns paginated results ordered by date descending. All communication types are included.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `desde` | string | Yes | Start date in YYYY-MM-DD format. |
| `hasta` | string | Yes | End date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bcra/search-communications-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"desde":"<string>","hasta":"<string>"}'
```

### Search communications by type and date

Search for BCRA communications by type and date range. Returns paginated results filtered by communication type and ordered by date descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `desde` | string | Yes | Start date in YYYY-MM-DD format. |
| `hasta` | string | Yes | End date in YYYY-MM-DD format. |
| `tipo` | string | Yes | Communication type. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bcra/search-communications-by-type-and-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"desde":"<string>","hasta":"<string>","tipo":"<string>"}'
```

### Search communications by type and number

Search for BCRA communications by their type and number. Returns matching communications with metadata including dates, references, and PDF links. Communication types are A (principal regulations), B (supplementary), C (informational), P (press releases).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `numero` | string | Yes | Communication number (e.g. '8176'). |
| `tipo` | string | Yes | Communication type. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bcra/search-communications-by-type-and-number \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"numero":"<string>","tipo":"<string>"}'
```

## 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.