API/Reference
Environments
Gateway URLs, policy IDs, and app URLs for each Andamio environment
Start on preprod for development. Move to production when your app is tested and ready.
Quick Reference
| Environment | Gateway URL | App URL | Generate API Key |
|---|---|---|---|
| Preprod (start here) | preprod.api.andamio.io | preprod.app.andamio.io | app.andamio.io/api-setup (see note) |
| Production | mainnet.api.andamio.io | app.andamio.io | app.andamio.io/api-setup |
| Development | dev.api.andamio.io | dev.app.andamio.io | Internal — contact team |
All API keys are managed on the mainnet app
API keys for every environment — preprod included — are generated at app.andamio.io/api-setup using the network selector. /api-setup on the preprod app redirects to the dashboard by design. Registration requires a mainnet Access Token. Self-serve preprod key generation is open to all registered developers (API v2.4.1).
Access Token Policy IDs
Each environment has a unique Access Token policy ID:
| Environment | Policy ID |
|---|---|
| Preprod | 29aa6a65f5c890cfa428d59b15dec6293bf4ff0a94305c957508dc78 |
| Production | Contact team for mainnet policy ID |
Environment Variables
Preprod (Development)
NEXT_PUBLIC_ANDAMIO_GATEWAY_URL="https://preprod.api.andamio.io"
ANDAMIO_API_KEY="your-preprod-api-key"
NEXT_PUBLIC_CARDANO_NETWORK="preprod"
NEXT_PUBLIC_ACCESS_TOKEN_POLICY_ID="29aa6a65f5c890cfa428d59b15dec6293bf4ff0a94305c957508dc78"Production (Mainnet)
NEXT_PUBLIC_ANDAMIO_GATEWAY_URL="https://mainnet.api.andamio.io"
ANDAMIO_API_KEY="your-mainnet-api-key"
NEXT_PUBLIC_CARDANO_NETWORK="mainnet"
NEXT_PUBLIC_ACCESS_TOKEN_POLICY_ID="<contact-team-for-mainnet-policy-id>"Moving to Production
When your app is tested and ready:
- Generate a mainnet API key at app.andamio.io/api-setup — you already have a mainnet Access Token from developer registration
- Update environment variables with production values above
- Contact the Andamio team for the mainnet Access Token policy ID
App Template Scripts
| Script | Description |
|---|---|
npm run dev | Start dev server with hot reload |
npm run build | Production build |
npm run check | Run linting and type checking |
npm run generate:types | Regenerate API types from gateway spec |
npm run preview | Build and serve locally |
API Health Checks
Verify gateway connectivity:
# Preprod
curl https://preprod.api.andamio.io/health
# Production
curl https://mainnet.api.andamio.io/health