canonical: https://jentic.com/apis/cambio-uruguay.com/cambio-uruguay # Cambio Uruguay Public API The Cambio Uruguay Public API aggregates buy and sell quotes from dozens of Uruguayan exchange houses and banks, refreshed through the day. It serves all current quotes at once, quotes for a single house, and a historical series with statistics for a currency at a house. It also lists BCU institution links and details, house metadata, branch locations, and the reference enums for valid house ids, currency codes, quote types, and departments. A paid operation generates an AI market insight, and liveness and health operations report service status. ## For AI agents Read aggregated buy and sell quotes from Uruguayan exchange houses, with historical series, branch locations, and reference data, across 17 endpoints. ## Scope Does not execute currency trades, transfer money, or open accounts. Use for reading Uruguayan exchange-house quotes, historical series, and branch data only. ## Capabilities - Read current buy and sell quotes aggregated from Uruguayan exchange houses and banks - Get quotes for one house, or a historical series with statistics for a currency at a house - List BCU institution links and details, house metadata, and branch locations - Look up the valid house ids, currency codes, quote types, and departments - Generate an AI market insight and check the AI feature status ## Use cases ### Exchange Rate Comparison Find the best buy or sell rate in Uruguay without visiting every house. An agent reads all current quotes at once, or drills into one house, and compares buy and sell rates across the aggregated exchange houses and banks. The data is read-only JSON refreshed through the day, so the agent reports the current spread rather than a stale figure. Example prompt: Fetch all current quotes, then compare the buy and sell rate for US dollars across houses ### Historical Series and Branch Lookup Chart how a currency moved and where to transact. An agent reads the historical series with statistics for a currency at a house, then lists branch locations and house metadata to point a user at the nearest option. Reference enums confirm the valid house ids, currency codes, and departments before the agent queries. Example prompt: Read the historical series for a currency at a house, then list that house's branch locations ### AI Agent Integration via Jentic An AI agent discovers and calls the Cambio Uruguay Public API through Jentic. The agent searches by intent, receives the matching operation and its input schema, and reads current or historical quotes. Because the public reads need no key, the agent gets rates immediately, and Jentic injects your optional plan key when you add one. Example prompt: Search Jentic for 'current exchange quotes', load the operation schema, and read all current quotes ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/` | All current quotes | | GET | `/exchange/{origin}/{code}` | Quotes for one house | | GET | `/evolution/{origin}/{code}` | Historical series with statistics | | GET | `/locations` | Branch locations | | GET | `/parameters/all` | All reference enums at once | | POST | `/ai/insights` | Generate an AI market insight | ## Key resources - **Rates** — All current quotes and quotes for a single exchange house - **History** — Historical rate series with statistics for a currency at a house - **Houses and Branches** — House metadata, branch locations, and BCU institution links and details - **Parameters** — Reference enums for valid house ids, currency codes, quote types, and departments ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 63 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 60 / 100 - AI-Readiness & Agent Experience: 45 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 78 / 100 - **View full report:** https://jentic.com/apis/cambio-uruguay.com/cambio-uruguay/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring Cambio Uruguay by hand means handling the anonymous ceiling, optionally sending a plan key in the X-API-Key header on api.cambio-uruguay.com, and caching responses yourself. Through Jentic you install once, import Cambio Uruguay from the API Directory, store the optional key if you have one, and your agent calls it. - **Permission scoping:** The quote reads are public, so through Jentic you limit the agent to the operations it needs, such as current quotes and historical series, while leaving the AI insight generation operation out of the set. - **Credential handling:** Your optional Cambio Uruguay plan key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'current exchange quotes' or 'historical rate series', and Jentic returns the matching Cambio Uruguay operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **ExchangeRate-API** — Global fiat exchange rates, versus Cambio Uruguay's house-by-house Uruguayan quotes. - **Open Exchange Rates** — Reference exchange rates against a base currency, versus local Uruguayan house quotes. - **CurrencyLayer** — Real-time and historical currency data to pair with Cambio Uruguay's local quotes. ## FAQ ### What authentication does the Cambio Uruguay Public API use? No API key is required to read the public quotes, per its OpenAPI spec. An optional free key, sent in the X-API-Key header, identifies you, meters your usage, and applies your plan. Through Jentic that optional key is stored encrypted by your own Jentic One instance and injected at call time when you add one. ### Is there a Cambio Uruguay MCP server? You do not need a separate MCP server to give your agent Cambio Uruguay. Jentic connects it directly from the API Directory: import it, and your agent calls its quote and history operations on demand. Operations are discovered as needed, so no extra server's tool definitions load into the agent's context. ### Can I read historical exchange rates with the Cambio Uruguay Public API? Yes. Call the evolution operation for a house and currency to get a historical series with statistics, and the current-quotes operation for live buy and sell rates. Both return structured JSON an agent can chart or compare. ### Can I limit what my agent is allowed to do with the Cambio Uruguay Public API? Yes. The API is read-only for quotes, and because you run Jentic One yourself your rules decide which operations the agent may call. You can allow current quotes and historical series while withholding the AI insight generation operation, and every call is logged. ### What are the rate limits for the Cambio Uruguay Public API? The OpenAPI spec does not pin exact numbers; it notes an anonymous ceiling that an optional key raises per your plan, and asks callers to cache responses. Check the Cambio Uruguay documentation at https://cambio-uruguay.com for current limits. ### How do I read current quotes with the Cambio Uruguay Public API through Jentic? Search Jentic for 'current exchange quotes' to get the matching operation and its input schema, then your agent reads all current quotes or one house's rates. To run it on your own infrastructure, install Jentic One from its GitHub repo.