# BR Intelligence PTAX Exchange Rate API

> BR Intelligence PTAX Exchange Rate API is a paid API for AI agents from br-intelligence.brverify-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns official Brazil Central Bank PTAX exchange rates (buy/sell) for USD/BRL, EUR/BRL, and other currencies, for today or any historical date.

## Facts

- Endpoint: GET https://br-intelligence.brverify-api.workers.dev/v1/ptax?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/br-intelligence-ptax-exchange-rate-api-92c829a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YfcPuXRGZikEHogdeTW_H

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability br-intelligence-ptax-exchange-rate-api-92c829a4
```

Example prompt: What is the official Brazilian Central Bank PTAX closing rate for USD to BRL today? I need both the buy and sell rates.

## When to prefer this

Choose this endpoint when you need official, Central Bank of Brazil sanctioned PTAX exchange rates for BRL pairs — especially for legal, accounting, tax, or financial compliance use cases in Brazil that require the official Fechamento (closing) rate. Prefer this over commercial FX APIs when the Brazilian legal standard (PTAX) is specifically required, such as for NF-e invoices, tax filings, or government contracts.

## Known failure modes

- No PTAX published for the requested date (e.g. weekend, Brazilian holiday) — returns null or empty bulletins
- Unsupported or misspelled currency ISO code returns an error
- Future dates return no data
- Network timeout or Cloudflare Worker error (HTTP 5xx)
- Payment failure via x402 if USDC balance is insufficient

## How this service works

Brazil PTAX exchange rate (official, Central Bank of Brazil): USD/BRL dollar, EUR/BRL euro and other currencies to Brazilian real, buy and sell, closing (Fechamento) and intraday bulletins, today or any past date.

## Output

Returns the official PTAX exchange rate data from the Brazilian Central Bank, including: the latest available bulletin (buy rate, sell rate, bulletin type, timestamp), the official closing Fechamento rate if already published (or null if not yet), and an array of all intraday bulletins for the requested date. Also returns the currency code, date used, and unit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "description": "Optional YYYY-MM-DD for a historical PTAX (default: today, Brasilia time)."
      },
      "currency": {
       "type": "string",
       "description": "ISO 4217 code: USD (default), EUR, GBP, JPY, CHF, CAD, AUD, ARS..."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "currency",
      "date",
      "latest",
      "unit"
     ],
     "properties": {
      "date": {
       "type": "string",
       "format": "date",
       "description": "Date of the bulletins used (last business day with quotes)."
      },
      "unit": {
       "type": "string"
      },
      "latest": {
       "type": "object",
       "properties": {
        "buy": {
         "type": "number",
         "description": "Buy rate (BRL per 1 unit of the currency)."
        },
        "sell": {
         "type": "number",
         "description": "Sell rate (BRL per 1 unit of the currency)."
        },
        "time": {
         "type": "string",
         "description": "Bulletin timestamp, Brasilia time."
        },
        "type": {
         "type": "string",
         "description": "Abertura, Intermediario or Fechamento (closing)."
        }
       }
      },
      "closing": {
       "anyOf": [
        {
         "type": "object",
         "properties": {
          "buy": {
           "type": "number",
           "description": "Buy rate (BRL per 1 unit of the currency)."
          },
          "sell": {
           "type": "number",
           "description": "Sell rate (BRL per 1 unit of the currency)."
          },
          "time": {
           "type": "string",
           "description": "Bulletin timestamp, Brasilia time."
          },
          "type": {
           "type": "string",
           "description": "Abertura, Intermediario or Fechamento (closing)."
          }
         }
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/br-intelligence-ptax-exchange-rate-api-92c829a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from br-intelligence.brverify-api.workers.dev](https://www.zero.xyz/host/br-intelligence.brverify-api.workers.dev/llms.txt)
