PUT FuturesMonth/PutFuturesMonthFull

Update a futures month

Request Information

URI Parameters

Body Parameters

ClsSkyGrFuturesPriceUpdate
NameDescriptionTypeAdditional Information
LocationIdOrGuidForTimeStamp

Location ID or GUID to get the current date and time stamp to use for audit tracking of the Pricing records

 string

Required

Max length: 36
Data

The list of pricing records to update

 Collection of ClsSkyGrFuturesPriceUpdateDetail

Required

List cannot be empty

Request Formats

application/json, text/json

Sample: 
{
  "LocationIdOrGuidForTimeStamp": "sample string 3",
  "Data": [
    {
      "GRFuturesPriceKey": 1,
      "CommodityId": "sample string 3",
      "LocationId": "sample string 4",
      "ExchangeId": "sample string 5",
      "BidCriteriaId": "sample string 6",
      "FutMonth": "sample string 7",
      "StartingDeliveryPeriod": "2025-11-28T17:59:30.3793216+00:00",
      "EndingDeliveryPeriod": "2025-11-28T17:59:30.3793216+00:00",
      "FutMoEndDate": "2025-11-28T17:59:30.3793216+00:00",
      "FuturesPrice": 1.1,
      "FuturesPriceDateTimeLocal": "2025-11-28T17:59:30.3793216+00:00",
      "BasisPrice": 1.1,
      "BasisDateTimeLocal": "2025-11-28T17:59:30.3793216+00:00",
      "CommoditySymbol": "sample string 8",
      "FutureMonthAliasId": "sample string 9",
      "IndustryCode": "sample string 10"
    },
    {
      "GRFuturesPriceKey": 1,
      "CommodityId": "sample string 3",
      "LocationId": "sample string 4",
      "ExchangeId": "sample string 5",
      "BidCriteriaId": "sample string 6",
      "FutMonth": "sample string 7",
      "StartingDeliveryPeriod": "2025-11-28T17:59:30.3793216+00:00",
      "EndingDeliveryPeriod": "2025-11-28T17:59:30.3793216+00:00",
      "FutMoEndDate": "2025-11-28T17:59:30.3793216+00:00",
      "FuturesPrice": 1.1,
      "FuturesPriceDateTimeLocal": "2025-11-28T17:59:30.3793216+00:00",
      "BasisPrice": 1.1,
      "BasisDateTimeLocal": "2025-11-28T17:59:30.3793216+00:00",
      "CommoditySymbol": "sample string 8",
      "FutureMonthAliasId": "sample string 9",
      "IndustryCode": "sample string 10"
    }
  ]
}

application/xml, text/xml

Sample: 
<FuturesPriceUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SKY.Core.Grain">
  <Data>
    <FuturesPriceUpdateDetail>
      <BasisDateTimeLocal>2025-11-28T17:59:30.3793216+00:00</BasisDateTimeLocal>
      <BasisPrice>1.1</BasisPrice>
      <BidCriteriaId>sample string 6</BidCriteriaId>
      <CommodityId>sample string 3</CommodityId>
      <CommoditySymbol>sample string 8</CommoditySymbol>
      <EndingDeliveryPeriod>2025-11-28T17:59:30.3793216+00:00</EndingDeliveryPeriod>
      <ExchangeId>sample string 5</ExchangeId>
      <FutMoEndDate>2025-11-28T17:59:30.3793216+00:00</FutMoEndDate>
      <FutMonth>sample string 7</FutMonth>
      <FutureMonthAliasId>sample string 9</FutureMonthAliasId>
      <FuturesPrice>1.1</FuturesPrice>
      <FuturesPriceDateTimeLocal>2025-11-28T17:59:30.3793216+00:00</FuturesPriceDateTimeLocal>
      <IndustryCode>sample string 10</IndustryCode>
      <LocationId>sample string 4</LocationId>
      <StartingDeliveryPeriod>2025-11-28T17:59:30.3793216+00:00</StartingDeliveryPeriod>
      <GRFuturesPriceKey>1</GRFuturesPriceKey>
    </FuturesPriceUpdateDetail>
    <FuturesPriceUpdateDetail>
      <BasisDateTimeLocal>2025-11-28T17:59:30.3793216+00:00</BasisDateTimeLocal>
      <BasisPrice>1.1</BasisPrice>
      <BidCriteriaId>sample string 6</BidCriteriaId>
      <CommodityId>sample string 3</CommodityId>
      <CommoditySymbol>sample string 8</CommoditySymbol>
      <EndingDeliveryPeriod>2025-11-28T17:59:30.3793216+00:00</EndingDeliveryPeriod>
      <ExchangeId>sample string 5</ExchangeId>
      <FutMoEndDate>2025-11-28T17:59:30.3793216+00:00</FutMoEndDate>
      <FutMonth>sample string 7</FutMonth>
      <FutureMonthAliasId>sample string 9</FutureMonthAliasId>
      <FuturesPrice>1.1</FuturesPrice>
      <FuturesPriceDateTimeLocal>2025-11-28T17:59:30.3793216+00:00</FuturesPriceDateTimeLocal>
      <IndustryCode>sample string 10</IndustryCode>
      <LocationId>sample string 4</LocationId>
      <StartingDeliveryPeriod>2025-11-28T17:59:30.3793216+00:00</StartingDeliveryPeriod>
      <GRFuturesPriceKey>1</GRFuturesPriceKey>
    </FuturesPriceUpdateDetail>
  </Data>
  <LocationIdOrGuidForTimeStamp>sample string 3</LocationIdOrGuidForTimeStamp>
</FuturesPriceUpdate>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'ClsSkyGrFuturesPriceUpdate'.

Response Information

Resource Description

Update a futures month

AgvFuturesMonthAddOrUpdate
NameDescriptionTypeAdditional Information
Status

0 - Success; 1 - An error occurred; 2 - An error occurred; 3 - Descriptive message, process was successful

 string
Message

Informational message that corresponds to the Status returned; 0 - Message will be "OK"; 1 - Detailed message returned to give user an indication of what went wrong; 2 - Less detailed message returned that may not mean anything to the user but that the application might use to take a corrective action; 3 - Not an error but something the user might need to know

 string
ErrorList

List of error messages of the API call.

 Collection of string
WarningList

List of warning messages of the API call.

 Collection of string
Count

Number of records saved

 integer

Response Formats

application/json, text/json

Sample: 
{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "ErrorList": [
    "sample string 1",
    "sample string 2"
  ],
  "WarningList": [
    "sample string 1",
    "sample string 2"
  ],
  "Count": 1
}

application/xml, text/xml

Sample: 
<AgvFuturesMonthAddOrUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AgvWebAPICSharp.Models.Contract.Purchase">
  <Count>1</Count>
  <ErrorList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </ErrorList>
  <Message>sample string 2</Message>
  <Status>sample string 1</Status>
  <WarningList xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </WarningList>
</AgvFuturesMonthAddOrUpdate>