{"info":{"_postman_id":"8a58357a-734f-4361-9eb3-c498bf9c817d","name":"GSH Trade Submission API Endpoints Reference","description":"

Status - under construction

This documentation presents the GSH EFP Trade Submission API Endpoints evolving design. It is updated as the technical requirements are streamlined.

Participants can commence their API development with these details. There may be small changes during testing and as we receive feedback.

Please provide feedback to: SupportHub@aemo.com.au

Purpose

The Gas Supply Hub (GSH) EFP Trade Submission Endpoints are part of the CapacityAuction API. Authorised participants can use them to submit and retrieve EFP Trade Submissions.

This documentation explains the standards, rules, context, conventions, parameters, and methods for the endpoints.

Audience

AEMO provides this information as a service targeting Registered Participants':

Business analysts and technology staff.
API developers.

\n\n

Assumed knowledge

An understanding of the following is required:

API and JSON fundamentals
Gas Supply Hub Industry Guide
[Guide to AEMO's e-Hub APIs](https://portal.prod.nemnet.net.au/help/Content/API_Reference/API_introduction.htm?TocPath=API Reference|_____0)
Guide to GSH EFP Trade Submission
Guide to Information Systems
RESTful programming architecture

Prerequisites

Before you can use the EFP Trade Submission Endpoints you must:

Have a Participant ID. If your company is a Registered Participant, it is set up during the registration process.
Have a user ID and password with access rights provided by your company's participant administrator. For details, see user rights access below.
Register with AEMO to use APIs.
Have an API gateway and a Certificate.
Test your submission in the pre-production environment before submitting to production. AEMO encourages participants to use the pre-production environment to test procedures and train staff.

StartFragment

Support hub resolver group

If you contact AEMO's Support Hub for help, ask them to direct your ticket to one of the following resolver groups:

Business: Gas Market Monitoring
Gas Scheduling Systems

Known issues

Price

In the submission, a valid price is entered with 2 decimal places, but the response appends a 0 after the decimal place e.g:

Submission 5.23
Response: 5.230

Volume

In the submission, a valid volume is entered as whole number, but the response appends a 0 after the decimal place e.g:

Submission 500
Response 500.0

Invalid csv structure

Submitting a POST request with an incorrect column name, returns a 200 response instead of 400 bad request.

Resources

API format

Input

The gasFutureUploadRequest has the following 2 input elements:

A request header.
A JSON schema (no query parameters or csv payloads).

Output

A JSON schema

Input and output protocol

HTTPS

API access

The EFP Trade Submission Endpoints are accessible over MarketNet only via AEMO's e-Hub API gateway. For details, see Guide to AEMO's e-Hub APIs.

Authentication

API connections use mTLS certificates to secure the transport layer with encrypted communication and
secure interactions between participants’ and AEMO’s systems.
AEMO issues mTLS certificates to participants on request.

Authorisation

API calls are authorised by Basic HTTP authentication (Basic Auth) using a username and password assigned by your company’s participant administrator. See Guide to User Rights Management (URM).

User rights access

The access right participant administrators provide for access to the CDR API is:

GSH Future Submission

For details about user rights access, creating new Participant Users and assigning rights, see Guide to User Rights Management (URM).

AEMO API portal

At the scheduled release time, API details, including Swagger/OAS files are available from AEMO’s API Portal:

Pre-production
Production

Compression

AEMO APIs support HTTPS protocol compression controlled by the HTTPS request header attributes, allowing compression before sending and responding. The EFP Trade Submission endpoints have the following compressed payload:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Value
Content-Encoding	gzip, compress, or deflate If not provided no compression is assumed
Accept-Encoding	gzip, compress, or deflate If not provided no compression is assumed

Throttling

TBC

To control traffic, AEMO implements Throttling on API Endpoint requests. If Participant ID requests exceed the Throttling limit a HTTP 429 or 422 response returns. For more details, see Response codes.

Endpoint	Limits
gasFutureUploadRequest	1 request per second per participantId. The participantId is identified from the X-initiatingParticipantID request header parameter. Participants systems must manage this Throttling limit because if you submit multiple JSON requests for the same participantId at the same time, AEMO may reject some.
gasFutureRequest	100 requests, per minute, per participantId

Endpoint

Limits

gasFutureUploadRequest

1 request per second per participantId.

The participantId is identified from the X-initiatingParticipantID request header parameter.

Participants systems must manage this Throttling limit because if you submit multiple JSON requests for the same participantId at the same time, AEMO may reject some.

gasFutureRequest

100 requests, per minute, per participantId

\n\n

Submission interfaces

There are several ways to submit a Trade:

Markets Portal web interface, see Markets Portal Help > Gas Supply Hub > GSH Future Submission.
Markets Portal upload csv payload interface, see Markets Portal Help > Gas Supply Hub > GSH Future Submission.
API (this guide)

Submission rules

The following submission rules apply:

The submission interfaces are only available during the Submission Period (EFP Trading Window). Trying to submit an EFP Trade Submission outside the window results in a response error. For details about the submission period, see Guide to EFP Trade Submission.
One JSON schema (itemList) can have many EFP Trade Records.
The schema must have the JSON extension.
The order of parameters in the schema does not matter.
The parameter format is important.
A record must consist of at least these required parameters: gasFutureId, startDate, endDate, tradeType, price, volume.
Each record is processed separately: Records passing validation are matched, records not passing validation are rejected, every listItem is validated.
The failure to pass validation of one record does not result in the rejection of all records (the entire Submission).
AEMO informs Trading Participants of the validation status.
Records not passing validation are not effective and you must resubmit them.
The latest Pending record is the effective record.
If there are multiple records with the same Gas Future ID, AEMO uses the most recent record.
The reports are triggered on a valid record.

Submission status

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Description
FAIL	The record did not pass validation
PENDING	The Preliminary EFP Trade Submission passed validation and is included in the Forward Exposure Prudential calculation
OVERRIDE	A recent EFP Trade Submission record replaced this trade
MATCH	The EPF trade is created and no longer included in the Forward Exposure Prudential calculation

Changing a pending trade

To change the details of a Pending EFP Trade Record, submit a new gasFutureUploadRequest for the same Trade with the changed details. Providing the record is valid, the status for the original PENDING trade record changes to OVERRIDE and the new one is the PENDING record.

Validation

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Message	Status
participantId	Submission rejected because the Trading Participant is not registered in the GSH	FAIL
price	Enter a price range between minus 100 and 999 e.g: 1050.23	FAIL
price	Enter a price with only 2 decimal places, e.g: 1050.23	FAIL
price	Submission rejected because the Final EFP Trade Submission Price must match the Preliminary EFP Trade Submission Price	FAIL
price (trading margin)	Submission rejected because the has insufficient Trading Margin	FAIL
tradeType	Enter a trade type of either: BUY or SELL	FAIL
gasFutureId	Enter your EFP Trade ID (Gas Future ID) for the Final EFP Trade Submission	FAIL
gasFutureId	The Gas Future ID cannot be more than 20 characters e.g: ASX-AEMO-1364-AB3267	FAIL
gasFutureId	The Gas Future ID must in this format XXX-AEMO-XXXX-XXXXX e.g: ASX-AEMO-1364-AB3267	FAIL
gasFutureId	Submission rejected because this Gas Future ID is previously matched. The Gas Future ID must be unique for each BUY/SELL trade pair	FAIL
volume	Enter a positive whole number for the volume, e.g: 234	FAIL
endDate	Enter an end date in the following format: YYYY/MM/DD or DD/MM/YYYY, e.g: 2022/04/30	FAIL
startDate	Enter a start date in the following format: YYYY/MM/DD or DD/MM/YYYY,, e.g: 2022/04/30	FAIL
endDate & startDate	The start and end date must match the Preliminary EFP Trade Submission	FAIL
all fields	Submission matched	MATCHED
all fields	Submission successful	PENDING

Response times

Connection timeout 10 seconds.
Response timeout (including connection timeout) 30 seconds.

Response codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description	Scenario
200	OK	The Authorization (Basic Auth) and Header parameters are correct so a Successful response returns
400	Mandatory header X-initiatingParticipantID is missing and/or Mandatory header X-Market is missing	One of the mandatory header parameters, initiatingParticipantID or X-Market are missing
401	Unauthorized	The Authorization credentials, Username or Password are entered incorrectly or invalid The e-Hub also sends the following payload: {\"Exception\": \"Unauthorized:Invalid UserName or Password\"}
403	Invalid Role	The participantId does not have access to the API. For help, see TLS Certificates
404	Resources for the endpoint URI not found	The URI details are incorrect
405	Method not allowed	The request method is invalid, e.g. GET instead of POST
422	Unprocessable Entity	The API content failed business validation rules.
422	Primary Key Violation (A Bid/Offer already exists for the same time)	This message is equivalent to 429 Too Many Requests. Due to a backend process error where the request slips through the throttling validation and triggers a primary key violation. Wait and retry the submission
429	Too Many Requests	Possible reasons: * The requests exceed the throttling limit of 1 request per second. Wait and retry the submission * A primary key violation due to a backend process error where the request slips through the throttling validation and triggers a primary key violation. Wait and retry the submission
500	Application Unavailable	Possible reasons: * The Certificate or key do not match * The AEMO Gateway is unavailable. Wait and retry the submission
502	Bad Gateway	The AEMO Gateway is unavailable. Wait and retry the submission
503	Exceeds throttling Limits	429 Too Many Requests replaces this response code

Reports

The following private reports are sent to relevant Trading Participants:

Trade Execution Report: Provides EFP Trade Information each time there is an EFP Trade Submission and at the end of each Business Day.
GSH Future Trade Submission Report: Provides EFP Trade Information each time there is an EFP Trade Submission and EFP Trade match.

Report Delivery

You can retrieve the report using the following methods:

GSH Publishing Direct
Participant File Server
Data Model/Data Interchange

For details, see Guide to EFP Trade Submission.

Gas Data Model

Participants with Data Interchange environments can retrieve their EFP Trade Submission data from the following tables and files.

For help, see Data interchange online help.

Tables

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Table name	Description	Visibility
GSH.TRADES_STAGING	Populated whenever an EFP trade is submitted to AEMO	Private
GSH_TRADES	Populated each time there is an EFP Trade submission, match, and trade creation	Private

Files

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Table name	Description	When	Recipient	Visibility
GSH_TRADE_SINGLE	Provides a confirmation to Trading Participants (buyer and seller) when a trade is executed through auto matching of bids, offers, submissions or by off-Market trades	On trade submission	Trading Participants (buyer and seller)	Private
GSH_TRADE_RANGE	Provides Trading Participants with a list of their EFP trades	At the end of the Gas Day	Trading Participants	Private
GSH_FUTURE_TRADE_SINGLE	Contains all relevant records from EFP Trade submissions	On EFP Trade Submission	Trading participants	Private

API endpoints and response details

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Status - under construction","slug":"status-under-construction"},{"content":"Purpose","slug":"purpose"},{"content":"Audience","slug":"audience"},{"content":"Related rules and procedures","slug":"related-rules-and-procedures"},{"content":"Assumed knowledge","slug":"assumed-knowledge"},{"content":"Prerequisites","slug":"prerequisites"},{"content":"Support hub resolver group","slug":"support-hub-resolver-group"},{"content":"Known issues","slug":"known-issues"},{"content":"Resources","slug":"resources"},{"content":"API format","slug":"api-format"},{"content":"Input and output protocol","slug":"input-and-output-protocol"},{"content":"API access","slug":"api-access"},{"content":"Authentication","slug":"authentication"},{"content":"Authorisation","slug":"authorisation"},{"content":"User rights access","slug":"user-rights-access"},{"content":"AEMO API portal","slug":"aemo-api-portal"},{"content":"Compression","slug":"compression"},{"content":"Throttling","slug":"throttling"},{"content":"Submission interfaces","slug":"submission-interfaces"},{"content":"Submission rules","slug":"submission-rules"},{"content":"Submission status","slug":"submission-status"},{"content":"Changing a pending trade","slug":"changing-a-pending-trade"},{"content":"Validation","slug":"validation"},{"content":"Response times","slug":"response-times"},{"content":"Response codes","slug":"response-codes"},{"content":"Reports","slug":"reports"},{"content":"Report Delivery","slug":"report-delivery"},{"content":"Gas Data Model","slug":"gas-data-model"},{"content":"API endpoints and response details","slug":"api-endpoints-and-response-details"}],"owner":"10342609","collectionId":"8a58357a-734f-4361-9eb3-c498bf9c817d","publishedId":"UVz1Nrz4","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"492249","highlight":"B766C2"},"publishDate":"2022-04-13T04:22:59.000Z"},"item":[{"name":"gasFutureUploadRequest","id":"d73ac0eb-ae20-4df9-8e2a-79d7902fee83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"ItemList\": [\r\n {\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"StartDate\": \"2022/07/01\",\r\n \"EndDate\": \"2022/07/31\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": \"3\",\r\n \"Volume\": \"4\"\r\n\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureUploadRequest","urlObject":{"protocol":"https","port":"9319","path":["ws","gsh","capacityAuction","v1","gasFutureUploadRequest"],"host":["apis","prod","marketnet","net","au"],"query":[{"disabled":true,"description":{"content":"

The submission records. One submission can have several records. Required.

\n","type":"text/plain"},"key":"itemList","value":"Object"},{"disabled":true,"description":{"content":"

{gasFutureId, startDate, endDate, tradeType, price, volume}

\n","type":"text/plain"},"key":"record","value":"Object"},{"disabled":true,"description":{"content":"

The EFP Trade identifier for each BUY/SELL trade. Format: ASX-AEMO-nnnn-NNNNN, example: ASX-AEMO-1234-AA5678, required for a Final EFP Trade Submission, optional for a preliminary EFP Trade Submission.

\n","type":"text/plain"},"key":"gasFutureId","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

The gas start day for the EFP Trade Submission period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03, Required.

\n","type":"text/plain"},"key":"startDate","value":"DATE"},{"disabled":true,"description":{"content":"

The gas end day for the EFP Trade Submission period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03, required.

\n","type":"text/plain"},"key":"endDate","value":"DATE"},{"disabled":true,"description":{"content":"

Buy or sell. Format: alphanumeric letters only.

\n","type":"text/plain"},"key":"tradeType","value":"VARCHAR2(10)"},{"disabled":true,"description":{"content":"

Trade price. Format: Australian dollars, no currency symbol, no spaces, format: 000000000000000000.00, 2 decimal places, allow negative and positive values between -$100 and $999, example: 5.23, required.

\n","type":"text/plain"},"key":"price","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

EFP Trade quantities for each Gas Day in the Delivery Period, format: Gigajoules (GJ), whole number, positive values only, max limit 50000 GJ, required.

\n","type":"text/plain"},"key":"volume","value":"NUMBER(18,8)"}],"variable":[]}},"response":[{"id":"6016951f-4b6c-4af4-8562-22c4fc5607e5","name":"gasFutureUploadRequest - example","originalRequest":{"method":"POST","header":[{"key":"X-initiatingParticipantID","value":"NEMRESTR","type":"text","description":"String","disabled":true},{"key":"X-market","value":"GSH","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text","disabled":true},{"key":"Content-encoding","value":"gzip or deflate","type":"text","disabled":true},{"key":"Accept-Encoding","value":"gzip or deflate","type":"text","disabled":true},{"key":"Authorization","value":"Basic","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"ItemList\": [\r\n {\r\n \"GasFutureId\": \"ASX-AEMO-2345-333AB123\",\r\n \"StartDate\": \"2022/05/01\",\r\n \"EndDate\": \"2022/05/31\",\r\n \"TradeType\": \"SELL\",\r\n \"Price\": \"12.3\",\r\n \"Volume\": \"344\",\r\n },\r\n {\r\n \"GasFutureId\": \"ASX-AEMO-2345-333AB166\",\r\n \"StartDate\": \"2022/05/01\",\r\n \"EndDate\": \"2022/05/31\",\r\n \"TradeType\": \"SELL\",\r\n \"Price\": \"38.3\",\r\n \"Volume\": \"120\",\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureUploadRequest","protocol":"https","host":["apis","prod","marketnet","net","au"],"port":"9319","path":["ws","gsh","capacityAuction","v1","gasFutureUploadRequest"],"query":[{"key":"itemList","value":"Object","description":"The submission records. One submission can have several records. Required.","type":"text","disabled":true},{"key":"record","value":"Object","description":"{gasFutureId, startDate, endDate, tradeType, price, volume}","type":"text","disabled":true},{"key":"gasFutureId","value":"VARCHAR2(20)","type":"text","description":"The EFP trade identifier for each BUY/SELL trade. Format: ASX-AEMO-nnnn-NNNNN, example: ASX-AEMO-1234-AA5678, required for a final transfer, optional for a preliminary transfer. ","disabled":true},{"key":"startDate","value":"DATE","type":"text","description":"The gas start day for the gas future trade period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03, Required.","disabled":true},{"key":"endDate","value":"DATE","type":"text","description":"The gas end day for the gas future trade period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03, required.","disabled":true},{"key":"tradeType","value":"VARCHAR2(10)","type":"text","description":"Buy or sell. Format: alphanumeric letters only.","disabled":true},{"key":"price","value":"NUMBER(18,8)","type":"text","description":"Trade price. Format: Australian dollars, no currency symbol, format: 000000000000000000.00, 2 decimal places, allow negative and positive values between -$100 and $999, example: 5.23, required.","disabled":true},{"key":"volume","value":"NUMBER(18,8)","type":"text","description":"EFP Trade quantities for each Gas Day in the Delivery Period, format: Gigajoules (GJ), whole number, positive values only, max limit 50000 GJ, required.","disabled":true}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"d73ac0eb-ae20-4df9-8e2a-79d7902fee83"},{"name":"GasFutureUploadRequest - response","id":"f4bdcae5-06a3-4423-9df0-e3e665312ad5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":false},"method":"RESPONSE","header":[],"body":{"mode":"raw","raw":"{\r\n \"transactionId\": \"1ff59f8a-4057-4644-9fec-7aea321c96ee\",\r\n \"data\": {\r\n \"CallSuccessful\": true,\r\n \"CallResponseMessage\": \"GSH EFP Trade Data Request completed.\",\r\n \"ItemList\": [\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33984,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"PENDING\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-06-08T00:00:29\",\r\n \"LastChanged\": \"2022-06-08T00:00:29\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33983,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"OVERRIDE\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-06-07T22:56:37\",\r\n \"LastChanged\": \"2022-06-08T00:00:29\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33982,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"OVERRIDE\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-06-07T12:20:07\",\r\n \"LastChanged\": \"2022-06-07T22:56:37\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33981,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": null,\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"SELL\",\r\n \"Price\": 126.0,\r\n \"Volume\": 126.0,\r\n \"TradeValue\": 15876.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter Gas future ID for the final transfer\",\r\n \"SubmittedTime\": \"2022-06-07T12:19:56\",\r\n \"LastChanged\": \"2022-06-07T12:19:56\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33980,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": null,\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"SELL\",\r\n \"Price\": 125.0,\r\n \"Volume\": 125.0,\r\n \"TradeValue\": 15625.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter Gas future ID for the final transfer\",\r\n \"SubmittedTime\": \"2022-06-07T12:18:37\",\r\n \"LastChanged\": \"2022-06-07T12:18:37\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33979,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": null,\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 123.0,\r\n \"Volume\": 123.0,\r\n \"TradeValue\": 15129.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter Gas future ID for the final transfer\",\r\n \"SubmittedTime\": \"2022-06-07T12:15:27\",\r\n \"LastChanged\": \"2022-06-07T12:15:27\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33978,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": null,\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 33.0,\r\n \"Volume\": 3333.0,\r\n \"TradeValue\": 109989.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter Gas future ID for the final transfer\",\r\n \"SubmittedTime\": \"2022-06-07T12:11:41\",\r\n \"LastChanged\": \"2022-06-07T12:11:41\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33977,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-06-01T00:00:00\",\r\n \"EndDate\": \"2022-06-30T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01\",\r\n \"SubmittedTime\": \"2022-06-07T11:55:54\",\r\n \"LastChanged\": \"2022-06-07T11:55:54\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33976,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-06-01T00:00:00\",\r\n \"EndDate\": \"2022-06-30T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01\",\r\n \"SubmittedTime\": \"2022-06-07T11:55:25\",\r\n \"LastChanged\": \"2022-06-07T11:55:25\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33975,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-06-01T00:00:00\",\r\n \"EndDate\": \"2022-06-30T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter a valid start date in the following format : YYYY/MM/DD. e.g: 2022/07/01\",\r\n \"SubmittedTime\": \"2022-06-07T11:54:58\",\r\n \"LastChanged\": \"2022-06-07T11:54:58\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33974,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": null,\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 222.0,\r\n \"Volume\": 222.0,\r\n \"TradeValue\": 49284.0,\r\n \"Status\": \"FAIL\",\r\n \"ValidationMsg\": \"Enter Gas future ID for the final transfer\",\r\n \"SubmittedTime\": \"2022-06-07T11:49:29\",\r\n \"LastChanged\": \"2022-06-07T11:49:29\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33973,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-DEMO-344\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 3.0,\r\n \"Volume\": 4.0,\r\n \"TradeValue\": 12.0,\r\n \"Status\": \"OVERRIDE\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-06-07T11:30:04\",\r\n \"LastChanged\": \"2022-06-07T12:20:07\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 33963,\r\n \"ParticipantId\": \"2012\",\r\n \"GasFutureId\": \"ASX-AEMO-0012\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-07-01T00:00:00\",\r\n \"EndDate\": \"2022-07-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 2.0,\r\n \"Volume\": 2.0,\r\n \"TradeValue\": 4.0,\r\n \"Status\": \"PENDING\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-06-02T10:41:56\",\r\n \"LastChanged\": \"2022-06-02T10:41:56\"\r\n }\r\n ]\r\n },\r\n \"errors\": []\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureUploadRequest","urlObject":{"protocol":"https","port":"9319","path":["ws","gsh","capacityAuction","v1","gasFutureUploadRequest"],"host":["apis","prod","marketnet","net","au"],"query":[{"disabled":true,"description":{"content":"

The unique identifier of the record.

\n","type":"text/plain"},"key":"recordID","value":"VARCHAR2(20)"},{"disabled":true,"key":"data","value":"Object"},{"disabled":true,"description":{"content":"

Message

\n","type":"text/plain"},"key":"callSuccessful","value":""},{"disabled":true,"description":{"content":"

Message

\n","type":"text/plain"},"key":"callResponseMessage","value":""},{"disabled":true,"description":{"content":"

List of submitted records.

\n","type":"text/plain"},"key":"itemList","value":"Object"},{"disabled":true,"description":{"content":"

The EFP trade identifier for each BUY/SELL trade if submitted.

\n","type":"text/plain"},"key":"gasFutureId","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

The gas start day for the EFP Trade Submission period. Format: YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"startDate","value":"DATE"},{"disabled":true,"description":{"content":"

The gas end day for the EFP Trade Submission period. Format: YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"endDate","value":"DATE"},{"disabled":true,"description":{"content":"

Buy or sell. Format: alphanumeric letters only.

\n","type":"text/plain"},"key":"tradeType","value":"VARCHAR2(10)"},{"disabled":true,"description":{"content":"

Trade price. Format: Australian dollars, no currency symbol, no spaces, format: 00.00, 2 decimal places, allow negative and positive values between -$100 and $999, example: 5.23.\nKNOWN ISSUE: A valid price is entered as 2 decimal places, but the response appends a 0 after the decimal place e.g submission: 5.23 and response: 5.230.

\n","type":"text/plain"},"key":"price","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

EFP Trade quantities for each Gas Day in the Delivery Period, format: Gigajoules (GJ), whole number, positive values only, max limit 50000 GJ.\nKNOWN ISSUE: A valid volume is entered as whole number, but the response appends a 0 after a decimal place e.g submission: 500 and response: 500.0.

\n","type":"text/plain"},"key":"volume","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

Status of submission: PENDING, OVERRIDE, FAIL, MATCH.

\n","type":"text/plain"},"key":"Status","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

Validation message

\n","type":"text/plain"},"key":"validationMsg","value":"VARCHAR2(255)"},{"disabled":true,"description":{"content":"

The date and time the EFP Trade was submitted

\n","type":"text/plain"},"key":"submittedTime","value":"DATE"},{"disabled":true,"key":"lots","value":""},{"disabled":true,"description":{"content":"

List of validation errors

\n","type":"text/plain"},"key":"errors","value":"Object"}],"variable":[]}},"response":[],"_postman_id":"f4bdcae5-06a3-4423-9df0-e3e665312ad5"},{"name":"gasFutureRequest","id":"38e03061-c7ea-4fdf-8032-f38115f6d8a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"ItemList\": [\r\n {\r\n \"GasFutureId\": \"ASX-AEMO-1234-3A4D7E\",\r\n \"StartDate\": \"2022/08/01\",\r\n \"EndDate\": \"2022/08/31\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": \"34.45\",\r\n \"Volume\": \"27\"\r\n },\r\n {\r\n \"GasFutureId\": \"ASX-AEMO-1237-55AEZ8\",\r\n \"StartDate\": \"2022/08/01\",\r\n \"EndDate\": \"2022/08/31\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": \"12.34\",\r\n \"Volume\": \"23\"\r\n } \r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureRequest","description":"

Receive EFP Trade submissions

\n","urlObject":{"protocol":"https","port":"9319","path":["ws","gsh","capacityAuction","v1","gasFutureRequest"],"host":["apis","prod","marketnet","net","au"],"query":[{"disabled":true,"description":{"content":"

The record request details. Required.

\n","type":"text/plain"},"key":"itemList","value":"Object"},{"disabled":true,"description":{"content":"

{gasFutureId, startDate, endDate, tradeType, price, volume}

\n","type":"text/plain"},"key":"record","value":"Object"},{"disabled":true,"description":{"content":"

The EFP Trade identifier for each BUY/SELL trade. Format: ASX-AEMO-nnnn-NNNNN, example: ASX-AEMO-1234-AA5678.

\n","type":"text/plain"},"key":"gasFutureId","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

The gas start day for the EFP Trade Submission period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"startDate","value":"DATE"},{"disabled":true,"description":{"content":"

The gas end day for the EFP Trade Submission period. Format: DD/MM/YYYY or YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"endDate","value":"DATE"},{"disabled":true,"description":{"content":"

Buy or sell. Format: alphanumeric letters only.

\n","type":"text/plain"},"key":"tradeType","value":"VARCHAR2(10)"},{"disabled":true,"description":{"content":"

Trade price. Format: Australian dollars, no currency symbol, format: 000000000000000000.00, 2 decimal places, allow negative and positive values between -$100 and $999, example: 5.23,

\n","type":"text/plain"},"key":"price","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

EFP Trade quantities for each Gas Day in the Delivery Period, format: Gigajoules (GJ), whole number, positive values only, max limit 50000 GJ.

\n","type":"text/plain"},"key":"volume","value":"NUMBER(18,8)"}],"variable":[]}},"response":[{"id":"9323bfa5-893b-4aac-a1ef-8b162d793a15","name":"gasFutureRequest - example","originalRequest":{"method":"GET","header":[{"key":"X-initiatingParticipantID","value":"NEMRESTR","type":"text","disabled":true},{"key":"X-market","value":"GSH","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text","disabled":true},{"key":"Content-encoding","value":"gzip or deflate","type":"text","disabled":true},{"key":"Accept-Encoding","value":"gzip or deflate","type":"text","disabled":true},{"key":"Authorization","value":"Basic","type":"text","disabled":true}],"url":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureRequest"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"ItemList\": [\n {\n \"GasFutureId\": \"ASX-AEMO-1234-3A4D7E\",\n \"StartDate\": \"2022/08/01\",\n \"EndDate\": \"2022/08/31\",\n \"TradeType\": \"BUY\",\n \"Price\": \"34.45\",\n \"Volume\": \"27\"\n },\n {\n \"GasFutureId\": \"ASX-AEMO-1237-55AEZ8\",\n \"StartDate\": \"2022/08/01\",\n \"EndDate\": \"2022/08/31\",\n \"TradeType\": \"BUY\",\n \"Price\": \"12.34\",\n \"Volume\": \"23\"\n }\n ]\n}"}],"_postman_id":"38e03061-c7ea-4fdf-8032-f38115f6d8a5"},{"name":"gasFutureRequest","id":"d9c6ac43-cf0b-45b8-853b-c88ef9fdf17d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"basic","basic":{"basicConfig":[]},"isInherited":false},"method":"RESPONSE","header":[],"body":{"mode":"raw","raw":"{\r\n \"transactionId\": \"31fdabbb-91b0-47fd-8f36-81c56a62dc29\",\r\n \"data\": {\r\n \"CallSuccessful\": true,\r\n \"CallResponseMessage\": \"GSH EFP Trade Submission Data Request completed.\",\r\n \"ItemList\": [\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 31968,\r\n \"ParticipantId\": \"2006\",\r\n \"GasFutureId\": \"ASX-AEMO-1237-55AEZ8\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-08-01T00:00:00\",\r\n \"EndDate\": \"2022-08-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 12.34,\r\n \"Volume\": 23.0,\r\n \"TradeValue\": 283.82,\r\n \"Status\": \"PENDING\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-07-01T09:27:37\",\r\n \"LastChanged\": \"2022-07-01T09:27:37\"\r\n },\r\n {\r\n \"MarketId\": \"GSH\",\r\n \"RecordId\": 31967,\r\n \"ParticipantId\": \"2006\",\r\n \"GasFutureId\": \"ASX-AEMO-1234-3A4D7E\",\r\n \"ProductGroupCode\": \"GAS-WAL\",\r\n \"ProductTypeCode\": \"Gas - NG Months\",\r\n \"DeliveryPoint\": \"WAL HP Trade Point\",\r\n \"StartDate\": \"2022-08-01T00:00:00\",\r\n \"EndDate\": \"2022-08-31T00:00:00\",\r\n \"TradeType\": \"BUY\",\r\n \"Price\": 34.45,\r\n \"Volume\": 27.0,\r\n \"TradeValue\": 930.15,\r\n \"Status\": \"PENDING\",\r\n \"ValidationMsg\": null,\r\n \"SubmittedTime\": \"2022-07-01T09:27:36\",\r\n \"LastChanged\": \"2022-07-01T09:27:37\"\r\n }\r\n ]\r\n },\r\n \"errors\": []\r\n}"},"url":"https://apis.prod.marketnet.net.au:9319/ws/gsh/capacityAuction/v1/gasFutureRequest","urlObject":{"protocol":"https","port":"9319","path":["ws","gsh","capacityAuction","v1","gasFutureRequest"],"host":["apis","prod","marketnet","net","au"],"query":[{"disabled":true,"key":"transactionId","value":"STRING"},{"disabled":true,"key":"data","value":"Object"},{"disabled":true,"key":"callSuccessful","value":""},{"disabled":true,"key":"callResponseMessage","value":""},{"disabled":true,"description":{"content":"

List of submitted records.

\n","type":"text/plain"},"key":"itemList","value":"Object"},{"disabled":true,"description":{"content":"

The unique identifier of the record.

\n","type":"text/plain"},"key":"recordID","value":"VARCHAR2(20)"},{"disabled":true,"key":"participantId","value":""},{"disabled":true,"description":{"content":"

The EFP Trade identifier for each BUY/SELL trade if submitted.

\n","type":"text/plain"},"key":"gasFutureId","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

The gas start day for the EFP Trade Submission period. Format: YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"startDate","value":"DATE"},{"disabled":true,"description":{"content":"

The gas end day for the EFP Trade Submission period. Format: YYYY/MM/DD, include leading zeros, example: 2022/09/03.

\n","type":"text/plain"},"key":"endDate","value":"DATE"},{"disabled":true,"description":{"content":"

Buy or sell. Format: alphanumeric letters only.

\n","type":"text/plain"},"key":"tradeType","value":"VARCHAR2(10)"},{"disabled":true,"description":{"content":"

Trade price. Format: Australian dollars, no currency symbol, format: 000000000000000000.00, 2 decimal places, allow negative and positive values between -$100 and $999, example: 5.23.

\n","type":"text/plain"},"key":"price","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

EFP Trade quantities for each Gas Day in the Delivery Period, format: Gigajoules (GJ), whole number, positive values only, max limit 50000 GJ.

\n","type":"text/plain"},"key":"volume","value":"NUMBER(18,8)"},{"disabled":true,"description":{"content":"

Status of submission: PENDING, OVERRIDE, FAIL, MATCH

\n","type":"text/plain"},"key":"Status","value":"VARCHAR2(20)"},{"disabled":true,"description":{"content":"

Validation message

\n","type":"text/plain"},"key":"validationMsg","value":"VARCHAR2(255)"},{"disabled":true,"description":{"content":"

The date and time the EFP Trade was submitted

\n","type":"text/plain"},"key":"submittedTime","value":"DATE"},{"disabled":true,"description":{"content":"

List of validation errors

\n","type":"text/plain"},"key":"errors","value":"Object"}],"variable":[]}},"response":[],"_postman_id":"d9c6ac43-cf0b-45b8-853b-c88ef9fdf17d"}]}