{"uid":"cap_n_Cd6hJUIxSdBBFFAZBGR","slug":"br-data-api-ptax-exchange-rate-12c133fe","name":"BR Data API – PTAX Exchange Rate","description":"Clean, normalized Brazilian public data (CNPJ, CEP, BCB rates, PTAX, holidays/business days, banks/ISPB) for AI agents. Paid endpoints use x402 (HTTP 402, USDC) — no signup or API key. Not affiliated with Receita Federal, Banco Central or Correios.","url":"https://brasil-data-x402.wagner-proc.workers.dev/v1/rates/ptax?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"},"currency":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"buy_brl":4.9929,"currency":"USD","sell_brl":4.9935,"quote_date":"2026-10-07"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1R_u8WTwxTp34AUhr6sV_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official PTAX exchange rate (buy and sell BRL prices) for a given currency and date, as published by Brazil's Banco Central.","exampleAgentPrompt":"What's the official PTAX exchange rate for USD to BRL for October 7, 2026? Give me both the buy and sell prices as published by Banco Central.","exampleUseCases":[{"title":"Daily FX rate for invoicing","prompt":"I need the official PTAX USD/BRL buy and sell rates for today so I can calculate the correct BRL amount on a USD invoice for a Brazilian client."},{"title":"Historical rate for accounting reconciliation","prompt":"Can you pull the official Banco Central PTAX sell rate for EUR on March 15, 2025? I need it to reconcile a foreign currency transaction in our books."},{"title":"Automated FX monitoring agent","prompt":"Every weekday, fetch the official PTAX rate for USD from Banco Central and let me know if the sell rate moved more than 1% from the previous day."}],"resultDescription":"A JSON object containing the currency code, the official BCB buy rate in BRL, the official BCB sell rate in BRL, and the quote date (e.g. {\"currency\":\"USD\",\"buy_brl\":4.9929,\"sell_brl\":4.9935,\"quote_date\":\"2026-10-07\"}).","failureModes":["No PTAX rate available for the requested date (e.g. weekends or Brazilian holidays) — may return empty or error response","Invalid or unsupported currency code — returns error","Future dates may not have rates published yet","Rate limit or payment failure via x402 if USDC payment is not properly handled"],"whenToPreferThis":"Use this endpoint when you need the official BCB PTAX exchange rate for BRL — the legally recognized rate used for Brazilian tax, accounting, and financial compliance purposes. Prefer this over generic FX APIs when the authoritative Banco Central figure is required, especially for invoicing, tax filings, or regulatory reporting in Brazil.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:31:11.748Z","isFirstParty":false,"canonicalSlug":"br-data-api-ptax-exchange-rate-12c133fe"}