Skip to content

Getting Started

Follow the steps below to get up and running with the Viridian Integration API.

1. Request API Access

API access must be provisioned by AFS Energy BV. To request access, email support@afsenergy.nl.

Use the subject line [Integration API] Access Request and include your company name and intended use. Each API key is scoped to a single client company.

2. Register Your API Account

Once access is approved, you will receive an email invitation to register. After registering, log in to the Viridian Client Portal and navigate to API Settings. Here you can:

  • Generate your API key
  • Refresh your key if needed (note: this revokes the previous key immediately)
  • View details about your current key

3. Register a Webhook

Before submitting any integration requests, you must register a webhook endpoint. AFS Energy BV will use this URL to deliver priced offers to your system as soon as they are ready.

See Webhooks for how to register it.

4. Submit Your First Integration Request

With your webhook registered, you can submit a buy or sell interest for EU ETS allowances. The request is acknowledged immediately and expires 3 minutes after submission.

See Indication of Interest for how to submit a request.

5. Receive and Respond to an Offer

AFS Energy BV will price your request in real time and send an offer to your registered webhook. The offer contains a firm price and total notional value. You must accept or reject it before the integration request expires. If no response is received in time, the integration request moves to expired status and a new request must be submitted.

See Offers for how to accept or reject an offer.

Authentication

All requests are authenticated with your API key. See the Webhooks, Indication of Interest, and Offers guides for the request details.