Automate your energy and carbon trading.
emsTradepoint (ETP) offers two complementary ways to connect your systems to New Zealand’s wholesale gas and NZU markets:
- Webhooks – push notifications that tell you the moment any order or trade changes.
- Exchange REST API – a full-featured interface for placing orders, pulling live market data, and running analytics.
Used together, these tools let you build anything from lightweight dashboards to fully automated trading engines. This page explains when to use each option, how they work, and where to find the detailed developer docs.
Webhooks vs API
Webhooks push trading events to you the instant they happen—no polling, fewer API calls, lighter infrastructure. If you only need to react to orders and trades in real time, start with webhooks and use the REST API only to pull full detail once you know an event ID.
Feature | Webhooks (preferred) | Exchange API |
---|---|---|
Latency | Sub-second event delivery | Depends on polling interval |
Bandwidth | One tiny JSON per event | Repeated GETs even when nothing changes |
Use case | “Tell me the moment anything moves” | Trade programmatically, bulk data queries |
Typical pattern | Receive → 200 OK → Look-up via API | Authenticate → Request → Process |
Real-Time Webhooks
What events fire?
- New / Changed Order – any bid or offer placed, modified, or withdrawn
- New / Voided Trade – every executed or cancelled trade
(Events include all market activity, not just your own orders.)
Request a webhook
Email: supportdesk@emstradepoint.co.nz with:
Field | Example |
---|---|
Type | New/Changed Order and New/Voided Trade |
HTTP Method | POST |
URL | https://yourserver.com/api/webhook |
Authentication | None (IDs only, no sensitive data) or OAuth |
Exchange REST API
Use the REST endpoints when you need to place or manage orders, pull historical data, or build analytics.
- Base URLs
- Production https://exchange.emsTradepoint.co.nz/api/v1
- UAT https://uat-exchange.emsTradepoint.co.nz/api/v1
- Auth OAuth 2.0 client-credentials (tokens last 2 h).
- Markets Gas (OTD, DA) & Carbon (NZUs) + indices (FRMI/FRQI, ECMI/ECQI).
Choosing the Right Tool
Need | Recommended path |
---|---|
Real-time alerts / dashboards | Webhooks + lookup via API |
Algo-trading, order management | REST API |
End-of-day reconciliation | REST API bulk queries |
Lightweight integration | Webhooks only |
Compliance & Credentials ⚠️
All API and webhook activity is governed by emsTradepoint Market Rules. Automated trades are subject to the same limits, licensing terms, and enforcement as manual screen trades. Breaches can lead to suspension—review the rules before integrating.
Resources & Support
-
emsTradepoint Webhooks Guide pdf 515.3 KB
-
emsTradepoint API Guide 2.0 docx 4.6 MB
Support
Service Desk – supportdesk@emstradepoint.co.nz · +64 4 590 6692
Ready to start?
1. Enable your company’s webhooks (fastest path to live data).
2. Explore the API in UAT to retrieve full order & trade detail.
3. Once your integration passes UAT, apply for production credentials and trade with confidence.