Developer platform

Integrate the digital Euro in an afternoon.

A clean REST API for minting, redemption, balances and webhooks — plus a public transparency API that needs no key at all.

Quick start

Authenticate with your API key, request a mint, wire the funds, receive a webhook. The sandbox mirrors production exactly.

# 1 · Check your EURS balance
curl https://api.eurotrust.eu/v1/balance \
  -H "Authorization: Bearer etk_live_…"

# 2 · Request a mint of €250,000
curl -X POST https://api.eurotrust.eu/v1/mint-requests \
  -H "Authorization: Bearer etk_live_…" \
  -H "Idempotency-Key: order-2026-0612-01" \
  -d '{"amount_eur": 250000}'

# → wire instructions with unique SEPA reference
# 3 · After approval, webhook fires:
mint.completed { "ref":"MR-2026-000123",
  "amount_eur":250000, "tx_hash":"0xca66…" }
Local prototype: replace api.eurotrust.eu with localhost:4280/api. A demo key is preconfigured — see README.md.

API reference

Bank API (key required) and public transparency API.

GET/v1/institutionProfile, KYB status, accounts
GET/v1/balanceAggregate EURS balance
POST/v1/mint-requestsCreate mint (idempotent)
GET/v1/mint-requests/:refTrack mint status
POST/v1/redemptionsBurn EURS → EUR to IBAN
POST/v1/transfersOn-ledger EURS transfer
GET/v1/transactionsLedger history
POST/v1/webhooksRegister signed webhook
DEL/v1/webhooks/:idDisable endpoint

GET/v1/public/supplySupply, reserves, ratio — no key
GET/v1/public/reservesCustody breakdown — no key
GET/v1/public/historyDaily series — no key
GET/v1/public/attestationsMonthly reports — no key

Platform guarantees

Engineered for core-banking integration.

Idempotency

Every write accepts an Idempotency-Key. Retries are always safe — duplicates are replayed, never re-executed.

Signed webhooks

HMAC-SHA256 signatures (X-EURS-Signature) with timestamps to defeat replay attacks.

Rate limits

Transparent limits with X-RateLimit-* headers. Priority tiers for high-volume institutions.

Scoped keys

Keys are hashed at rest, scoped per capability (read / mint / redeem / webhooks) and revocable instantly.

Smart contracts

Addresses & ABIs

NetworkContractAddress
EthereumEURS Token0x…
Ethereum (Sepolia)EURS Token (testnet)0x91aF22e1Ce0fbD42907a2c1D7E33Bc44E1aF09d3
Polygon PoSEURS TokenPhase 2 — Month 10

Webhook events

Event catalogue

EventFires when
mint.completedEURS minted after funds clear + approval
redemption.burnedEURS burned, SEPA payout initiated
redemption.settledEUR payout confirmed with payment ref
Verify signatures: v1 = HMAC_SHA256(secret, timestamp + "." + body). Reject events older than 5 minutes.