API & SDK

API & SDK

Initiativ offers a programmable interface for clients and partners to interact with the platform directly, without relying on the web interface.

This includes:

  • Submitting and managing trades

  • Viewing account balances

  • Accessing market data

  • Automating reporting and compliance workflows

The interface is built using RESTful APIs, and will soon be extended with SDKs for Python, Node.js, and Go.

Why Use the API?

The API is designed for:

  • Automated traders who want to place and manage orders programmatically

  • Corporate accounts integrating Initiativ into their internal procurement or compliance systems

  • Auditors and partners requiring secure, read-only access to account data

  • Software developers building apps or tools on top of the Initiativ infrastructure

Use Case: Integrated Carbon Procurement for Industrial Clients

A metal smelting company calculates its internal emissions daily using its own monitoring software. The company uses Initiativ's API to:

  1. Pull in its carbon position from internal calculations (e.g. 12,350 tons of CO₂ emitted this month)

  2. Package a matching buy order on Initiativ for 12,350 EUAs, using the API

  3. The order is not submitted immediately — instead, it appears on a private dashboard (either Initiativ’s or their own)

  4. A compliance officer reviews the suggestion and confirms the trade via the dashboard

  5. Once approved, the order is automatically placed at the best available price on the market that day

This approach ensures full automation while keeping humans in control of execution timing and budget management.

Authentication & Access Control

  • Access to the API requires a unique API key and secret, issued through the Initiativ account dashboard.

  • Roles and permissions can be defined (e.g. read-only, trade-only, full access).

  • All API activity is logged and rate-limited for security.

Authentication follows standard OAuth2 and JWT token-based sessions.

Core Endpoints

Endpoint
Description

POST /orders

Submit a new order

GET /orders/{id}

Retrieve the status of an order

GET /balances

View permit and cash balances

GET /fees

Retrieve fee tier for current user

GET /market/ticker

View current market prices and depth

GET /transactions

Retrieve past trade history

Example – Order Submission (REST)

curl -X POST https://api.initiativ.io/orders \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "instrument": "EUA",
    "type": "limit",
    "side": "buy",
    "quantity": 1000,
    "price": 79.50
  }'
PreviousAutomations

Last updated