[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Banco Central do Brasil Pix statistics](https://spiral.ai/integrations/codex/banco-central-do-brasil-pix-statistics)

# How to Use Banco Central do Brasil Pix statistics in Codex

Returns aggregate Pix transaction statistics, registered key counts, and DICT user statistics. Use it to study adoption by municipality or transaction segment, alongside broader payment statistics.

|  |  |
| --- | --- |
| Model | Banco Central do Brasil Pix statistics |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Banco Central do Brasil Pix statistics in Codex

- Use Banco Central do Brasil Pix statistics to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Banco Central do Brasil Pix statistics and tell me what changed since last week.
- Check Banco Central do Brasil Pix statistics and summarize what you find in three bullet points.
- Pull the newest data from Banco Central do Brasil Pix statistics and give me the result as a table.
- Check Banco Central do Brasil Pix statistics every morning and tell me only when something changed.

## How to set up Banco Central do Brasil Pix statistics in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Banco Central do Brasil Pix statistics**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "bcb-gov-br/economic-data/pix_statistics",
    "input": {
      "dataset": "transacoes_por_municipio"
    }
  }'
```

Then paste one of the prompts above: Codex finds Banco Central do Brasil Pix statistics on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Banco Central do Brasil Pix statistics tools and prices

- [Banco Central do Brasil open data · Pix statistics](https://spiral.ai/tools/alexandria/bcb-gov-br/economic-data/pix_statistics) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| top | 1 to 1000 | 100 | Page size. |
| data |  | — | Month-end date YYYY-MM-DD for `chaves` (e.g. 2026-08-31). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| skip | 0 to … | 0 | Must be 0: Pix_DadosAbertos rejects $skip on the server. Kept for symmetry with the other Olinda functions. |
| estado |  | — | `transacoes_por_municipio`: exact state name as served, upper case, e.g. SÃO PAULO. |
| ano_mes |  | — | Month yyyyMM, e.g. 202507. Required by `transacoes_por_municipio` and `estatisticas_transacoes`. Pattern: ^[0-9]{6}$. |
| municipio_ibge | 1 to … | — | `transacoes_por_municipio`: IBGE municipality code, e.g. 3550308. |

## What can you do with Banco Central do Brasil Pix statistics in Codex?

Build a Brazil economic dashboard with documented BCB measures behind each chart. A coding agent can turn catalog and service descriptions into a data dictionary and add views for lending, forecasts, payments, exchange rates, and historical indicators.

### Write a Brazilian retail finance brief

Compare Pix adoption and the payment-instrument mix with published lending averages and Selic history. Add Focus expectations for economic context, using catalog and Olinda descriptions to distinguish each measure's scope.

### Assess conditions for entering Brazil

Prepare a market-entry evidence pack covering local borrowing costs, monetary conditions, published economic expectations, payment usage, and foreign-currency benchmarks. Catalog discovery, service descriptions, and the PTAX currency directory help identify the data behind each section.

### Compare Pix adoption with broader payment activity

Study municipal Pix activity alongside national payment-instrument statistics. Use the catalog and Olinda service descriptions to identify the applicable resources and explain why monthly payment totals and daily SPI settlements have different scopes.

### Build a BCB data dashboard

Create separate views for lending averages, Focus expectations, payment activity, Pix adoption, exchange-rate benchmarks, and SGS observations. Keep a data dictionary from catalog records, Olinda descriptions, and PTAX currency metadata so readers can inspect what each chart measures.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Banco Central do Brasil Pix statistics in other agents

- [Amp](https://spiral.ai/integrations/amp/banco-central-do-brasil-pix-statistics)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/banco-central-do-brasil-pix-statistics)
- [Claude](https://spiral.ai/integrations/claude-desktop/banco-central-do-brasil-pix-statistics)
- [Claude Code](https://spiral.ai/integrations/claude-code/banco-central-do-brasil-pix-statistics)
- [Cline](https://spiral.ai/integrations/cline/banco-central-do-brasil-pix-statistics)
- [Cursor](https://spiral.ai/integrations/cursor/banco-central-do-brasil-pix-statistics)
- [Devin](https://spiral.ai/integrations/devin/banco-central-do-brasil-pix-statistics)
- [dots](https://spiral.ai/integrations/dots/banco-central-do-brasil-pix-statistics)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/banco-central-do-brasil-pix-statistics)
- [Gemini](https://spiral.ai/integrations/gemini/banco-central-do-brasil-pix-statistics)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/banco-central-do-brasil-pix-statistics)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/banco-central-do-brasil-pix-statistics)
- [goose](https://spiral.ai/integrations/goose/banco-central-do-brasil-pix-statistics)
- [Grok](https://spiral.ai/integrations/grok/banco-central-do-brasil-pix-statistics)
- [Grok Build](https://spiral.ai/integrations/grok-build/banco-central-do-brasil-pix-statistics)
- [Hermes](https://spiral.ai/integrations/hermes/banco-central-do-brasil-pix-statistics)
- [Instinct](https://spiral.ai/integrations/instinct/banco-central-do-brasil-pix-statistics)
- [Manus](https://spiral.ai/integrations/manus/banco-central-do-brasil-pix-statistics)
- [Muse](https://spiral.ai/integrations/muse/banco-central-do-brasil-pix-statistics)
- [Muse Code](https://spiral.ai/integrations/muse-code/banco-central-do-brasil-pix-statistics)
- [n8n](https://spiral.ai/integrations/n8n/banco-central-do-brasil-pix-statistics)
- [Notion](https://spiral.ai/integrations/notion/banco-central-do-brasil-pix-statistics)
- [OpenClaw](https://spiral.ai/integrations/openclaw/banco-central-do-brasil-pix-statistics)
- [opencode](https://spiral.ai/integrations/opencode/banco-central-do-brasil-pix-statistics)
- [Perplexity](https://spiral.ai/integrations/perplexity/banco-central-do-brasil-pix-statistics)
- [Raycast](https://spiral.ai/integrations/raycast/banco-central-do-brasil-pix-statistics)
- [VS Code](https://spiral.ai/integrations/vscode/banco-central-do-brasil-pix-statistics)
- [Windsurf](https://spiral.ai/integrations/windsurf/banco-central-do-brasil-pix-statistics)
- [Zapier](https://spiral.ai/integrations/zapier/banco-central-do-brasil-pix-statistics)

## More Codex guides

- [Banco Central do Brasil PTAX dollar rates](https://spiral.ai/integrations/codex/banco-central-do-brasil-ptax-dollar-rates)
- [Banco Central do Brasil SGS time series](https://spiral.ai/integrations/codex/banco-central-do-brasil-sgs-time-series)
- [Banco Central do Brasil PTAX currency rates](https://spiral.ai/integrations/codex/banco-central-do-brasil-ptax-currency-rates)
- [Banco Central do Brasil bank lending rates](https://spiral.ai/integrations/codex/banco-central-do-brasil-bank-lending-rates)
- [Banco Central do Brasil PTAX currency directory](https://spiral.ai/integrations/codex/banco-central-do-brasil-ptax-currency-directory)
- [Banco Central do Brasil dataset search](https://spiral.ai/integrations/codex/banco-central-do-brasil-dataset-search)

## Questions about Banco Central do Brasil Pix statistics in Codex

**Can Codex use Banco Central do Brasil Pix statistics?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Banco Central do Brasil Pix statistics like any built-in tool.

**How much does Banco Central do Brasil Pix statistics cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Banco Central do Brasil Pix statistics in Codex?**

No. Spiral runs Banco Central do Brasil Pix statistics on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Banco Central do Brasil Pix statistics in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Banco Central do Brasil Pix statistics runs?**

Banco Central do Brasil Pix statistics runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How quickly do BCB payment statistics become available?**

Monthly payment-instrument statistics are updated 17 days after month-end, while quarterly instruments are updated two months after quarter-end. SPI statistics have a daily update frequency.

**How far back do Pix statistics go?**

The Pix catalog gives November 30, 2020 as its coverage start and specifies monthly updates. Registered-key and registered-user stocks are month-end snapshots.

**Are Focus figures BCB's own forecasts?**

Focus statistics summarize expectations submitted by banks, asset managers, and other participating institutions. Statistics are calculated daily, and the market report appears on the first business day of the week.

**Do published lending rates represent the rate a borrower will receive?**

They are averages of completed transactions over five business days, weighted by contracted amounts. BCB says rates can differ among customers at the same institution, and some institutions may be absent because they made no relevant loans or did not report on time.

**Do BCB cash statistics measure cash purchases?**

Cash-in-circulation data counts banknotes and coins outstanding and excludes commemorative coins. The payment-instrument statistics cover cash withdrawals rather than all purchases made with cash.

