API Key Management

API Usage requires a unique API Key, which must be requested by contacting: support@monark-markets.com
Keys are issued as standard API Keys. API Keys are environment-specific.
Use the issued API Key in an HTTP Header like this: Authorization: <Api Key>
Monark currently supports two environments for partners:
- Sandbox (sandbox-api.monark-markets.com): For API testing, integration, and conformance testing checks.
- Production (api.monark-markets.com): For live operations.
Always keep your API Keys secure. Avoid hardcoding them into applications and rotate them regularly as a security best practice.

Rate Limiting

Individual rate limits apply to each endpoint. If you encounter rate-limiting issues, reach out to support@monark-markets.com for assistance.
Monitor your usage to ensure uninterrupted access to the API.

Idempotency

Idempotent API operations guarantee that multiple identical requests produce the same result as a single request. Our API supports idempotency via the optional IdempotencyKey header—a unique client-generated identifier that prevents duplicate operations.

The IdempotencyKey header is:

Optional and only applicable for POST requests
Valid for 24 hours from first use
Client-generated (any unique string)

When a POST request fails or times out, you can retry with the same IdempotencyKey within the 24-hour window to ensure the operation is processed exactly once, preventing unintended duplications. Keys expire after 24 hours, so ensure retries occur within this timeframe.

Example header:

IdempotencyKey: 123e4567-e89b-12d3-a456-426614174000

Documentation and Support

All available endpoints are documented in detail on the following pages. Refer to them for specifics on each API call.
For additional help, contact support@monark-markets.com