Request 'Bid-Ask' Rates

Append the show_bid_ask query parameter to your latest.json, historical/ or spot.json API request, like so:

https://openexchangerates.org/api/latest.json
    ?app_id=YOUR_APP_ID
    &show_bid_ask=1

$.get('https://openexchangerates.org/api/latest.json', {app_id: 'YOUR_APP_ID', show_alternative: 1}, function(data) {
    console.log(data);
});

The response format is the same as the standard API response, except that instead of a single (midpoint) value for each returned currency symbol, you will now receive an object containing bid, ask and mid for each currency where these are available*:

{
  "disclaimer": "...",
  "license": "...",
  "timestamp": 1501084644,
  "base": "USD",
  "rates": {
    "AED": {
      "bid": 3.67229,
      "ask": 3.67378,
      "mid": 3.673035
    },
    "AFN": {
      "bid": 68.399726,
      "ask": 68.690659,
      "mid": 68.545193
    },
    /* ... */
}

*For some currencies, we do not currently provide bid and ask prices. In such cases, or if we don't have bid and ask prices available for a given currency or data, we will not return them for that symbol.

You will still receive mid, but bid and ask will not be included.

Basic Code Samples

$.get('https://openexchangerates.org/api/latest.json', {app_id: 'YOUR_APP_ID', show_bid_ank: 1}, function(data) {
    console.log("USD/GBP 'bid' price: " + data.rates.GBP.bid);
    console.log("USD/GBP 'ask' price: " + data.rates.GBP.ask);
});

More code samples are on their way! Please get in touch if you'd like to submit a new/improved code sample in your languague or framework.

Combining Parameters

The show_bid_ask parameter can be combined with any other parameters available, such as base and symbols, and historical queries.