GET FuturesMonth/GetFuturesMonthsList?Commodity={Commodity}&Location={Location}&Exchange={Exchange}&BidCriteria={BidCriteria}&lastModifiedOnOrAfterUtc={lastModifiedOnOrAfterUtc}

Returns a list of Futures Months where the Futures Month End Date has not yet past. If the lastModifiedOnOrAfterUtc filter is used, the futures month end date filter is suppressed.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
Commodity

Filter the list of futures month pricing records by Commodity (optional)

string

Default value is string.Empty

Location

Filter the list of futures month pricing records by Location (optional)

string

Default value is string.Empty

Exchange

Filter the list of futures month pricing records by Exchange (optional)

string

Default value is string.Empty

BidCriteria

Filter the list of futures month pricing records by Bid Criteria (optional)

string

Default value is string.Empty

lastModifiedOnOrAfterUtc

Filter the list of futures month pricing records to those changed on or after the supplied UTC date and time (optional) - format = yyyy-MM-ddTHH:mm:ss

string

Default value is string.Empty

Body Parameters

Response Information

Resource Description

Returns a list of Futures Months where the Futures Month End Date has not yet past. If the lastModifiedOnOrAfterUtc filter is used, the futures month end date filter is suppressed.

AgvFuturesMonth
NameDescriptionTypeAdditional Information
Status

Status of the API call.

string
Message

Message of the API call.

string
Count

Count of how many FuturesMonth JSON dictionaries.

string
FuturesList

JSON dictionary of FuturesMonth.

Collection of FuturesMonth

Response Formats

application/json, text/json

Sample:
{
  "Status": "sample string 1",
  "Message": "sample string 2",
  "Count": "sample string 3",
  "FuturesList": [
    {
      "Commodity": "sample string 1",
      "Location": "sample string 2",
      "Exchange": "sample string 3",
      "BidCriteria": "sample string 4",
      "FuturesMonthName": "sample string 5",
      "FutureMonthEndDate": "sample string 6",
      "FuturesPrice": "sample string 7",
      "FuturesPriceDateTimeLocal": "2024-03-29T08:46:56.8404073+00:00",
      "BasisPrice": 8.1,
      "BasisPriceDateTimeLocal": "2024-03-29T08:46:56.8404073+00:00",
      "CommoditySymbol": "sample string 9",
      "StartingDeliveryPeriod": "2024-03-29T08:46:56.8404073+00:00",
      "EndingDeliveryPeriod": "2024-03-29T08:46:56.8404073+00:00",
      "FuturesMonthAliasId": "sample string 10",
      "LastModifiedUtc": "2024-03-29T08:46:56.8404073+00:00"
    },
    {
      "Commodity": "sample string 1",
      "Location": "sample string 2",
      "Exchange": "sample string 3",
      "BidCriteria": "sample string 4",
      "FuturesMonthName": "sample string 5",
      "FutureMonthEndDate": "sample string 6",
      "FuturesPrice": "sample string 7",
      "FuturesPriceDateTimeLocal": "2024-03-29T08:46:56.8404073+00:00",
      "BasisPrice": 8.1,
      "BasisPriceDateTimeLocal": "2024-03-29T08:46:56.8404073+00:00",
      "CommoditySymbol": "sample string 9",
      "StartingDeliveryPeriod": "2024-03-29T08:46:56.8404073+00:00",
      "EndingDeliveryPeriod": "2024-03-29T08:46:56.8404073+00:00",
      "FuturesMonthAliasId": "sample string 10",
      "LastModifiedUtc": "2024-03-29T08:46:56.8404073+00:00"
    }
  ]
}

application/xml, text/xml

Sample:
<AgvFuturesMonth xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AgvWebAPICSharp.Models.Contract.Purchase">
  <Count>sample string 3</Count>
  <FuturesList>
    <AgvFuturesMonth.FuturesMonth>
      <BasisPrice>8.1</BasisPrice>
      <BasisPriceDateTimeLocal>2024-03-29T08:46:56.8404073+00:00</BasisPriceDateTimeLocal>
      <BidCriteria>sample string 4</BidCriteria>
      <Commodity>sample string 1</Commodity>
      <CommoditySymbol>sample string 9</CommoditySymbol>
      <EndingDeliveryPeriod>2024-03-29T08:46:56.8404073+00:00</EndingDeliveryPeriod>
      <Exchange>sample string 3</Exchange>
      <FutureMonthEndDate>sample string 6</FutureMonthEndDate>
      <FuturesMonthAliasId>sample string 10</FuturesMonthAliasId>
      <FuturesMonthName>sample string 5</FuturesMonthName>
      <FuturesPrice>sample string 7</FuturesPrice>
      <FuturesPriceDateTimeLocal>2024-03-29T08:46:56.8404073+00:00</FuturesPriceDateTimeLocal>
      <LastModifiedUtc>2024-03-29T08:46:56.8404073+00:00</LastModifiedUtc>
      <Location>sample string 2</Location>
      <StartingDeliveryPeriod>2024-03-29T08:46:56.8404073+00:00</StartingDeliveryPeriod>
    </AgvFuturesMonth.FuturesMonth>
    <AgvFuturesMonth.FuturesMonth>
      <BasisPrice>8.1</BasisPrice>
      <BasisPriceDateTimeLocal>2024-03-29T08:46:56.8404073+00:00</BasisPriceDateTimeLocal>
      <BidCriteria>sample string 4</BidCriteria>
      <Commodity>sample string 1</Commodity>
      <CommoditySymbol>sample string 9</CommoditySymbol>
      <EndingDeliveryPeriod>2024-03-29T08:46:56.8404073+00:00</EndingDeliveryPeriod>
      <Exchange>sample string 3</Exchange>
      <FutureMonthEndDate>sample string 6</FutureMonthEndDate>
      <FuturesMonthAliasId>sample string 10</FuturesMonthAliasId>
      <FuturesMonthName>sample string 5</FuturesMonthName>
      <FuturesPrice>sample string 7</FuturesPrice>
      <FuturesPriceDateTimeLocal>2024-03-29T08:46:56.8404073+00:00</FuturesPriceDateTimeLocal>
      <LastModifiedUtc>2024-03-29T08:46:56.8404073+00:00</LastModifiedUtc>
      <Location>sample string 2</Location>
      <StartingDeliveryPeriod>2024-03-29T08:46:56.8404073+00:00</StartingDeliveryPeriod>
    </AgvFuturesMonth.FuturesMonth>
  </FuturesList>
  <Message>sample string 2</Message>
  <Status>sample string 1</Status>
</AgvFuturesMonth>