Gov APImas.gov.sg ↗
Access MAS Singapore circulation currency coin specs and search MAS news, media releases, speeches, and publications via a structured API.
What is the Gov API?
This API covers three endpoints against the Monetary Authority of Singapore, returning detailed physical specifications for Singapore circulation coins across three coin series and full-text search across MAS news, media releases, speeches, parliamentary replies, and publications. The get_circulation_coins endpoint exposes 8 fields per coin denomination including metal composition, weight, diameter, thickness, and date of issue. The search_news endpoint returns paginated results with facet counts across content types, sections, and sectors.
curl -X GET 'https://api.parse.bot/scraper/4fe5ebee-811e-4373-a313-81ab4fbfb7a0/search_news?rows=5&sort=relevancy&query=coins&start=0§ion=News&content_type=Media+Releases' \ -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 mas-gov-sg-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.
from parse_apis.mas_coins_api import MAS, Sort, Section, ContentType, SeriesFilter
mas = MAS()
# Search for news articles about monetary policy sorted by date
for article in mas.articles.search(query="monetary policy", sort=Sort.DATE_DESC, section=Section.NEWS):
print(article.title, article.published_date, article.content_type)
# List all coin series with denomination details
for series in mas.serieses.list(series=SeriesFilter.THIRD):
print(series.series_name)
for coin in series.coins:
print(coin.denomination, coin.metal, coin.weight)
# Get autocomplete suggestions for a query
for suggestion in mas.suggestions.search(query="currency", section=Section.SINGAPORE_CURRENCY):
print(suggestion.title, suggestion.id)
Full-text search over MAS news, media releases, speeches, parliamentary replies, publications and other content. Returns paginated results with facets for content types, sections, and sectors. Paginates via start offset; each result includes title, summary, URL, content type, published date, and relevance score. Facets provide aggregate counts by content type, section, and sector.
| Param | Type | Description |
|---|---|---|
| rows | integer | Number of results to return per page (1 to 100). |
| sort | string | Sort order for results. |
| query | string | Search query string. |
| start | integer | Offset for pagination (0-based). |
| section | string | Filter by MAS master content section. |
| content_type | string | Filter by content type. |
{
"type": "object",
"fields": {
"start": "integer — current offset",
"total": "integer — total number of matching results",
"facets": "object containing content_types, sections, and sectors facet counts",
"results": "array of search result objects with title, summary, url, content_type, published_date, and score"
},
"sample": {
"data": {
"start": 0,
"total": 176,
"facets": {
"sectors": {
"Banking": 3
},
"sections": {
"News": 141
},
"content_types": {
"Pages": 31,
"Media Releases": 94
}
},
"results": [
{
"url": "https://www.mas.gov.sg/news/parliamentary-replies/2026/written-reply-to-parliamentary-question-on-circulation-of-five-cent-coins",
"score": 129.17613,
"title": "Written reply to Parliamentary Question on Circulation of Five-Cent Coins",
"summary": "Written reply to Parliamentary Question on Circulation of Five-Cent Coins",
"content_type": "Parliamentary Replies",
"published_date": "2026-02-24T11:00:00Z"
}
]
},
"status": "success"
}
}About the Gov API
Circulation Currency Coins
The get_circulation_coins endpoint returns coin data organized by series — first, second, or third — or all three at once via the series parameter. Each coin object in the response includes denomination, metal_composition, weight, diameter, thickness, edge type, design_description, and date_of_issue. This covers all denominations currently or historically in Singapore circulation, making it useful for numismatic references, currency education tools, or financial data aggregators that need precise physical specifications.
News and Publications Search
The search_news endpoint queries the full MAS content library. The query parameter accepts free-text strings, and results can be filtered by section (News, Statistics, Regulation, Publications, Bonds & Bills) and content_type (Media Releases, Speeches, Parliamentary Replies, Pages, Notices). Each result object includes title, summary, url, content_type, published_date, and a relevance score. The facets object in the response provides counts for content_types, sections, and sectors, which supports building dynamic filter UIs. Pagination is controlled via start (0-based offset) and rows (1–100 per page).
Autocomplete Suggestions
The search_suggest endpoint returns title-matched suggestions ranked by relevance. It accepts a query string, an optional section filter, and a count cap. The response includes a total count and a suggestions array of objects with title and id fields. This endpoint is suited for typeahead search components pointing at MAS content.
The Gov API is a managed, monitored endpoint for mas.gov.sg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mas.gov.sg 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 mas.gov.sg 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?+
- Build a numismatic reference tool displaying Singapore coin specs including weight, diameter, and metal composition by series
- Monitor MAS media releases and speeches for regulatory announcements using
search_newswithcontent_typefiltering - Aggregate MAS parliamentary replies into a searchable compliance knowledge base sorted by
date_desc - Power a typeahead search bar for MAS publications using
search_suggestwith section-scoped filtering - Compare coin physical specifications across Singapore's first, second, and third series for educational content
- Track sector-specific MAS publications using facet counts from
search_newsto identify coverage trends over time
| 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 MAS have an official public developer API?+
What does the `get_circulation_coins` endpoint distinguish between coin series?+
series parameter accepts first, second, third, or all. Each series object in the response contains a series_name and an array of coin objects. Coins within each series carry denomination, metal composition, weight, diameter, thickness, edge type, design description, and date of issue — so you can directly compare how specifications changed across series for the same denomination.How does pagination work in `search_news`?+
start parameter (0-based offset) and the rows parameter (1 to 100 results per page). The response includes a total count so you can calculate the number of pages. To walk through a large result set, increment start by the value of rows on each subsequent request.Does the API return the full body text of MAS publications or speeches?+
search_news returns title, summary, url, content_type, published_date, and score per result, not the full document body. Each result includes a url pointing to the MAS site where the full content is hosted. You can fork this API on Parse and revise it to add an endpoint that fetches and returns full publication text.