OANDA · Schema

Price

The Price representation

ForexFX TradingCFD TradingFinancial ServicesTrading APIs

Properties

Name Type Description
instrument string The Price's Instrument.
tradeable boolean Flag indicating if the Price is tradeable or not
timestamp string The date/time when the Price was created.
baseBid string The base bid price as calculated by pricing.
baseAsk string The base ask price as calculated by pricing.
bids array The list of prices and liquidity available on the Instrument's bid side. It is possible for this list to be empty if there is no bid liquidity currently available for the Instrument in the Account.
asks array The list of prices and liquidity available on the Instrument's ask side. It is possible for this list to be empty if there is no ask liquidity currently available for the Instrument in the Account.
closeoutBid string The closeout bid price. This price is used when a bid is required to closeout a Position (margin closeout or manual) yet there is no bid liquidity. The closeout bid is never used to open a new positio
closeoutAsk string The closeout ask price. This price is used when an ask is required to closeout a Position (margin closeout or manual) yet there is no ask liquidity. The closeout ask is never used to open a new positi
View JSON Schema on GitHub

JSON Schema

Price.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Price",
  "description": "The Price representation",
  "type": "object",
  "properties": {
    "instrument": {
      "type": "string",
      "description": "The Price's Instrument.",
      "format": "A string containing the base currency and quote currency delimited by a \"_\"."
    },
    "tradeable": {
      "type": "boolean",
      "description": "Flag indicating if the Price is tradeable or not"
    },
    "timestamp": {
      "type": "string",
      "description": "The date/time when the Price was created.",
      "format": "The RFC 3339 representation is a string conforming to https://tools.ietf.org/rfc/rfc3339.txt. The Unix representation is a string representing the number of seconds since the Unix Epoch (January 1st, 1970 at UTC). The value is a fractional number, where the fractional part represents a fraction of a second (up to nine decimal places)."
    },
    "baseBid": {
      "type": "string",
      "description": "The base bid price as calculated by pricing.",
      "format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
    },
    "baseAsk": {
      "type": "string",
      "description": "The base ask price as calculated by pricing.",
      "format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
    },
    "bids": {
      "type": "array",
      "description": "The list of prices and liquidity available on the Instrument's bid side. It is possible for this list to be empty if there is no bid liquidity currently available for the Instrument in the Account.",
      "items": {
        "$ref": "#/definitions/PriceBucket"
      }
    },
    "asks": {
      "type": "array",
      "description": "The list of prices and liquidity available on the Instrument's ask side. It is possible for this list to be empty if there is no ask liquidity currently available for the Instrument in the Account.",
      "items": {
        "$ref": "#/definitions/PriceBucket"
      }
    },
    "closeoutBid": {
      "type": "string",
      "description": "The closeout bid price. This price is used when a bid is required to closeout a Position (margin closeout or manual) yet there is no bid liquidity. The closeout bid is never used to open a new position.",
      "format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
    },
    "closeoutAsk": {
      "type": "string",
      "description": "The closeout ask price. This price is used when an ask is required to closeout a Position (margin closeout or manual) yet there is no ask liquidity. The closeout ask is never used to open a new position.",
      "format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
    }
  }
}