# Monetary Authority of Singapore — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for Monetary Authority of Singapore news and publications, and access detailed information about circulation currency coins in Singapore. Get suggestions for relevant content and browse official MAS announcements all in one place.

**Category:** Government & Public Data | **Website:** [www.mas.gov.sg/currency/circulation-currency/circulation-currency-coins](https://www.mas.gov.sg/currency/circulation-currency/circulation-currency-coins) | **Docs:** [parse.bot/marketplace/678a8175-ff3a-4bc2-963a-10cb12b1a372/mas-gov-sg-api](https://parse.bot/marketplace/678a8175-ff3a-4bc2-963a-10cb12b1a372/mas-gov-sg-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mas-gov-sg-api-678a8175/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_circulation_coins

Get details of Singapore circulation currency coins from MAS. Returns metal composition, weight, diameter, thickness, design description, edge type, and date of issue for all denominations. Filterable by series (first, second, third, or all). Each series groups its denominations together.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series` | string | No | Filter by coin series. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mas-gov-sg-api-678a8175/get_circulation_coins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"series":"<string>"}'
```

### search_news

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `content_type` | string | No | Filter by content type. |
| `query` | string | No | Search query string. |
| `rows` | integer | No | Number of results to return per page (1 to 100). |
| `section` | string | No | Filter by MAS master content section. |
| `sort` | string | No | Sort order for results. |
| `start` | integer | No | Offset for pagination (0-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mas-gov-sg-api-678a8175/search_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"<string>","query":"<string>","rows":"<integer>","section":"<string>","sort":"<string>","start":"<integer>"}'
```

### search_suggest

Get search autocomplete suggestions from MAS. Returns title matches ranked by relevance score. Useful for building type-ahead search interfaces over MAS content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of suggestions to return. |
| `query` | string | No | Search query to get suggestions for. |
| `section` | string | No | Filter suggestions by MAS master content section. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mas-gov-sg-api-678a8175/search_suggest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","query":"<string>","section":"<string>"}'
```