API Documentation

We released this API to help developers building apps in Suriname — free to use, no strings attached. Grab a token below and plug the same USD/EUR bank rates shown on the homepage straight into your project. We'd love to see what you build with it.

Authentication

Every request requires a bearer token in the Authorization header. Tokens are issued manually — contact dulamari via WhatsApp to request one.

Authorization: Bearer <your-token>

Endpoint

GET https://koers.dulamari.com/api/

Returns the latest exchange rate for every bank, plus the average buy/sell across all banks. There is only one endpoint — it always returns the full dataset.

Example request

curl -H "Authorization: Bearer <your-token>" \
     https://koers.dulamari.com/api/

Example response

{
    "banks": [
        {
            "bank": "cbvs",
            "name": "CBvS",
            "usd": { "buy": 37.79, "sell": 37.98 },
            "eur": { "buy": 43.36, "sell": 44.12 },
            "updated_at": "2026-09-04 14:00:04"
        },
        ...
    ],
    "average": {
        "usd": { "buy": 37.51, "sell": 37.97 },
        "eur": { "buy": 43.35, "sell": 44.09 }
    },
    "updated_at": "2026-09-04 14:00:04"
}

Rate limits

Rates are only refreshed a few times a day (6AM, 8AM, 10AM and 2PM SRT), so each token is limited to up to 100 requests per calendar day (SRT, resets at midnight, default and maximum is 100). Polling more often than that will not return newer data.

Every response includes headers showing your remaining quota:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97

Errors

Status	Meaning
200	Success — JSON body returned.
401	Missing, malformed or invalid bearer token.
429	Daily request limit reached. Check `Retry-After` header for seconds until reset.
404	No rate data currently available.
500	Server or database error.

← Back to koersen Request an API token