{ "openapi": "3.0.3", "info": { "title": "Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer", "version": "3.0.0", "description": "Fetches official Central Bank of Brazil (BCB SGS & Olinda) macroeconomic series (Selic, CDI, IPCA, IGP-M, PTAX USD/EUR) and calculates automated B2B contract, lease, and treasury monetary adjustments.\n\n### Enterprise B2B Value Proposition (Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer)\n- **Target B2B Buyers:** Real Estate ERPs, LegalTech Contract Management Systems, FX Desks, and Brazilian FinTechs.\n- **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization.\n- **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`BCB PTAX, Selic, CDI or IPCA Contract Index Calculated`).\n- **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer ` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items`.\n- **Marketplace Categories:** RapidAPI `Finance` | Zyla API Hub `Finance`.\n- **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra).\n- **SEO Keywords:** banco-central-brasil, ptax-usd-brl, selic-cdi-ipca, igpm-indexer, contract-readjustment, brazil-macro-api, fintech-rates.", "termsOfService": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/", "contact": { "name": "B2B Quant APIs (@b2b-quant-apis)", "email": "jesleytassili@gmail.com", "url": "https://apify.com/b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer" }, "license": { "name": "Commercial B2B API Subscription (RapidAPI & Zyla Hub)", "url": "https://apify.com/b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer" }, "x-category": "Finance", "x-rapidapi-category": "Finance", "x-zyla-category": "Finance", "x-seo-tags": [ "banco-central-brasil", "ptax-usd-brl", "selic-cdi-ipca", "igpm-indexer", "contract-readjustment", "brazil-macro-api", "fintech-rates" ], "x-payout-destination": "Wise #890361113", "x-pricing-plans": { "BASIC": { "tier": "BASIC", "label": "Freemium Developer Trial", "monthlyPriceUsd": 0.0, "monthlyQuotaRequests": 15, "overagePricePerRequestUsd": 0.0, "hardLimit": true }, "PRO": { "tier": "PRO", "label": "Startup & RevOps Pipeline", "monthlyPriceUsd": 19.0, "monthlyQuotaRequests": 1000, "overagePricePerRequestUsd": 0.02, "hardLimit": false }, "ULTRA": { "tier": "ULTRA", "label": "Mid-Market Automation Cluster", "monthlyPriceUsd": 49.0, "monthlyQuotaRequests": 5000, "overagePricePerRequestUsd": 0.015, "hardLimit": false }, "MEGA": { "tier": "MEGA", "label": "Enterprise High-Throughput SLA", "monthlyPriceUsd": 149.0, "monthlyQuotaRequests": 25000, "overagePricePerRequestUsd": 0.01, "hardLimit": false } }, "x-code-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\ncurl --request POST \\\n --url \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nurl = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\"\npayload = {\n \"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\",\n \"contractBaseValueBrl\": 10000,\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nconst url = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-primary-backend-url": "https://api.apify.com", "x-primary-backend-base-url": "https://api.apify.com", "x-apify-sync-endpoint": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items", "x-apify-health-endpoint": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer", "x-backend-secret-header": { "name": "Authorization", "valueTemplate": "Bearer ", "headerName": "Authorization", "headerValueTemplate": "Bearer ", "injectedByProxy": true, "hiddenFromSubscriber": true, "description": "Secret Header injected invisibly by RapidAPI Studio and Zyla API Hub proxy when calling https://api.apify.com." }, "x-openapi-spec-url": "https://jesleytassili-glitch.github.io/specs_openapi_31/brazil-bcb-ptax-sgs-financial-contract-indexer.json", "x-openapi-suite-spec-url": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/specs_openapi_31/brazil-bcb-ptax-sgs-financial-contract-indexer.json", "x-apis-json-url": "https://jesleytassili-glitch.github.io/apis.json", "x-github-release-tag": "v2.2.0" }, "externalDocs": { "description": "Official B2B Documentation & Schema Reference for Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer", "url": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/actors/brazil-bcb-ptax-sgs-financial-contract-indexer.html" }, "servers": [ { "url": "https://api.apify.com", "description": "Primary Apify Cloud Synchronous Execution Cluster (Real HTTP 200/201 POST & GET)" }, { "url": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items", "description": "Direct Apify Actor Synchronous Execution Endpoint (brazil-bcb-ptax-sgs-financial-contract-indexer)" }, { "url": "https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev", "description": "Anti-Bypass Stateless B2B Gateway (RapidAPI & Zyla Hub Proxy)" } ], "tags": [ { "name": "Finance", "description": "RapidAPI Hub primary category: Finance (Zyla Hub: Finance)" }, { "name": "banco-central-brasil", "description": "B2B SEO Search Tag: banco-central-brasil" }, { "name": "ptax-usd-brl", "description": "B2B SEO Search Tag: ptax-usd-brl" }, { "name": "selic-cdi-ipca", "description": "B2B SEO Search Tag: selic-cdi-ipca" }, { "name": "igpm-indexer", "description": "B2B SEO Search Tag: igpm-indexer" }, { "name": "contract-readjustment", "description": "B2B SEO Search Tag: contract-readjustment" }, { "name": "brazil-macro-api", "description": "B2B SEO Search Tag: brazil-macro-api" }, { "name": "fintech-rates", "description": "B2B SEO Search Tag: fintech-rates" } ], "security": [ { "ApifyCloudBearerAuth": [] }, { "RapidAPIProxySecret": [] }, { "ZylaProxySecret": [] }, { "RapidAPISubscriberKey": [] } ], "paths": { "/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items": { "post": { "operationId": "run_sync_brazil_bcb_ptax_sgs_financial_contract_indexer", "summary": "Execute Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer (Apify Cloud Synchronous POST)", "description": "Synchronous stateless execution of **Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer**. RapidAPI Studio and Zyla API Hub inject the backend secret header `Authorization: Bearer ` invisibly to the end user, validate `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` in constant time (`hmac.compare_digest`), inject quota headers (`X-RateLimit-Remaining`, `X-Engine-Version`), and return deterministic JSON records.", "tags": [ "Finance", "banco-central-brasil", "ptax-usd-brl", "selic-cdi-ipca", "igpm-indexer", "contract-readjustment" ], "x-codeSamples": [ { "lang": "cURL", "label": "cURL", "source": "# Primary Synchronous Endpoint: https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\ncurl --request POST \\\n --url \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5}'" }, { "lang": "Python", "label": "Python (httpx)", "source": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nurl = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\"\npayload = {\n \"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\",\n \"contractBaseValueBrl\": 10000,\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n" }, { "lang": "Node.js", "label": "Node.js (fetch)", "source": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nconst url = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" } ], "x-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\ncurl --request POST \\\n --url \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nurl = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\"\npayload = {\n \"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\",\n \"contractBaseValueBrl\": 10000,\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nconst url = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-backend-secret-header": { "name": "Authorization", "value": "Bearer ", "visibleToSubscriber": false }, "requestBody": { "required": true, "description": "Structured JSON parameters for `brazil-bcb-ptax-sgs-financial-contract-indexer`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerRequest" }, "example": { "indicators": "SELIC,IPCA,IGP-M,PTAX_USD", "contractBaseValueBrl": 10000, "maxResults": 5 } } } }, "responses": { "200": { "description": "Successful synchronous execution of `brazil-bcb-ptax-sgs-financial-contract-indexer` returning enriched B2B JSON records.", "headers": { "X-RateLimit-Remaining": { "description": "Remaining requests in the subscriber's monthly plan quota (BASIC=15, PRO=1000, ULTRA=5000, MEGA=25000).", "schema": { "type": "integer", "example": 999 } }, "X-Engine-Version": { "description": "Deterministic B2B engine release version.", "schema": { "type": "string", "example": "3.0.0" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "count": 1, "data": [ { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } ] } } } }, "201": { "description": "Synchronous dataset created and returned for `brazil-bcb-ptax-sgs-financial-contract-indexer` on Apify Cloud (`HTTP 201`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "count": 1, "data": [ { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } ] } } } }, "400": { "description": "Bad Request — Invalid JSON payload or schema validation error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "error", "code": 400, "message": "Invalid JSON request body." } } } }, "403": { "description": "Forbidden — Missing or invalid `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` header (Anti-Bypass Protection).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "forbidden", "code": 403, "message": "Direct access denied. Requests must originate from RapidAPI Hub or Zyla API Hub with a valid Proxy-Secret." } } } }, "429": { "description": "Too Many Requests — Monthly plan quota exceeded (e.g., BASIC Freemium 15 req/month hard limit).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "quota_exceeded", "code": 429, "message": "Monthly request quota exceeded for BASIC plan (15 req/month hard limit). Upgrade to PRO ($19/mo), ULTRA ($49/mo), or MEGA ($149/mo)." } } } } } } }, "/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer": { "get": { "operationId": "status_brazil_bcb_ptax_sgs_financial_contract_indexer", "summary": "Actor Metadata & Live Connectivity Check for Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer", "description": "Immediate `HTTP 200` status and metadata health check for `brazil-bcb-ptax-sgs-financial-contract-indexer` on RapidAPI Studio and Zyla API Hub (`GET https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer` and `GET /v1/brazil-bcb-ptax-sgs-financial-contract-indexer/health`) without starting a container build or run.", "tags": [ "Finance" ], "responses": { "200": { "description": "Engine online and ready (`HTTP 200 JSON`).", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "actor": { "type": "string", "example": "brazil-bcb-ptax-sgs-financial-contract-indexer" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "category": { "type": "string", "example": "Finance" }, "data": { "type": "object", "additionalProperties": true, "example": { "name": "brazil-bcb-ptax-sgs-financial-contract-indexer", "username": "b2b-quant-apis", "isPublic": true } } } }, "example": { "status": "ok", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "category": "Finance", "data": { "name": "brazil-bcb-ptax-sgs-financial-contract-indexer", "username": "b2b-quant-apis", "isPublic": true } } } } } } } }, "/v1/brazil-bcb-ptax-sgs-financial-contract-indexer": { "post": { "operationId": "execute_brazil_bcb_ptax_sgs_financial_contract_indexer", "summary": "Execute Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer", "description": "Synchronous stateless execution of **Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer**. RapidAPI Studio and Zyla API Hub inject the backend secret header `Authorization: Bearer ` invisibly to the end user, validate `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` in constant time (`hmac.compare_digest`), inject quota headers (`X-RateLimit-Remaining`, `X-Engine-Version`), and return deterministic JSON records.", "tags": [ "Finance", "banco-central-brasil", "ptax-usd-brl", "selic-cdi-ipca", "igpm-indexer", "contract-readjustment" ], "x-codeSamples": [ { "lang": "cURL", "label": "cURL", "source": "# Primary Synchronous Endpoint: https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\ncurl --request POST \\\n --url \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5}'" }, { "lang": "Python", "label": "Python (httpx)", "source": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nurl = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\"\npayload = {\n \"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\",\n \"contractBaseValueBrl\": 10000,\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n" }, { "lang": "Node.js", "label": "Node.js (fetch)", "source": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nconst url = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" } ], "x-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\ncurl --request POST \\\n --url \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nurl = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\"\npayload = {\n \"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\",\n \"contractBaseValueBrl\": 10000,\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-bcb-ptax-sgs-financial-contract-indexer)\nconst url = \"https://brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-bcb-ptax-sgs-financial-contract-indexer.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"indicators\": \"SELIC,IPCA,IGP-M,PTAX_USD\", \"contractBaseValueBrl\": 10000, \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-backend-secret-header": { "name": "Authorization", "value": "Bearer ", "visibleToSubscriber": false }, "requestBody": { "required": true, "description": "Structured JSON parameters for `brazil-bcb-ptax-sgs-financial-contract-indexer`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerRequest" }, "example": { "indicators": "SELIC,IPCA,IGP-M,PTAX_USD", "contractBaseValueBrl": 10000, "maxResults": 5 } } } }, "responses": { "200": { "description": "Successful synchronous execution of `brazil-bcb-ptax-sgs-financial-contract-indexer` returning enriched B2B JSON records.", "headers": { "X-RateLimit-Remaining": { "description": "Remaining requests in the subscriber's monthly plan quota (BASIC=15, PRO=1000, ULTRA=5000, MEGA=25000).", "schema": { "type": "integer", "example": 999 } }, "X-Engine-Version": { "description": "Deterministic B2B engine release version.", "schema": { "type": "string", "example": "3.0.0" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "count": 1, "data": [ { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } ] } } } }, "201": { "description": "Synchronous dataset created and returned for `brazil-bcb-ptax-sgs-financial-contract-indexer` on Apify Cloud (`HTTP 201`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "count": 1, "data": [ { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } ] } } } }, "400": { "description": "Bad Request — Invalid JSON payload or schema validation error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "error", "code": 400, "message": "Invalid JSON request body." } } } }, "403": { "description": "Forbidden — Missing or invalid `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` header (Anti-Bypass Protection).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "forbidden", "code": 403, "message": "Direct access denied. Requests must originate from RapidAPI Hub or Zyla API Hub with a valid Proxy-Secret." } } } }, "429": { "description": "Too Many Requests — Monthly plan quota exceeded (e.g., BASIC Freemium 15 req/month hard limit).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "quota_exceeded", "code": 429, "message": "Monthly request quota exceeded for BASIC plan (15 req/month hard limit). Upgrade to PRO ($19/mo), ULTRA ($49/mo), or MEGA ($149/mo)." } } } } } } }, "/v1/brazil-bcb-ptax-sgs-financial-contract-indexer/health": { "get": { "operationId": "health_brazil_bcb_ptax_sgs_financial_contract_indexer", "summary": "Health & SLA Check for Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer", "description": "Immediate `HTTP 200` status and metadata health check for `brazil-bcb-ptax-sgs-financial-contract-indexer` on RapidAPI Studio and Zyla API Hub (`GET https://api.apify.com/v2/acts/b2b-quant-apis~brazil-bcb-ptax-sgs-financial-contract-indexer` and `GET /v1/brazil-bcb-ptax-sgs-financial-contract-indexer/health`) without starting a container build or run.", "tags": [ "Finance" ], "responses": { "200": { "description": "Engine online and ready (`HTTP 200 JSON`).", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "actor": { "type": "string", "example": "brazil-bcb-ptax-sgs-financial-contract-indexer" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "category": { "type": "string", "example": "Finance" }, "data": { "type": "object", "additionalProperties": true, "example": { "name": "brazil-bcb-ptax-sgs-financial-contract-indexer", "username": "b2b-quant-apis", "isPublic": true } } } }, "example": { "status": "ok", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "category": "Finance", "data": { "name": "brazil-bcb-ptax-sgs-financial-contract-indexer", "username": "b2b-quant-apis", "isPublic": true } } } } } } } } }, "components": { "securitySchemes": { "ApifyCloudBearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "APIFY_API_TOKEN", "description": "Backend Secret Header (`Authorization: Bearer `) injected invisibly by RapidAPI Studio and Zyla API Hub proxy when calling https://api.apify.com." }, "RapidAPIProxySecret": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Proxy-Secret", "description": "RapidAPI Hub shared proxy secret verified in constant time via hmac.compare_digest." }, "ZylaProxySecret": { "type": "apiKey", "in": "header", "name": "X-Zyla-Proxy-Secret", "description": "Zyla API Hub shared proxy secret verified in constant time via hmac.compare_digest." }, "RapidAPISubscriberKey": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Key", "description": "Subscriber API Key injected by RapidAPI Hub or Zyla API Hub." } }, "schemas": { "BrazilBcbPtaxSgsFinancialContractIndexerRequest": { "type": "object", "title": "Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer Request Schema", "description": "Input parameters for Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer.", "properties": { "indicators": { "type": "string", "title": "BCB SGS Indicator Codes or Names (CSV)", "description": "Comma-separated BCB indicators: SELIC (432), IPCA (433), IGP-M (189), PTAX_USD (1), CDI (12).", "default": "SELIC,IPCA,IGP-M,PTAX_USD", "example": "SELIC,IPCA,IGP-M,PTAX_USD" }, "contractBaseValueBrl": { "type": "number", "title": "Base Contract / Invoice Value (BRL)", "description": "Principal value in BRL to simulate monetary adjustment against the latest indicator rate.", "default": 10000, "example": 10000 }, "maxResults": { "type": "integer", "title": "Max Indicators to Process", "description": "Maximum number of indicator records to return (1 to 20).", "default": 5, "minimum": 1, "maximum": 20, "example": 5 } }, "required": [ "indicators" ], "example": { "indicators": "SELIC,IPCA,IGP-M,PTAX_USD", "contractBaseValueBrl": 10000, "maxResults": 5 } }, "BrazilBcbPtaxSgsFinancialContractIndexerRecord": { "type": "object", "title": "Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer Output Record", "description": "Enriched B2B dataset item returned by `brazil-bcb-ptax-sgs-financial-contract-indexer`.", "properties": { "indicatorCode": { "type": "string", "title": "Indicator Code", "description": "BCB SGS series code.", "example": "432" }, "indicatorName": { "type": "string", "title": "Indicator Name", "description": "Official macroeconomic indicator name.", "example": "Taxa Selic Meta (COPOM BCB)" }, "referenceDate": { "type": "string", "title": "Reference Date", "description": "Latest official publication date (DD/MM/YYYY).", "example": "04/11/2026" }, "latestRateValue": { "type": "number", "title": "Latest Rate / Value", "description": "Latest official value or rate published by BCB.", "example": 13.75 }, "unitType": { "type": "string", "title": "Unit / Periodicity", "description": "Rate unit (% p.a., % p.m., BRL/USD).", "example": "% a.a." }, "contractBaseValueBrl": { "type": "number", "title": "Base Contract Value (BRL)", "description": "Input contract principal in BRL.", "example": 10000 }, "adjustedContractValueBrl": { "type": "number", "title": "Adjusted Contract Value (BRL)", "description": "Simulated adjusted value in BRL.", "example": 11375 }, "financialImpactScore": { "type": "integer", "title": "Financial Impact Score (0-100)", "description": "Quantitative treasury materiality score (0-100).", "example": 92 }, "markdownTreasuryBrief": { "type": "string", "title": "Markdown Treasury & ERP Brief", "description": "Executive report for CFOs, ERPs, and legal contract automation.", "example": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } }, "example": { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } }, "BrazilBcbPtaxSgsFinancialContractIndexerResponseEnvelope": { "type": "object", "title": "Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer Synchronous Response Envelope", "required": [ "status", "actor", "count", "data" ], "properties": { "status": { "type": "string", "example": "succeeded" }, "actor": { "type": "string", "example": "brazil-bcb-ptax-sgs-financial-contract-indexer" }, "marketplace": { "type": "string", "example": "rapidapi_zyla_hub" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "count": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/BrazilBcbPtaxSgsFinancialContractIndexerRecord" } } }, "example": { "status": "succeeded", "actor": "brazil-bcb-ptax-sgs-financial-contract-indexer", "engineVersion": "3.0.0", "count": 1, "data": [ { "indicatorCode": "432", "indicatorName": "Taxa Selic Meta (COPOM BCB)", "referenceDate": "04/11/2026", "latestRateValue": 13.75, "unitType": "% a.a.", "contractBaseValueBrl": 10000, "adjustedContractValueBrl": 11375, "financialImpactScore": 92, "markdownTreasuryBrief": "# BRAZIL CENTRAL BANK (BCB SGS) CONTRACT & TREASURY BRIEF: Taxa Selic Meta (COPOM BCB)\n\n## 1. Official Macroeconomic Series\n- **SGS Series Code:** `432`\n- **Indicator Name:** **Taxa Selic Meta (COPOM BCB)**\n- **Reference Date:** `04/11/2026`\n- **Latest Official Rate:** **`13.75 % a.a.`**\n\n## 2. Automated B2B Contract / Invoice Simulation\n- **Base Principal Value (BRL):** `R$ 10,000.00`\n- **Adjusted Value / FX Conversion:** **`R$ 11,375.00`**\n- **Financial Impact Score:** **92/100**" } ] } }, "ErrorResponse": { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "string", "example": "error" }, "code": { "type": "integer", "example": 403 }, "message": { "type": "string", "example": "Direct access denied." } } } } } }