Ambito APIambito.com ↗
Access real-time Argentine currency prices (Dólar Blue, BNA, Euro) and historical riesgo país data from Ambito.com via a simple REST API.
What is the Ambito API?
The Ambito.com API exposes 2 endpoints covering real-time Argentine market indicators and historical country risk data. The get_currency_prices endpoint returns current buy and sell rates for a broad set of indicators including Dólar BNA, Dólar Blue, Euro, and select commodities. The get_historical_riesgo_pais endpoint delivers daily riesgo país values for any custom date range, sorted in descending chronological order.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5658b1c6-aaf8-42ee-8bc1-ecad748ae886/get_currency_prices' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ambito-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Ambito market data SDK — bounded, re-runnable; every call capped."""
from parse_apis.ambito_com_market_data_api import Ambito, InvalidDateFormat
client = Ambito()
# List all current currency prices and market indicators.
for price in client.currencyprices.list(limit=5):
print(price.currency, price.buy, price.sell, price.variation)
# Get historical country risk data for the last 30 days.
risk_record = client.riskrecords.list(start_date="12-05-2026", end_date="10-06-2026", limit=1).first()
if risk_record:
print(risk_record.date, risk_record.value)
# Typed error handling: catch invalid date format.
try:
for record in client.riskrecords.list(start_date="bad-date", limit=3):
print(record.date, record.value)
except InvalidDateFormat as exc:
print(f"Invalid date: {exc}")
print("exercised: currencyprices.list / riskrecords.list / InvalidDateFormat catch")
Extract all current currency prices and market indicators (Dólar BNA, Dólar Blue, Euro, Riesgo País, commodities, etc.) from Ambito.com. Returns the latest available prices with buy/sell rates, variation, and timestamps. No pagination — the full set of ~30 indicators is returned in one call.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of CurrencyPrice objects with currency name, buy/sell rates, value, date, variation, and source link"
},
"sample": {
"data": {
"items": [
{
"buy": "1412,29",
"date": "10/06/2026 - 14:04",
"sell": "1464,95",
"value": "1412,29",
"currency": "Dólar Oficial",
"variation": "0,08%",
"source_link": "/contenidos/dolar-oficial.html"
},
{
"buy": null,
"date": "10-06-2026",
"sell": null,
"value": "503",
"currency": "Riesgo País",
"variation": "1,00%",
"source_link": "/contenidos/riesgo-pais.html"
}
]
},
"status": "success"
}
}About the Ambito API
Currency Prices and Market Indicators
The get_currency_prices endpoint takes no input parameters and returns an array of market indicator objects. Each object includes a currency field (the indicator name, e.g. "Dólar Blue" or "Riesgo País"), a buy field, and a sell field — both strings that may be null for indicators where a buy/sell spread does not apply. The response reflects the latest prices available on Ambito.com and covers a range of instruments including official and parallel dollar rates, the euro, and commodity benchmarks.
Historical Riesgo País
The get_historical_riesgo_pais endpoint returns daily country risk values expressed in basis points. Both start_date and end_date are optional strings in DD-MM-YYYY format. Omitting end_date defaults to the current date. Results are returned as an array of objects, each containing a date string and a value string representing the riesgo país reading for that day. Records are ordered most-recent first, which makes it straightforward to read recent trends without reversing the array.
Data Coverage and Format Notes
All numeric values — prices, rates, and risk readings — are returned as strings rather than numbers, so consumers should cast them before arithmetic. The buy and sell fields on currency objects can be null for indicators that do not have a two-sided market (for example, a commodity index or the country risk figure itself). Date filtering on the historical endpoint is inclusive on both ends, and the full available history on Ambito.com can be retrieved by setting a wide date range.
The Ambito API is a managed, monitored endpoint for ambito.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ambito.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ambito.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live Dólar Blue vs. Dólar BNA spread widget in a personal finance app using
buyandsellfields. - Track the daily riesgo país trend over rolling 90-day windows using
get_historical_riesgo_paiswithstart_dateandend_date. - Alert users when the riesgo país
valuecrosses a configurable threshold by polling the historical endpoint for the latest reading. - Build a time-series chart of Argentine sovereign risk for an economics research dashboard.
- Populate a currency conversion tool with the latest official and parallel dollar rates from
get_currency_prices. - Archive daily riesgo país readings into a local database by querying the historical endpoint with yesterday's date each morning.
- Compare Euro and Dólar BNA sell rates over time by combining live prices with historical context.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ambito.com have an official developer API?+
What exactly does `get_currency_prices` return, and which indicators are included?+
currency (the indicator name), buy (buy price as a string or null), and sell (sell price as a string or null). Covered indicators include Dólar BNA, Dólar Blue, Euro, Riesgo País, and select commodities. Indicators that lack a two-sided market return null for buy and/or sell.Can I retrieve intraday or hourly riesgo país data?+
get_historical_riesgo_pais endpoint provides one value per calendar day; sub-daily granularity is not exposed. You can fork this API on Parse and revise it to add an intraday endpoint if Ambito.com surfaces that data.Are other Argentine financial indicators — such as Merval index levels or bond prices — available?+
get_currency_prices and historical riesgo país via get_historical_riesgo_pais. You can fork this API on Parse and revise it to add endpoints for additional instruments like equity indices or sovereign bonds.What is the date range I can query with `get_historical_riesgo_pais`, and what happens if I omit the dates?+
start_date and end_date are optional and use DD-MM-YYYY format. Omitting end_date defaults it to the current date. Omitting start_date returns data from the earliest available record through the end date. Results are always ordered most-recent first.