{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/ohlc.json","auth":"required","examples":{"codes":[{"name":null,"language":"http","code":"https://openexchangerates.org/api/ohlc.json\n    ?app_id=YOUR_APP_ID\n    &start_time=2017-07-17T11:00:00Z\n    &period=30m\n    &base=USD\n    &symbols=GBP,EUR,HKD\n    &prettyprint=true"},{"language":"javascript","name":"jQuery","code":"var query_vars = {\n    app_id: 'YOUR_APP_ID',\n    start_time: '2017-07-01T14:30:00Z',\n    period: '30m',\n    base: 'USD',\n    symbols: 'GBP,EUR,HKD',\n    prettyprint: false\n}\n\n$.get('https://openexchangerates.org/api/time-series.json', query_vars, function(data) {\n    console.log(data);\n});"}]},"settings":"","results":{"codes":[{"status":200,"language":"json","code":"\n{\n  \"disclaimer\": \"...\",\n  \"license\": \"...\",\n  \"start_time\": \"2017-07-17T11:00:00Z\",\n  \"end_time\": \"2017-07-17T11:29:59Z\",\n  \"base\": \"USD\",\n  \"rates\": {\n    \"EUR\": {\n      \"open\": 0.872674,\n      \"high\": 0.872674,\n      \"low\": 0.87203,\n      \"close\": 0.872251,\n      \"average\": 0.872253\n    },\n    \"GBP\": {\n      \"open\": 0.765284,\n      \"high\": 0.7657,\n      \"low\": 0.7652,\n      \"close\": 0.765541,\n      \"average\": 0.765503\n    },\n    \"HKD\": {\n      \"open\": 7.804003,\n      \"high\": 7.80568,\n      \"low\": 7.80399,\n      \"close\": 7.805248,\n      \"average\": 7.804725\n    }\n  }\n}","name":""},{"status":400,"name":"Bad Request (invalid_start_time)","code":"{\n    \"error\": true,\n    \"status\": 400,\n    \"message\": \"invalid_start_time\",\n    \"description\": \"Invalid start: `start_time` must be in ISO 8601 format with 0 seconds and UTC timezone: YYYY-MM-DDTHH:MM:00Z.\"\n}","language":"json"},{"code":"{\n    \"error\": true,\n    \"status\": 400,\n    \"message\": \"invalid_period_for_start_time\",\n    \"description\": \"Invalid period for start time: `start_time` is invalid for the selected `period` in UTC time. Please see the documentation for details related to valid start time and period values.\"\n}","language":"json","status":400,"name":"Bad Request (invalid_period_for_start_time)"},{"code":"{\n    \"error\": true,\n    \"status\": 400,\n    \"message\": \"not_available\",\n    \"description\": \"The combination of start time and period used resulted in an end time that is in the future.\"\n}","language":"json","status":400,"name":"Bad Request (not_available)"}]},"method":"get","params":[{"name":"app_id","type":"string","default":"Required","desc":"Your unique App ID.","required":false,"in":"query","ref":"","_id":"566b47ff85fbc81700f89547"},{"name":"start_time","type":"datetime","default":"Required","desc":"The start time for the requested OHLC period (ISO-8601 format, UTC only). Restrictions apply (please see below).","required":false,"in":"query","ref":"","_id":"566b6564461c970d0038bfda"},{"name":"period","type":"string","default":"Required","desc":"The requested period (starting on the start_time), e.g. \"1m\", \"30m\", \"1d\". Please see below for supported OHLC periods.","required":false,"in":"query","ref":"","_id":"566b7c8a03870a0d008ee7a4"},{"name":"symbols","type":"string","default":"Recommended","desc":"Limit results to specific currencies (comma-separated list of 3-letter codes)","required":false,"in":"query","ref":"","_id":"566b438f1766bf0d00e73982"},{"name":"base","type":"string","default":"Optional","desc":"Change base currency (3-letter code, default: USD)","required":false,"in":"query","ref":"","_id":"566b438f1766bf0d00e73983"},{"name":"prettyprint","type":"boolean","default":"Optional","desc":"Human-readable response for debugging (response size will be much larger)","required":false,"in":"query","ref":"","_id":"566b7c8a03870a0d008ee7a3"}]},"next":{"description":"","pages":[]},"title":"/ohlc.json","type":"endpoint","slug":"ohlc-json","excerpt":"Get historical Open, High Low, Close (OHLC) and Average exchange rates for a given time period, ranging from 1 month to 1 minute, where available. Please read all the details before starting integration.\n\nValues for 'high', 'low' and 'average' are based on all recorded prices we published (up to every 1 second).\n\nOHLC requests are currently available for clients of our VIP Platinum tier.","body":"[block:api-header]\n{\n  \"title\": \"\"\n}\n[/block]\n**The following parameters are available for OHLC requests:**\n\n**`app_id`** (required)\n\n  * Your Open Exchange Rates App ID\n\n**`start`** (required)\n\n  * A full ISO 8601 formatted timestamp in UTC timezone, with any hour/minute and zero seconds.\n  * Format: \"YYYY-MM-DDThh:mm:00Z\".\n  * Example: `&start=2017-07-17T08:30:00Z`.\n  * There are limitations to the start time, depending on the chosen `period` (see below).\n\n**`period`** (required)\n\n  * The requested time period for the OHLC data.\n  * Allowed periods are: `1m`, `5m`, `15m`, `30m`, `1h`, `12h`, `1d`, `1w`, and `1mo`.\n  * Example: `&period=30m`.\n  * There are limitations to the period, depending on the chosen 'start' time (see below).\n\n**`base`** (optional)\n\n  * Choose base currency for OHLC prices (default USD).\n  * Example: `&base=GBP`\n\n**`symbols`** (optional)\n  * Limit the number of currencies returned. Recommended to reduce file size.\n  * Example: `&symbols=XAU,XAG,XPD,XPT`\n\n**`show_alternative`** (optional)\n\n  * Include alternative, digital and black currency prices\n  * Example: `&show_alternative=true`\n\n**`prettyprint`** (optional)\n\n  * Get a human-readable (whitespace formatted) response. Not recommended for production use.\n  * Example: `&prettyprint=true`\n\n[block:api-header]\n{\n  \"title\": \"Limitations\"\n}\n[/block]\nThe following restrictions apply to the combination of `start_time` and `period`:\n\n- `start_time` must always have zero seconds (i.e. \"hh:mm**:00**\") and must be on/after December 19th 2016.\n- The format for `start_time` must be ISO-8601 and limited to UTC (timezones are not currently supported) – i.e: \"YYYY-MM-DD**T**hh:mm:00**Z**\".\n- Periods of `1m` must not start more than 60 minutes ago (i.e. `start_time` should be within the past hour).\n- Periods of `5m` must not start more than 24 hours ago, and must be aligned to a whole 5 minute period (e.g. 00, 05, 10, 15 etc.)\n- Periods of `15m` must not start more than 24 hours ago, and must be aligned to a whole 15 minute period (i.e. 00, 15, 30, 45)\n- Periods of `30m` or `60m`/`1h` must not start more than 32 days ago, and must be aligned to a whole 30 minute period (i.e. 00 or 30)\n- Periods of `12h` or `24h`/`1d` must be aligned to whole 30 minute period (i.e. 00, 30)\n- Periods of `7d`/`1w` must be aligned to the start of a whole calendar day (i.e. YYYY-MM-DDT**00**:00:00Z)\n- Periods of `1mo` must be aligned to the start of a whole calendar month (i.e. YYYY-MM-**01**T00:00:00Z)\n- The requested combination of `start_time` and `period` must not produce an `end_time` that is in the future (i.e. an incomplete period).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"With a full list of currencies, OHLC responses can be very large in size. For better performance, use the `symbols` parameter to cut down response weight, and set `prettyprint=false` to remove whitespace.\",\n  \"title\": \"Important\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"API Response Format\"\n}\n[/block]\nThe OHLC endpoint response format is similar to the standard API response in **latest.json**. Please familiarise yourself with the standard API response format before using this endpoint.\n\nThe `start_time` is the ISO-8601 formatted timestamp (UTC) of the start of period, corresponding to the 'open' rate.\n\nThe `end_time` is the ISO-8601 formatted timestamp (UTC) of the end of period (inclusive), corresponding to the 'close' rate. (For example, a period of `60m` would begin on `hh:00:00` and end on `hh:59:59`).\n\nThe `base` property provides the 3-letter currency code to which all the delivered exchange rates are relative.\n\nThe `rates` object contains an object for each currency in the result set, labelled by its international-standard 3-letter currency code. Each object contains five values:\n\n- `open` – The midpoint rate recorded at `start_time`\n- `high` – The highest midpoint rate recorded at any time during the period\n- `low` – The lowest midpoint rate recorded at any time during the period\n- `close` – The midpoint rate recorded at `end_time`\n- `average` – The time-weighted average midpoint exchange rate for the entire period\n\nAll the values are relative to 1 unit of the requested `base` currency.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Errors\"\n}\n[/block]\nPlease see [API Error Messages](doc:errors) for a list of possible errors not specified above.","updates":["60abd38f05e699002e931b3c","60abd3c195a3bc0068e68294"],"order":5,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"59627cdb09c31d001557eb6b","project":"55312174c68f493900aebb3f","version":{"version":"0.7","version_clean":"0.7.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["55312175c68f493900aebb43","566b431d03b4b20d00d02c3a","566b58f212bc0517005d3068","566b59110506f40d0034f148","566b7cc94d1a4d0d00801c00","566b82d130cdb417008d217d","566b855b4d1a4d0d00801c04","566b856f03870a0d008ee7a7","566c42d2f0a5dc0d009acbab","566c443d85dc790d0062c134"],"_id":"55312174c68f493900aebb42","project":"55312174c68f493900aebb3f","releaseDate":"2015-04-17T15:06:28.598Z","__v":10,"createdAt":"2015-04-17T15:06:28.598Z"},"category":{"sync":{"isSync":false,"url":""},"pages":["566b438f1766bf0d00e73981","566b51a3f46dc90d009de82a","566b57f068eba90d009cac72","566b6564461c970d0038bfd9","566b6f17bc5adc0d0096760c","566b7c8a03870a0d008ee7a2","566b81db30cdb417008d217b","56a48d9521d3d60d000341f4"],"title":"API Endpoints","slug":"basic-requests","order":1,"from_sync":false,"reference":true,"_id":"566b431d03b4b20d00d02c3a","version":"55312174c68f493900aebb42","__v":8,"createdAt":"2015-12-11T21:41:49.917Z","project":"55312174c68f493900aebb3f"},"user":"5531215e29603d2300011341","createdAt":"2017-07-09T18:58:35.836Z","githubsync":"","__v":2,"parentDoc":null}