Ilsole24ore APImercati.ilsole24ore.com ↗
Get real-time BTP-Bund spread data from Il Sole 24 Ore Mercati: ultimo spread, intraday high/low, absolute and percentage variation, and YTD change.
What is the Ilsole24ore API?
The Il Sole 24 Ore Mercati Spread API provides access to Italian government bond spread data through a single endpoint, get_spread, returning 8 structured fields per request. It covers the BTP Italia 10Y vs Bund 10Y spread by default, delivering the latest spread value, intraday range, previous close, and year-to-date variation sourced from one of Italy's primary financial news platforms.
curl -X GET 'https://api.parse.bot/scraper/c09d8c82-1ebb-4a1e-8180-a5a72facb4fe/get_spread?ticker_name=SPREAD_ITL_DEM.MTS' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the current spread data for a bond spread instrument on Il Sole 24 Ore Mercati. By default fetches the BTP Italia 10Y vs Bund 10Y spread. Returns ultimo spread, absolute and percentage variazione, previous close, daily high/low, and year-to-date variation. One upstream request per call.
| Param | Type | Description |
|---|---|---|
| ticker_name | string | The internal ticker symbol for the spread instrument (e.g. SPREAD_ITL_DEM.MTS for BTP-Bund 10Y spread). |
{
"type": "object",
"fields": {
"title": "Name of the spread instrument (e.g. Spread BTP Italia-BUND 10 Anni)",
"minimo": "Intraday low",
"massimo": "Intraday high",
"variazione": "Absolute variation from previous close",
"ultimo_spread": "Latest spread value as a string",
"chiusura_precedente": "Previous closing spread value",
"variazione_inizio_anno": "Year-to-date percentage variation",
"variazione_percentuale": "Percentage variation from previous close"
},
"sample": {
"data": {
"title": "Spread BTP Italia-BUND 10 Anni",
"minimo": "76.08",
"massimo": "77.76",
"variazione": "-0.37",
"ultimo_spread": "76.63",
"chiusura_precedente": "76.63",
"variazione_inizio_anno": "+11.77%",
"variazione_percentuale": "-0.48%"
},
"status": "success"
}
}About the Ilsole24ore API
What the API returns
The get_spread endpoint returns a snapshot of a bond spread instrument tracked on Il Sole 24 Ore Mercati. The default instrument is the BTP Italia 10Y vs Bund 10Y spread (ticker SPREAD_ITL_DEM.MTS). Each response includes the ultimo_spread (latest spread value), chiusura_precedente (previous close), variazione (absolute change), variazione_percentuale (percentage change), and variazione_inizio_anno (year-to-date percentage variation). Intraday range is covered via minimo and massimo fields.
Input parameters
The endpoint accepts one optional parameter: ticker_name, which accepts the internal instrument symbol. Passing a different ticker allows you to query other spread instruments tracked on the same platform. If omitted, the endpoint defaults to SPREAD_ITL_DEM.MTS, the BTP-Bund 10Y spread. The title field in the response confirms which instrument was returned.
Data freshness and coverage
Data reflects the current trading session where available, with intraday minimo and massimo updating as the session progresses. The response includes both absolute (variazione) and relative (variazione_percentuale) movement from the previous close, making it straightforward to compute directional signals or threshold alerts. The variazione_inizio_anno field exposes year-to-date drift without requiring a separate historical query.
The Ilsole24ore API is a managed, monitored endpoint for mercati.ilsole24ore.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mercati.ilsole24ore.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 mercati.ilsole24ore.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?+
- Alert systems that trigger when
ultimo_spreadcrosses a user-defined basis-point threshold - Dashboard widgets displaying the real-time BTP-Bund spread alongside equity indices
- Fixed-income research tools that log
chiusura_precedenteandvariazionefor session-over-session trend tracking - Eurozone sovereign risk monitors that surface
variazione_inizio_annofor medium-term context - Automated reports that include intraday
minimoandmassimoto show the day's spread range - Macro trading bots that consume
variazione_percentualeto adjust position sizing on Italian debt exposure
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Il Sole 24 Ore offer an official developer API for its Mercati financial data?+
What does the `get_spread` endpoint return beyond the raw spread value?+
ultimo_spread, the response includes chiusura_precedente (previous close), variazione (absolute change), variazione_percentuale (percentage change from previous close), variazione_inizio_anno (year-to-date percentage change), and the intraday minimo and massimo. The title field identifies the instrument by name.Can I retrieve historical spread data or time-series going back multiple days?+
Is the API limited to the BTP-Bund 10Y spread, or can it return other spread instruments?+
SPREAD_ITL_DEM.MTS), but the ticker_name parameter accepts other instrument symbols tracked on Il Sole 24 Ore Mercati. Passing a different ticker returns data for that spread instead. Coverage depends on which tickers the source platform exposes.Does the API cover spreads for other European sovereign bonds, such as Spain or Greece vs. Bund?+
get_spread endpoint is configured for Italian BTP instruments. You can fork the API on Parse and revise it to target additional sovereign spread tickers if they are available on the source platform.