openapi: 3.0.1 info: title: REST API description: "\nRESTful endpoint provides the widest range of data, based on HTTP protocol which works in Request-Reply scheme.\n\nImplemented Standards:\n\n * [HTTP1.0](https://datatracker.ietf.org/doc/html/rfc1945)\n * [HTTP1.1](https://datatracker.ietf.org/doc/html/rfc2616)\n * [HTTP2.0](https://datatracker.ietf.org/doc/html/rfc7540)\n * [OpenAPI v3](https://www.openapis.org/)\n\n> **Note:** We adhere to the OpenAPI standards for documenting our API.\n\n## OpenAPI Specification\n\nTo access our API's OpenAPI specification, you can use the following link: [OpenAPI v3](https://raw.githubusercontent.com/coinapi/coinapi-sdk/master/data-api/coinapi-marketdata-rest.yaml)\n\nIf you need to import the OpenAPI file into software like Postman, simply copy and paste the link below:\n```shell\nhttps://raw.githubusercontent.com/coinapi/coinapi-sdk/master/data-api/coinapi-marketdata-rest.yaml\n```\n\n## Endpoints\n\nEnviroment | Encryption | Value \n--- | --- | ---\nProduction | Yes | `https://rest.coinapi.io/`\nProduction | No | `http://rest.coinapi.io/`\n\n:::info\n\nFor real-time market data streaming, you should use WebSockets. REST API only supports pooling, meaning you can periodically request the current market data state. In streaming, you subscribe and data or updates are delivered to you continuously.\n\n:::\n\n## General\n\nIf you want to learn how to authenticate to this API, you can find detailed instructions and guidance in\n[authentication section](/authentication) of this documentation.\n\n### HTTP Requests\n\nEach HTTP request must contain the header ``Accept: application/json`` as all our responses are in JSON format.\n\nWe encourage you to use the HTTP request header ``Accept-Encoding: deflate, gzip`` for all requests. \nThis will indicate to us that we can deliver compressed data to you which on your side should be decompressed transparently.\n\n:::tip\n\nBy allowing data compression you are lowering bandwidth requirements by approximately 80%. \nThis is important for requesting large amounts of data or using WebSocket Streaming API, \nas we can deliver data to you faster and more effectively.\n\n:::\n\n#### HTTP Success\n\nSuccessful HTTP responses have the status code `200` and the body in a format according to documentation of the requested resource.\n\n:::info\n\nYou should always check that your HTTP response status code is equal to 200, otherwise the requested was not successful.\n\n:::\n\n#### HTTP Errors\n\n> Error message is returned in JSON structured like this:\n\n```json\n{\n \"error\": \"Invalid API key\"\n}\n```\n\nAll HTTP requests with response status codes different to `200` must be considered as failed \nand you should expect additional JSON inside the body of the response with the error message encapsulated inside it as shown in the example.\nWe use the following error codes:\n\nError Code | Meaning\n---------- | -------\n400 | Bad Request -- There is something wrong with your request\n401 | Unauthorized -- Your API key is wrong\n403 | Forbidden -- Your API key doesnt't have enough privileges to access this resource\n429 | Too many requests -- You have exceeded your API key rate limits\n550 | No data -- You requested specific single item that we don't have at this moment.\n\n:::info\n\nGood practice is to store all error messages somewhere along with request data for further manual review.\n\n:::\n\n### Output data format\n\nBy default we are using JSON output data format for all of our endpoints, you can control format of data by using `output_format` variable in query string parameters.\n\n#### URL Parameters\n\nParameter | Type | Description\n---------- | ------- | -------\noutput_format | string | Output data format *(optional, default value is `json`, possible values are `json`, `xml` or `csv`)*\ncsv_include_header | bool | Ignore header line in CSV output? *(optional, default value is `true`, `true` to include CSV header line, `false` otherwise)*\ncsv_include_quotes | bool | Encapsulate strings with quotes in CSV output? *(optional, default value is `false`, `true` to encapsulate all strings with `\"`, `false` to leave them unquoted)*\ncsv_exclude_col | string | Comma delimited list of column names to ignore in CSV output *(optional, by default all columns are included)*\ncsv_set_delimiter | string | Character that will be used as column delimiter in CSV output *(optional, default value is `;`)*\ncsv_set_dec_mark | string | Character that will be used as decimal separator in CSV output *(optional, default value is `.`)*\ncsv_set_timeformat | string | Format for datetime type in CSV output or `unix` for unix timestamp *(optional, default value is `yyyy-MM-ddTHH:mm:ss.fffffffZ`)*\ncsv_set_newline | string | New line type *(optional, default value is `unix`, possible values `win`, `mac`, `unix`)*\n\n### Excel / G-Sheets\n\nThere are several ways to use data from our REST API inside the Excel, Google Sheets, or similar calculation sheet application. This section will do as best as possible to keep all information up to date on how you could load the data into these applications. Feel free to contact support if we are missing an option.\n\n#### CSV download, import:\n\n 1. Open the data in the CSV format from the browser eg. ```https://rest.coinapi.io/v1/exchangerate/USD?apikey=YOUR_API_KEY&invert=true&output_format=csv```\n 2. Save the data to the file with the .csv extension.\n 3. Use the file saved and import it into the software.\n 4. When configuring import, refer to the parameters like delimiter from the [Output data format](#output-data-format)\n\nThe platform-independent way described above is based on CSV but could also be used in other formats like JSON and XML as long as the software support it, but the import procedure needs to be adjusted accordingly.\n\n#### Microsoft Excel\n\n * Use [PowerQuery](https://docs.microsoft.com/en-us/power-query/power-query-what-is-power-query) to load the URL directly into the CSV import without saving the file locally. \n * Use the [=WEBSERVICE](https://support.office.com/en-us/article/webservice-function-0546a35a-ecc6-4739-aed7-c0b7ce1562c4) function to load the API response directly into the sheet, but this will not parse the data; additional processing is required.\n\n#### Google Sheets\n\n * Use [=IMPORT](https://support.google.com/docs/answer/3093335?hl=en) function to load the REST API endpoint and automatically parse the CSV format data into the cells. eg. ```=IMPORTDATA(\"https://rest.coinapi.io/v1/exchangerate/USD?apikey=YOUR_API_KEY&invert=true&output_format=csv```\n\n#### OpenOffice Calc\n\n * Select the menu Insert -> Sheet From File, 2. In the Insert dialog, put the URL eg. ```https://rest.coinapi.io/v1/exchangerate/USD?apikey=YOUR_API_KEY&invert=true&output_format=csv``` in the File Name box at the bottom. Set the drop-down list next to that to Web Page Query and click Open. The Text Import dialog opens where you can change the defaults if needed.\n " contact: name: COINAPI LTD url: https://www.coinapi.io email: support@coinapi.io license: name: MIT License url: https://github.com/coinapi/coinapi-sdk/blob/master/LICENSE version: v1 servers: - url: https://rest.coinapi.io paths: /v1/assets: get: tags: - Metadata summary: List all assets description: "Retrieves all assets.\r\n \r\n:::info\r\nOur asset identifiers are aligned with the ISO 4217 currency codes standard only for fiat money (government or law regulated currency).\r\n:::\r\n \r\n:::info\r\nProperties of the output are providing aggregated information from across all symbols related to the specific asset. If you need to calculate your aggregation (e.g., limiting only the particular type of symbols), you should use /v1/symbols endpoint as a data source.\r\n:::" parameters: - name: filter_asset_id in: query description: 'Comma or semicolon delimited asset identifiers used to filter response. (optional, eg. `BTC;ETH`).' schema: type: string - name: include_supply in: query description: Flag indicating whether to include supply information. schema: type: boolean default: false responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] '/v1/assets/{asset_id}': get: tags: - Metadata summary: List all assets by asset ID parameters: - name: asset_id in: path description: The asset ID. required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Asset' examples: Example response: value: [ { "asset_id": "BTC", "name": "Bitcoin", "type_is_crypto": 1, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:55:07.6724523Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:17.8592413Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:11.8220000Z", "data_symbols_count": 22711, "volume_1hrs_usd": 102894431436.49, "volume_1day_usd": 2086392323256.16, "volume_1mth_usd": 57929168359984.54, "price_usd": 9166.207274778093436220194944, "chain_addresses": [ { "chain_id": "ARBITRUM", "network_id": "MAINNET", "address": "0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f" }, { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" }, { "asset_id": "USD", "name": "US Dollar", "type_is_crypto": 0, "data_quote_start": "2014-02-24T17:43:05.0000000Z", "data_quote_end": "2019-11-03T17:54:49.3807706Z", "data_orderbook_start": "2014-02-24T17:43:05.0000000Z", "data_orderbook_end": "2019-11-03T17:55:13.1863931Z", "data_trade_start": "2010-07-17T23:09:17.0000000Z", "data_trade_end": "2019-11-03T17:55:07.7870000Z", "data_symbols_count": 10728, "volume_1hrs_usd": 9466454016.52, "volume_1day_usd": 221580758173.49, "volume_1mth_usd": 11816685174661.70, "price_usd": 1.0, "chain_addresses": [ { "chain_id": "ETHEREUM", "network_id": "MAINNET", "address": "0xd233d1f6fd11640081abb8db125f722b5dc729dc" } ], "data_start": "2010-07-17", "data_end": "2019-11-03" } ] '/v1/assets/icons/{size}': get: tags: - Metadata summary: List all asset icons description: Gets the list of icons (of the given size) for all the assets. parameters: - name: size in: path description: The size of the icons. required: true schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "asset_id": "BTC", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/f231d7382689406f9a50dde841418c64.png" }, { "asset_id": "ETH", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/04836ff3bc4d4d95820e0155594dca86.png" }, { "asset_id": "USD", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4873707f25fe4de3b4bca6fa5c631011.png" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "asset_id": "BTC", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/f231d7382689406f9a50dde841418c64.png" }, { "asset_id": "ETH", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/04836ff3bc4d4d95820e0155594dca86.png" }, { "asset_id": "USD", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4873707f25fe4de3b4bca6fa5c631011.png" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "asset_id": "BTC", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/f231d7382689406f9a50dde841418c64.png" }, { "asset_id": "ETH", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/04836ff3bc4d4d95820e0155594dca86.png" }, { "asset_id": "USD", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4873707f25fe4de3b4bca6fa5c631011.png" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "asset_id": "BTC", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/f231d7382689406f9a50dde841418c64.png" }, { "asset_id": "ETH", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/04836ff3bc4d4d95820e0155594dca86.png" }, { "asset_id": "USD", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4873707f25fe4de3b4bca6fa5c631011.png" } ] '/v1/exchangerate/{asset_id_base}/{asset_id_quote}': get: tags: - Exchange Rates summary: '[exchange rates] Get specific rate' description: "Retrieves the exchange rate for a specific base and quote asset at a given time or the current rate.\r\n \r\n:::info\r\nIf you are using an exchange rate for mission-critical operations, then for best reliability, you should measure the difference between current time and the time returned from the response to ensure that value of the difference between those meets your internal requirements.\r\n:::" operationId: Get specific rate parameters: - name: asset_id_base in: path description: Requested exchange rate base asset identifier (from the Metadata -> Assets) required: true schema: type: string - name: asset_id_quote in: path description: Requested exchange rate quote asset identifier (from the Metadata -> Assets) required: true schema: type: string - name: time in: query description: 'Time at which exchange rate is calculated (optional, if not supplied then current rate is returned)' schema: type: string responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.ExchangeRate' examples: Example response: value: { "time": "2024-04-29T10:40:19.1488249Z", "asset_id_base": "BTC", "asset_id_quote": "USD", "rate": 10000.0 } application/json: schema: $ref: '#/components/schemas/v1.ExchangeRate' examples: Example response: value: { "time": "2024-04-29T10:40:19.1488249Z", "asset_id_base": "BTC", "asset_id_quote": "USD", "rate": 10000.0 } text/json: schema: $ref: '#/components/schemas/v1.ExchangeRate' examples: Example response: value: { "time": "2024-04-29T10:40:19.1488249Z", "asset_id_base": "BTC", "asset_id_quote": "USD", "rate": 10000.0 } application/x-msgpack: schema: $ref: '#/components/schemas/v1.ExchangeRate' examples: Example response: value: { "time": "2024-04-29T10:40:19.1488249Z", "asset_id_base": "BTC", "asset_id_quote": "USD", "rate": 10000.0 } '/v1/exchangerate/{asset_id_base}': get: tags: - Exchange Rates summary: '[exchange rates] Get all current rates' description: "Get the current exchange rate between requested asset and all other assets.\r\n \r\n:::info\r\nIf you are using an exchange rate for mission-critical operations, then for best reliability, you should measure the difference between current time and the time returned from the response to ensure that value of the difference between those meets your internal requirements.\r\n:::\r\n \r\n:::info\r\nYou can invert the rates by using Y = 1 / X equation, for example BTC/USD = 1 / (USD/BTC);\r\n:::" parameters: - name: asset_id_base in: path description: Requested exchange rates base asset identifier (from the Metadata -> Assets) required: true schema: type: string - name: filter_asset_id in: query description: Comma or semicolon delimited asset identifiers used to filter response (optional) schema: type: string - name: invert in: query description: 'True will invert all the rates (optional, if true then rates will be calculated as `rate = 1 / actual_rate` eg. `USD/BTC` as `BTC/USD`)' schema: type: boolean default: false - name: time in: query description: Time for historical rates (optional) schema: type: string responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.ExchangeRates`1' examples: Example response: value: { "asset_id_base": "BTC", "rates": [ { "time": "2017-08-09T14:31:37.0520000Z", "asset_id_quote": "USD", "rate": 3258.8875417798037784035133948 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "EUR", "rate": 2782.5255080599273092901331567 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "CNY", "rate": 21756.295595926054627342411501 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "GBP", "rate": 2509.6024203799580199765804823 } ] } application/json: schema: $ref: '#/components/schemas/v1.ExchangeRates`1' examples: Example response: value: { "asset_id_base": "BTC", "rates": [ { "time": "2017-08-09T14:31:37.0520000Z", "asset_id_quote": "USD", "rate": 3258.8875417798037784035133948 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "EUR", "rate": 2782.5255080599273092901331567 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "CNY", "rate": 21756.295595926054627342411501 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "GBP", "rate": 2509.6024203799580199765804823 } ] } text/json: schema: $ref: '#/components/schemas/v1.ExchangeRates`1' examples: Example response: value: { "asset_id_base": "BTC", "rates": [ { "time": "2017-08-09T14:31:37.0520000Z", "asset_id_quote": "USD", "rate": 3258.8875417798037784035133948 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "EUR", "rate": 2782.5255080599273092901331567 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "CNY", "rate": 21756.295595926054627342411501 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "GBP", "rate": 2509.6024203799580199765804823 } ] } application/x-msgpack: schema: $ref: '#/components/schemas/v1.ExchangeRates`1' examples: Example response: value: { "asset_id_base": "BTC", "rates": [ { "time": "2017-08-09T14:31:37.0520000Z", "asset_id_quote": "USD", "rate": 3258.8875417798037784035133948 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "EUR", "rate": 2782.5255080599273092901331567 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "CNY", "rate": 21756.295595926054627342411501 }, { "time": "2017-08-09T14:31:36.7570000Z", "asset_id_quote": "GBP", "rate": 2509.6024203799580199765804823 } ] } /v1/exchangerate/history/periods: get: tags: - Exchange Rates summary: '[exchange rates] Timeseries periods' description: "You can also obtain historical exchange rates of any asset pair, grouped into time periods.\r\nGet full list of supported time periods available for requesting exchange rates historical timeseries data.\r\n \r\n## Timeseries periods\r\nTime unit |\tPeriod identifiers\r\n--- | ---\r\nSecond | 1SEC, 2SEC, 3SEC, 4SEC, 5SEC, 6SEC, 10SEC, 15SEC, 20SEC, 30SEC\r\nMinute | 1MIN, 2MIN, 3MIN, 4MIN, 5MIN, 6MIN, 10MIN, 15MIN, 20MIN, 30MIN\r\nHour | 1HRS, 2HRS, 3HRS, 4HRS, 6HRS, 8HRS, 12HRS\r\nDay | 1DAY, 2DAY, 3DAY, 5DAY, 7DAY, 10DAY" responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "30MIN", "length_seconds": 1800, "length_months": 0, "unit_count": 30, "unit_name": "minute", "display_name": "30 Minutes" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "30MIN", "length_seconds": 1800, "length_months": 0, "unit_count": 30, "unit_name": "minute", "display_name": "30 Minutes" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "30MIN", "length_seconds": 1800, "length_months": 0, "unit_count": 30, "unit_name": "minute", "display_name": "30 Minutes" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "30MIN", "length_seconds": 1800, "length_months": 0, "unit_count": 30, "unit_name": "minute", "display_name": "30 Minutes" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" } ] '/v1/exchangerate/{asset_id_base}/{asset_id_quote}/history': get: tags: - Exchange Rates summary: '[exchange rates] Timeseries data' description: Get the historical exchange rates between two assets in the form of the timeseries. parameters: - name: asset_id_base in: path description: Requested exchange rates base asset identifier (from the Metadata -> Assets) required: true schema: type: string - name: asset_id_quote in: path description: Requested exchange rates base asset identifier (from the Metadata -> Assets) required: true schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (required, e.g. `5SEC` or `1HRS`)' schema: type: string - name: time_start in: query description: Timeseries starting time in ISO 8601 (required) schema: type: string - name: time_end in: query description: Timeseries ending time in ISO 8601 (required) schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.ExchangeRatesTimeseriesItem' examples: Example response: value: [ { "time_period_start": "2016-01-01T00:00:00.0000000Z", "time_period_end": "0001-01-01T00:00:00.0000000Z", "time_open": "2016-01-01T00:00:00.0000000Z", "time_close": "2016-01-01T00:00:00.0000000Z", "rate_open": 430.586617904731, "rate_high": 430.586617904731, "rate_low": 430.586617904731, "rate_close": 430.586617904731 }, { "time_period_start": "2016-01-01T00:01:00.0000000Z", "time_period_end": "2016-01-01T00:02:00.0000000Z", "time_open": "2016-01-01T00:01:00.0000000Z", "time_close": "2016-01-01T00:01:00.0000000Z", "rate_open": 430.38999999999993, "rate_high": 430.38999999999993, "rate_low": 430.38999999999993, "rate_close": 430.38999999999993 }, { "time_period_start": "2016-01-01T00:02:00.0000000Z", "time_period_end": "2016-01-01T00:03:00.0000000Z", "time_open": "2016-01-01T00:02:00.0000000Z", "time_close": "2016-01-01T00:02:00.0000000Z", "rate_open": 430.6522189770523, "rate_high": 430.6522189770523, "rate_low": 430.6522189770523, "rate_close": 430.6522189770523 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.ExchangeRatesTimeseriesItem' examples: Example response: value: [ { "time_period_start": "2016-01-01T00:00:00.0000000Z", "time_period_end": "0001-01-01T00:00:00.0000000Z", "time_open": "2016-01-01T00:00:00.0000000Z", "time_close": "2016-01-01T00:00:00.0000000Z", "rate_open": 430.586617904731, "rate_high": 430.586617904731, "rate_low": 430.586617904731, "rate_close": 430.586617904731 }, { "time_period_start": "2016-01-01T00:01:00.0000000Z", "time_period_end": "2016-01-01T00:02:00.0000000Z", "time_open": "2016-01-01T00:01:00.0000000Z", "time_close": "2016-01-01T00:01:00.0000000Z", "rate_open": 430.38999999999993, "rate_high": 430.38999999999993, "rate_low": 430.38999999999993, "rate_close": 430.38999999999993 }, { "time_period_start": "2016-01-01T00:02:00.0000000Z", "time_period_end": "2016-01-01T00:03:00.0000000Z", "time_open": "2016-01-01T00:02:00.0000000Z", "time_close": "2016-01-01T00:02:00.0000000Z", "rate_open": 430.6522189770523, "rate_high": 430.6522189770523, "rate_low": 430.6522189770523, "rate_close": 430.6522189770523 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.ExchangeRatesTimeseriesItem' examples: Example response: value: [ { "time_period_start": "2016-01-01T00:00:00.0000000Z", "time_period_end": "0001-01-01T00:00:00.0000000Z", "time_open": "2016-01-01T00:00:00.0000000Z", "time_close": "2016-01-01T00:00:00.0000000Z", "rate_open": 430.586617904731, "rate_high": 430.586617904731, "rate_low": 430.586617904731, "rate_close": 430.586617904731 }, { "time_period_start": "2016-01-01T00:01:00.0000000Z", "time_period_end": "2016-01-01T00:02:00.0000000Z", "time_open": "2016-01-01T00:01:00.0000000Z", "time_close": "2016-01-01T00:01:00.0000000Z", "rate_open": 430.38999999999993, "rate_high": 430.38999999999993, "rate_low": 430.38999999999993, "rate_close": 430.38999999999993 }, { "time_period_start": "2016-01-01T00:02:00.0000000Z", "time_period_end": "2016-01-01T00:03:00.0000000Z", "time_open": "2016-01-01T00:02:00.0000000Z", "time_close": "2016-01-01T00:02:00.0000000Z", "rate_open": 430.6522189770523, "rate_high": 430.6522189770523, "rate_low": 430.6522189770523, "rate_close": 430.6522189770523 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.ExchangeRatesTimeseriesItem' examples: Example response: value: [ { "time_period_start": "2016-01-01T00:00:00.0000000Z", "time_period_end": "0001-01-01T00:00:00.0000000Z", "time_open": "2016-01-01T00:00:00.0000000Z", "time_close": "2016-01-01T00:00:00.0000000Z", "rate_open": 430.586617904731, "rate_high": 430.586617904731, "rate_low": 430.586617904731, "rate_close": 430.586617904731 }, { "time_period_start": "2016-01-01T00:01:00.0000000Z", "time_period_end": "2016-01-01T00:02:00.0000000Z", "time_open": "2016-01-01T00:01:00.0000000Z", "time_close": "2016-01-01T00:01:00.0000000Z", "rate_open": 430.38999999999993, "rate_high": 430.38999999999993, "rate_low": 430.38999999999993, "rate_close": 430.38999999999993 }, { "time_period_start": "2016-01-01T00:02:00.0000000Z", "time_period_end": "2016-01-01T00:03:00.0000000Z", "time_open": "2016-01-01T00:02:00.0000000Z", "time_close": "2016-01-01T00:02:00.0000000Z", "rate_open": 430.6522189770523, "rate_high": 430.6522189770523, "rate_low": 430.6522189770523, "rate_close": 430.6522189770523 } ] /v1/exchanges: get: tags: - Metadata summary: List all exchanges description: "Get a detailed list of exchanges provided by the system.\r\n \r\n:::info\r\nProperties of the output are providing aggregated information from across all symbols related to the specific exchange. If you need to calculate your aggregation (e.g., limiting only the particular type of symbols), you should use /v1/symbols endpoint as a data source.\r\n:::" parameters: - name: filter_exchange_id in: query description: 'Comma or semicolon delimited exchange identifiers used to filter response. (optional, eg. `BITSTAMP;GEMINI`)' schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] '/v1/exchanges/{exchange_id}': get: tags: - Metadata summary: List all exchanges by exchange_id parameters: - name: exchange_id in: path description: The ID of the exchange. required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Exchange' examples: Example response: value: [ { "exchange_id": "OKCOIN_CNY", "website": "https://www.okcoin.cn/", "name": "OKCoin CNY", "data_quote_start": "2015-02-15T12:53:50.3430000Z", "data_quote_end": "2018-03-09T23:34:52.5800000Z", "data_orderbook_start": "2015-02-15T12:53:50.3430000Z", "data_orderbook_end": "2018-03-09T23:34:52.5800000Z", "data_trade_start": "2013-06-12T14:24:24.0000000Z", "data_trade_end": "2017-11-01T16:30:39.7077259Z", "data_symbols_count": 2, "volume_1hrs_usd": 0.0, "volume_1day_usd": 0.0, "volume_1mth_usd": 0.0 }, { "exchange_id": "HUOBI", "website": "https://www.huobi.com/", "name": "Huobi (HBUS)", "data_quote_start": "2015-03-29T21:46:06.2630000Z", "data_quote_end": "2019-11-03T18:22:29.1837496Z", "data_orderbook_start": "2015-03-29T21:46:06.2630000Z", "data_orderbook_end": "2019-11-03T18:23:53.2859878Z", "data_trade_start": "2015-03-29T21:46:08.7030000Z", "data_trade_end": "2019-11-03T18:21:48.2770000Z", "data_symbols_count": 403, "volume_1hrs_usd": 1605.80, "volume_1day_usd": 59957.44, "volume_1mth_usd": 1259508.43 } ] '/v1/exchanges/icons/{size}': get: tags: - Metadata summary: List of icons for the exchanges parameters: - name: size in: path description: The size of the icons. required: true schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "exchange_id": "CHAINCE", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/204e55dd8dab4a0d823c21f04be6be4b.png" }, { "exchange_id": "BILAXY", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4958c92dbddd4936b1f655e5063dc782.png" }, { "exchange_id": "BCOINSG", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/b7c77041cdef4f359b4044b2d73c7741.png" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "exchange_id": "CHAINCE", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/204e55dd8dab4a0d823c21f04be6be4b.png" }, { "exchange_id": "BILAXY", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4958c92dbddd4936b1f655e5063dc782.png" }, { "exchange_id": "BCOINSG", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/b7c77041cdef4f359b4044b2d73c7741.png" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "exchange_id": "CHAINCE", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/204e55dd8dab4a0d823c21f04be6be4b.png" }, { "exchange_id": "BILAXY", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4958c92dbddd4936b1f655e5063dc782.png" }, { "exchange_id": "BCOINSG", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/b7c77041cdef4f359b4044b2d73c7741.png" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Icon' examples: Example response: value: [ { "exchange_id": "CHAINCE", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/204e55dd8dab4a0d823c21f04be6be4b.png" }, { "exchange_id": "BILAXY", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/4958c92dbddd4936b1f655e5063dc782.png" }, { "exchange_id": "BCOINSG", "url": "https://s3.eu-central-1.amazonaws.com/bbxt-static-icons/type-id/png_16/b7c77041cdef4f359b4044b2d73c7741.png" } ] /v1/indexes: get: tags: - Indexes summary: List indexes responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Index' application/json: schema: type: array items: $ref: '#/components/schemas/v1.Index' text/json: schema: type: array items: $ref: '#/components/schemas/v1.Index' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Index' '/v1/indexes/{index_id}/history': get: tags: - Indexes summary: Historical Index Value w/Composition parameters: - name: index_id in: path required: true schema: type: string - name: time_start in: query schema: type: string format: date-time - name: time_end in: query schema: type: string format: date-time - name: limit in: query schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.IndexValue' application/json: schema: type: array items: $ref: '#/components/schemas/v1.IndexValue' text/json: schema: type: array items: $ref: '#/components/schemas/v1.IndexValue' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.IndexValue' '/v1/indexes/{index_id}/timeseries': get: tags: - Indexes summary: Timeseries Index Value parameters: - name: index_id in: path description: '' required: true schema: type: string - name: period_id in: query description: Identifier of requested timeseries period (e.g. `5SEC` or `1DAY`) required: true schema: type: string - name: time_start in: query description: Timeseries starting time in ISO 8601 required: true schema: type: string - name: time_end in: query description: Timeseries ending time in ISO 8601 required: true schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.IndexTimeseriesItem' application/json: schema: type: array items: $ref: '#/components/schemas/v1.IndexTimeseriesItem' text/json: schema: type: array items: $ref: '#/components/schemas/v1.IndexTimeseriesItem' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.IndexTimeseriesItem' /v1/metadata: get: tags: - Metadata summary: Base url of the API. responses: '200': description: Success /v1/metrics/listing: get: tags: - Metrics summary: Listing of all supported metrics by CoinAPI description: Get all data metrics. responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Metric' examples: Example response: value: [ { "metric_id": "LIQUIDATION_QUANTITY", "description": "The liquidation quantity metric calculates the specific amount of the asset that must be sold to settle the trader's obligations and bring their position back to a manageable level. It helps ensure that the trader's losses are covered and that their account remains in good standing." }, { "metric_id": "DERIVATIVES_LAST_PRICE", "description": "The last price represents the price at which the most recent trade of the derivative contract occurred. It provides traders and investors with the latest information on the market value of the derivative, allowing them to assess the current market sentiment, track price movements, and make informed decisions regarding their derivative positions. The derivatives last price metric is crucial for monitoring real-time market conditions and managing derivative trading strategies effectively." } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Metric' examples: Example response: value: [ { "metric_id": "LIQUIDATION_QUANTITY", "description": "The liquidation quantity metric calculates the specific amount of the asset that must be sold to settle the trader's obligations and bring their position back to a manageable level. It helps ensure that the trader's losses are covered and that their account remains in good standing." }, { "metric_id": "DERIVATIVES_LAST_PRICE", "description": "The last price represents the price at which the most recent trade of the derivative contract occurred. It provides traders and investors with the latest information on the market value of the derivative, allowing them to assess the current market sentiment, track price movements, and make informed decisions regarding their derivative positions. The derivatives last price metric is crucial for monitoring real-time market conditions and managing derivative trading strategies effectively." } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Metric' examples: Example response: value: [ { "metric_id": "LIQUIDATION_QUANTITY", "description": "The liquidation quantity metric calculates the specific amount of the asset that must be sold to settle the trader's obligations and bring their position back to a manageable level. It helps ensure that the trader's losses are covered and that their account remains in good standing." }, { "metric_id": "DERIVATIVES_LAST_PRICE", "description": "The last price represents the price at which the most recent trade of the derivative contract occurred. It provides traders and investors with the latest information on the market value of the derivative, allowing them to assess the current market sentiment, track price movements, and make informed decisions regarding their derivative positions. The derivatives last price metric is crucial for monitoring real-time market conditions and managing derivative trading strategies effectively." } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Metric' examples: Example response: value: [ { "metric_id": "LIQUIDATION_QUANTITY", "description": "The liquidation quantity metric calculates the specific amount of the asset that must be sold to settle the trader's obligations and bring their position back to a manageable level. It helps ensure that the trader's losses are covered and that their account remains in good standing." }, { "metric_id": "DERIVATIVES_LAST_PRICE", "description": "The last price represents the price at which the most recent trade of the derivative contract occurred. It provides traders and investors with the latest information on the market value of the derivative, allowing them to assess the current market sentiment, track price movements, and make informed decisions regarding their derivative positions. The derivatives last price metric is crucial for monitoring real-time market conditions and managing derivative trading strategies effectively." } ] /v1/metrics/exchange/listing: get: tags: - Metrics summary: Listing of all supported exchange metrics description: Get data metrics for exchange. parameters: - name: metric_id in: query description: The metric identifier (from the Metrics -> Listing) schema: type: string - name: exchange_id in: query description: The exchange identifier (from the Metadata -> Exchanges) required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "exchange_id": "BINANCEFTS" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "exchange_id": "BINANCEFTS" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "exchange_id": "BINANCEFTS" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "exchange_id": "BINANCEFTS" } ] /v1/metrics/exchange/current: get: tags: - Metrics summary: Current metrics for given exchange description: Get current exchange metrics values. parameters: - name: metric_id in: query description: The metric identifier (from the Metrics -> Listing) schema: type: string - name: exchange_id in: query description: The exchange identifier (from the Metadata -> Exchanges) required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] /v1/metrics/exchange/history: get: tags: - Metrics summary: Historical metrics for the exchange description: Get exchange metrics history. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) required: true schema: type: string - name: exchange_id in: query description: Exchange identifier (from the Metadata -> Exchanges) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 schema: type: string format: date-time - name: time_end in: query description: Ending time in ISO 8601 schema: type: string format: date-time - name: time_format in: query description: 'If set, returned values will be in unix timestamp format (valid values: unix_sec, unix_millisec, unix_microsec, unix_nanosec)' schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (e.g. `5SEC` or `2MTH`), default value is `1SEC`' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] /v1/metrics/symbol/listing: get: tags: - Metrics summary: Listing of all supported metrics for symbol description: Get data metrics for symbol. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) schema: type: string - name: exchange_id in: query description: Exchange identifier (from the Metadata -> Exchanges) schema: type: string - name: symbol_id in: query description: Symbol identifier (from the Metadata -> Symbols) schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] /v1/metrics/symbol/current: get: tags: - Metrics summary: Current metrics for given symbol description: Get current symbol metrics. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) schema: type: string - name: symbol_id in: query description: Symbol identifier (from the Metadata -> Symbols) schema: type: string - name: exchange_id in: query description: Exchange id (from the Metadata -> Exchanges) schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBITUAT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_RHO", "value_decimal": -594.10357 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_VEGA", "value_decimal": 49.31013 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_THETA", "value_decimal": -6.14104 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "DERIVATIVES_INDEX_PRICE", "value_decimal": 30027.74 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBITUAT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_RHO", "value_decimal": -594.10357 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_VEGA", "value_decimal": 49.31013 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_THETA", "value_decimal": -6.14104 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "DERIVATIVES_INDEX_PRICE", "value_decimal": 30027.74 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBITUAT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_RHO", "value_decimal": -594.10357 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_VEGA", "value_decimal": 49.31013 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_THETA", "value_decimal": -6.14104 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "DERIVATIVES_INDEX_PRICE", "value_decimal": 30027.74 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBITUAT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_RHO", "value_decimal": -594.10357 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_VEGA", "value_decimal": 49.31013 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "GREEKS_THETA", "value_decimal": -6.14104 }, { "entry_time": "2023-06-23T12:38:48.2782698Z", "recv_time": "2023-06-23T12:38:48.0140000Z", "exchange_id": "DERIBIT", "symbol_id": "DERIBIT_OPT_BTC_USD_240329_80000_P", "metric_id": "DERIVATIVES_INDEX_PRICE", "value_decimal": 30027.74 } ] /v1/metrics/symbol/history: get: tags: - Metrics summary: Historical metrics for symbol description: Get symbol metrics history. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) required: true schema: type: string - name: symbol_id in: query description: Symbol identifier (from the Metadata -> Symbols) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 schema: type: string format: date-time - name: time_end in: query description: Ending time in ISO 8601 schema: type: string format: date-time - name: time_format in: query description: 'If set, returned values will be in unix timestamp format (valid values: unix_sec, unix_millisec, unix_microsec, unix_nanosec)' schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (e.g. `5SEC` or `2MTH`), default value is `1SEC`' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' examples: Example response: value: [ { "time_period_start": "2023-07-03T14:29:02.0000000Z", "time_period_end": "2023-07-03T14:29:03.0000000Z", "time_open": "2023-07-03T14:29:02.5699837Z", "time_close": "2023-07-03T14:29:02.5699837Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 30668.476938 }, { "time_period_start": "2023-07-03T14:29:03.0000000Z", "time_period_end": "2023-07-03T14:29:04.0000000Z", "time_open": "2023-07-03T14:29:03.1076159Z", "time_close": "2023-07-03T14:29:03.1076159Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 0.05485331 }, { "time_period_start": "2023-07-03T14:29:04.0000000Z", "time_period_end": "2023-07-03T14:29:05.0000000Z", "time_open": "2023-07-03T14:29:04.5792149Z", "time_close": "2023-07-03T14:29:04.9459786Z", "first": 0, "last": 0, "min": 0, "max": 0, "count": 0, "sum": 7.0257000000000005 } ] /v1/metrics/asset/listing: get: tags: - Metrics summary: Listing of all supported metrics for asset description: Get data metrics for asset. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) schema: type: string - name: exchange_id in: query description: Exchange identifier (from the Metadata -> Exchanges) schema: type: string - name: chain_id in: query description: Chain identifier schema: type: string - name: network_id in: query description: Network identifier schema: type: string - name: asset_id in: query description: Asset identifier (from the Metadata -> Assets) schema: type: string - name: asset_id_external in: query description: The asset external identifier schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.ListingItem' examples: Example response: value: [ { "metric_id": "LIQUIDATION_TIME_IN_FORCE", "symbol_id": "BINANCEFTS_PERP_ETC_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_TYPE", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" }, { "metric_id": "LIQUIDATION_ORDER_STATUS", "symbol_id": "BINANCEFTS_PERP_EOS_USDT", "exchange_id": "BINANCEFTS" } ] /v1/metrics/asset/current: get: tags: - Metrics summary: Current metrics for given asset description: Get current asset metrics. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) schema: type: string - name: asset_id in: query description: Asset identifier (from the Metadata -> Assets) schema: type: string - name: asset_id_external in: query description: Exchange asset identifier schema: type: string - name: exchange_id in: query description: Exchange identifier (from the Metadata -> Exchanges) schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.GeneralData' examples: Example response: value: [ { "entry_time": "2023-06-16T07:55:07.2787756Z", "recv_time": "2023-06-16T07:55:07.0010000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE", "value_decimal": 0.0086 }, { "entry_time": "2023-06-26T07:05:39.9865633Z", "recv_time": "2023-06-26T07:05:39.9000000Z", "exchange_id": "DERIBIT", "metric_id": "IV_UNDERLYING_PRICE", "value_decimal": 30743.29 }, { "entry_time": "2023-06-26T07:05:17.0768012Z", "recv_time": "2023-06-26T07:05:16.8420000Z", "exchange_id": "DERIBIT", "metric_id": "DERIVATIVES_MARK_PRICE_IV", "value_decimal": 60.77 } ] /v1/metrics/asset/history: get: tags: - Metrics summary: Historical metrics for asset description: Get asset metrics history. parameters: - name: metric_id in: query description: Metric identifier (from the Metrics -> Listing) required: true schema: type: string - name: asset_id in: query description: Asset identifier (from the Metadata -> Assets) schema: type: string - name: asset_id_external in: query description: Exchange asset identifier schema: type: string - name: exchange_id in: query description: Exchange identifier (from the Metadata -> Exchanges) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 schema: type: string format: date-time - name: time_end in: query description: Ending time in ISO 8601 schema: type: string format: date-time - name: time_format in: query description: 'If set, returned values will be in unix timestamp format (valid values: unix_sec, unix_millisec, unix_microsec, unix_nanosec)' schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (e.g. `5SEC` or `2MTH`), default value is `1SEC`' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' application/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' text/json: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.MetricData' '/v1/orderbooks/{symbol_id}/depth/current': get: tags: - Order Book summary: '[order book] Current depth of the order book' description: Retrieves the current depth of the order book for the specified symbol. parameters: - name: symbol_id in: path description: The symbol ID (from the Metadata -> Symbols) required: true schema: type: string - name: limit_levels in: query description: The maximum number of levels to include in the response. schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.OrderBookDepth' application/json: schema: $ref: '#/components/schemas/v1.OrderBookDepth' text/json: schema: $ref: '#/components/schemas/v1.OrderBookDepth' application/x-msgpack: schema: $ref: '#/components/schemas/v1.OrderBookDepth' '/v1/orderbooks/{symbol_id}/history': get: tags: - Order Book summary: '[order book] Historical data' description: "Get historical order book snapshots for a specific symbol within time range, returned in time ascending order.\r\n \r\n:::info\r\nThe historical order book data via the REST API is currently limited by a number of updates and to the maximum number of 20 levels.\r\n:::" parameters: - name: symbol_id in: path description: Symbol identifier for requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 (required) schema: type: string - name: time_end in: query description: 'Timeseries ending time in ISO 8601 (optional, if not supplied then the data is returned to the end or when result elements count reaches the limit)' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: limit_levels in: query description: Maximum amount of levels from each side of the book to include in response (optional) schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] '/v1/orderbooks/{symbol_id}/current': get: tags: - Order Book summary: Get current order book description: Retrieves the current order book for the specified symbol. parameters: - name: symbol_id in: path description: The symbol ID (from the Metadata -> Symbols) required: true schema: type: string - name: limit_levels in: query description: The maximum number of levels to include in the response. schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } application/json: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } text/json: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } application/x-msgpack: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } '/v1/orderbooks/{symbol_id}/latest': get: tags: - Order Book summary: '[order book] Latest data' description: "Get latest order book snapshots for a specific symbol, returned in time descending order.\r\n \r\n:::info\r\nThe historical order book data via the REST API is currently limited by a number of updates and to the maximum number of 20 levels.\r\n:::" parameters: - name: symbol_id in: path description: Symbol identifier of requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: limit_levels in: query description: Maximum amount of levels from each side of the book to include in response (optional) schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.OrderBook' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "asks": [ { "price": 456.35, "size": 123 }, { "price": 456.36, "size": 23 } ], "bids": [ { "price": 456.1, "size": 42 }, { "price": 456.09, "size": 5 } ] } ] /v1/orderbooks3/current: get: tags: - Order Book L3 summary: '[order book l3] Current order books' parameters: - name: filter_symbol_id in: query description: Comma or semicolon delimited parts of symbol identifier used to filter the response. schema: type: string - name: limit_levels in: query description: The maximum number of levels to include in the response. schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.OrderBookBase' application/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBookBase' text/json: schema: type: array items: $ref: '#/components/schemas/v1.OrderBookBase' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.OrderBookBase' '/v1/orderbooks3/{symbol_id}/current': get: tags: - Order Book L3 summary: '[order book l3] Current order book by symbol_id' description: Retrieves the current order book for the specified symbol. parameters: - name: symbol_id in: path description: The symbol ID (from the Metadata -> Symbols) required: true schema: type: string - name: limit_levels in: query description: The maximum number of levels to include in the response. schema: type: integer format: int32 responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } application/json: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } text/json: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } application/x-msgpack: schema: $ref: '#/components/schemas/v1.OrderBookBase' examples: Example response: value: { "symbol_id": "COINBASE_SPOT_BCH_USD", "time_exchange": "2020-08-27T10:28:35.6111130Z", "time_coinapi": "2020-08-27T10:28:35.6766461Z", "asks": [ { "id": "3c5e789c-4c84-448a-9c5d-50532ea1ccbb", "price": 272.89, "size": 1 }, { "id": "c64a76ba-5107-4c1b-b788-271ee88df318", "price": 272.9, "size": 18 } ], "bids": [ { "id": "100d5004-f4e0-4e92-a571-392403d5b073", "price": 272.83, "size": 18 }, { "id": "0889cf06-4a9d-4519-98e6-fac5dcb7afbf", "price": 272.83, "size": 0.64185083 } ] } '/v1/quotes/{symbol_id}/history': get: tags: - Quotes summary: '[quotes] Historical data' description: 'Get historical quote updates within requested time range, returned in time ascending order.' parameters: - name: symbol_id in: path description: Symbol identifier for requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 (required) schema: type: string - name: time_end in: query description: 'Timeseries ending time in ISO 8601 (optional, if not supplied then the data is returned to the end or when result elements count reaches the limit)' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, minimum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] /v1/quotes/current: get: tags: - Quotes summary: '[quotes] Current data' description: "Get current quotes for all symbols or for a specific symbol.\r\n \r\n:::info\r\nWhen requesting current data for a specific symbol, output is not encapsulated into JSON array as only one item is returned.\r\n:::" parameters: - name: filter_symbol_id in: query description: Comma or semicolon delimited parts of symbol identifier used to filter response. (optional) schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] '/v1/quotes/{symbol_id}/current': get: tags: - Quotes summary: '[quotes] Current quotes for a specific symbol' parameters: - name: symbol_id in: path description: The symbol identifier (from the Metadata -> Symbols) required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] application/json: schema: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] text/json: schema: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] application/x-msgpack: schema: $ref: '#/components/schemas/v1.QuoteTrade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124, "last_trade": { "time_exchange": "2017-03-18T22:42:21.3763342Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } } ] /v1/quotes/latest: get: tags: - Quotes summary: '[quotes] Latest data' description: Get latest updates of the quotes up to 1 minute ago. Latest data is always returned in time descending order. parameters: - name: filter_symbol_id in: query description: Comma or semicolon delimited parts of symbol identifier used to filter response. (optional) schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] '/v1/quotes/{symbol_id}/latest': get: tags: - Quotes summary: '[quotes] Latest quote updates for a specific symbol' parameters: - name: symbol_id in: path description: Symbol identifier of requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Quote' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "ask_price": 770.0, "ask_size": 3252, "bid_price": 760, "bid_size": 124 } ] /v1/symbols: get: tags: - Metadata summary: List all symbols description: "Retrieves all symbols with optional filtering.\r\n \r\n:::info\r\n\"price_precision\" and \"size_precision\" are data precisions and are not always the same precisions used for trading eg. for the \"BINANCE\" exchanges.\r\n:::\r\n \r\n:::info\r\nYou should not assume that the market data will be always within the resolution provided by the \"price_precision\" and \"size_precision\". The fact that the precision values can be derived from a posterior implies the fact that this data could be delayed, also it can be changed by the data source without notice and we will immediately deliver data with the new precision while could not update the precision values in this endpoint immediately.\r\n:::\r\n \r\n### Symbol identifier\r\n \r\nOur symbol identifier is created using a pattern that depends on symbol type.\r\n \r\nType | `symbol_id` pattern\r\n--------- | ---------\r\nSPOT | `{exchange_id}_SPOT_{asset_id_base}_{asset_id_quote}`\r\nFUTURES | `{exchange_id}_FTS_{asset_id_base}_{asset_id_quote}_{YYMMDD of future_delivery_time}`\r\nOPTION | `{exchange_id}_OPT_{asset_id_base}_{asset_id_quote}_{YYMMDD of option_expiration_time}_{option_strike_price}_{option_type_is_call as C/P}`\r\nPERPETUAL | `{exchange_id}_PERP_{asset_id_base}_{asset_id_quote}`\r\nINDEX | `{exchange_id}_IDX_{index_id}`\r\nCREDIT | `{exchange_id}_CRE_{asset_id_base}`\r\nCONTACT | `{exchange_id}_COT_{contract_id}`\r\n \r\n:::info\r\nIn the unlikely event when the \"symbol_id\" for more than one market is the same. We will append the additional term (prefixed with the \"_\") at the end of the duplicated identifiers to differentiate them.\r\n:::info\r\n \r\n### Symbol types list (enumeration of `symbol_type` output variable)\r\n \r\nType | Name | Description\r\n-------- | - | -----------\r\nSPOT | FX Spot | Agreement to exchange one asset for another one *(e.g. Buy BTC for USD)*\r\nFUTURES | Futures contract | FX Spot derivative contract where traders agree to trade fx spot at predetermined future time\r\nOPTION | Option contract | FX Spot derivative contract where traders agree to trade right to require buy or sell of fx spot at agreed price on exercise date\r\nPERPETUAL | Perpetual contract | FX Spot derivative contract where traders agree to trade fx spot continously without predetermined future delivery time\r\nINDEX | Index | Statistical composite that measures changes in the economy or markets.\r\nCREDIT | Credit/Funding | Margin funding contract. Order book displays lending offers and borrow bids. Price represents the daily rate.\r\nCONTRACT | Contract | Represents other types of financial instruments *(e.g. spreads, interest rate swap)*\r\n \r\n### Additional output variables for `symbol_type = INDEX`\r\n \r\nVariable | Description\r\n--------- | -----------\r\nindex_id | Index identifier\r\nindex_display_name | Human readable name of the index *(optional)*\r\nindex_display_description | Description of the index *(optional)*\r\n \r\n### Additional output variables for `symbol_type = FUTURES`\r\n \r\nVariable | Description\r\n--------- | -----------\r\nfuture_delivery_time | Predetermined time of futures contract delivery date in ISO 8601\r\nfuture_contract_unit | Contact size *(eg. 10 BTC if `future_contract_unit` = `10` and `future_contract_unit_asset` = `BTC`)*\r\nfuture_contract_unit_asset | Identifier of the asset used to denominate the contract unit\r\n \r\n### Additional output variables for `symbol_type = PERPETUAL`\r\n \r\nVariable | Description\r\n--------- | -----------\r\nfuture_contract_unit | Contact size *(eg. 10 BTC if `future_contract_unit` = `10` and `future_contract_unit_asset` = `BTC`)*\r\nfuture_contract_unit_asset | Identifier of the asset used to denominate the contract unit\r\n \r\n### Additional output variables for `symbol_type = OPTION`\r\n \r\nVariable | Description\r\n--------- | -----------\r\noption_type_is_call | Boolean value representing option type. `true` for Call options, `false` for Put options\r\noption_strike_price | Price at which option contract can be exercised\r\noption_contract_unit | Base asset amount of underlying spot which single option represents\r\noption_exercise_style | Option exercise style. Can be `EUROPEAN` or `AMERICAN`\r\noption_expiration_time | Option contract expiration time in ISO 8601\r\n \r\n### Additional output variables for `symbol_type = CONTRACT`\r\n \r\nVariable | Description\r\n--------- | -----------\r\ncontract_delivery_time | Predetermined time of contract delivery date in ISO 8601\r\ncontract_unit | Contact size *(eg. 10 BTC if `contract_unit` = `10` and `contract_unit_asset` = `BTC`)*\r\ncontract_unit_asset | Identifier of the asset used to denominate the contract unit\r\ncontract_id | Identifier of contract by the exchange" parameters: - name: filter_symbol_id in: query description: 'Comma or semicolon delimited parts of symbol identifier used to filter response. (optional, eg. `BITSTAMP`_ or `BINANCE_SPOT_`)' schema: type: string - name: filter_exchange_id in: query description: The filter for exchange ID. schema: type: string - name: filter_asset_id in: query description: The filter for asset ID. schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] '/v1/symbols/map/{exchange_id}': get: tags: - Metadata summary: List symbol mapping for the exchange parameters: - name: exchange_id in: path description: The ID of the exchange (from the Metadata -> Exchanges) required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.SymbolMapping' application/json: schema: type: array items: $ref: '#/components/schemas/v1.SymbolMapping' text/json: schema: type: array items: $ref: '#/components/schemas/v1.SymbolMapping' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.SymbolMapping' '/v1/symbols/{exchange_id}': get: tags: - Metadata summary: List of symbols for the exchange parameters: - name: exchange_id in: path description: The ID of the exchange (from the Metadata -> Exchanges) required: true schema: type: string - name: filter_symbol_id in: query description: The filter for symbol ID. schema: type: string - name: filter_asset_id in: query description: The filter for asset ID. schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Symbol' examples: Example response: value: [ { "symbol_id": "KRAKENFTS_PERP_BTC_USD", "exchange_id": "KRAKENFTS", "symbol_type": "PERPETUAL", "asset_id_base": "BTC", "asset_id_quote": "USD", "asset_id_unit": "USD", "future_contract_unit": 1.000000000, "future_contract_unit_asset": "USD", "data_start": "2019-10-30", "data_end": "2021-03-03", "data_quote_start": "2019-10-30T16:53:10.3262317Z", "data_quote_end": "2021-03-03T13:51:45.6970000Z", "data_orderbook_start": "2019-10-30T16:53:10.3262317Z", "data_orderbook_end": "2020-08-05T14:37:32.0080000Z", "data_trade_start": "2019-10-30T16:38:52.1620000Z", "data_trade_end": "2021-03-03T13:46:25.7810000Z", "volume_1hrs": 22897091.000000000, "volume_1hrs_usd": 22897091.00, "volume_1day": 459390289.000000000, "volume_1day_usd": 459390289.00, "volume_1mth": 12875674995.000000000, "volume_1mth_usd": 12875674995.00, "price": 51266, "symbol_id_exchange": "pi_xbtusd", "asset_id_base_exchange": "XBT", "asset_id_quote_exchange": "USD", "price_precision": 0.100000000, "size_precision": 1.000000000 }, { "symbol_id": "POLONIEX_SPOT_LTC_USDC", "exchange_id": "POLONIEX", "symbol_type": "SPOT", "asset_id_base": "LTC", "asset_id_quote": "USDC", "data_start": "2018-11-20", "data_end": "2021-03-01", "data_quote_start": "2018-11-20T15:24:58.4128803Z", "data_quote_end": "2021-03-01T16:07:09.3475456Z", "data_orderbook_start": "2018-11-20T15:24:58.4128803Z", "data_orderbook_end": "2020-08-05T14:37:20.2695780Z", "data_trade_start": "2018-11-20T15:25:38.0000000Z", "data_trade_end": "2021-03-01T16:03:18.0000000Z", "volume_1hrs": 51.686458990, "volume_1hrs_usd": 9036.44, "volume_1day": 465.568863000, "volume_1day_usd": 81396.28, "volume_1mth": 22528.276384950, "volume_1mth_usd": 3938661.00, "symbol_id_exchange": "USDC_LTC", "asset_id_base_exchange": "LTC", "asset_id_quote_exchange": "USDC", "price_precision": 0.000000010, "size_precision": 0.000000010 } ] /v1/ohlcv/periods: get: tags: - Ohlcv summary: '[ohlcv] List all periods' description: "Get full list of supported time periods available for requesting OHLCV timeseries data.\r\n \r\n### Available periods\r\n \r\nTime unit | Period identifiers\r\n--------- | -----------\r\nSecond | 1SEC, 2SEC, 3SEC, 4SEC, 5SEC, 6SEC, 10SEC, 15SEC, 20SEC, 30SEC\r\nMinute | 1MIN, 2MIN, 3MIN, 4MIN, 5MIN, 6MIN, 10MIN, 15MIN, 20MIN, 30MIN\r\nHour | 1HRS, 2HRS, 3HRS, 4HRS, 6HRS, 8HRS, 12HRS\r\nDay | 1DAY, 2DAY, 3DAY, 5DAY, 7DAY, 10DAY\r\nMonth | 1MTH, 2MTH, 3MTH, 4MTH, 6MTH\r\nYear | 1YRS, 2YRS, 3YRS, 4YRS, 5YRS\r\n \r\n:::tip\r\nYou can assume that we will not remove any periods from this response, however, we may add new ones.\r\n:::" responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" }, { "period_id": "2YRS", "length_seconds": 0, "length_months": 24, "unit_count": 2, "unit_name": "year", "display_name": "2 Years" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" }, { "period_id": "2YRS", "length_seconds": 0, "length_months": 24, "unit_count": 2, "unit_name": "year", "display_name": "2 Years" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" }, { "period_id": "2YRS", "length_seconds": 0, "length_months": 24, "unit_count": 2, "unit_name": "year", "display_name": "2 Years" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesPeriod' examples: Example response: value: [ { "period_id": "1SEC", "length_seconds": 1, "length_months": 0, "unit_count": 1, "unit_name": "second", "display_name": "1 Second" }, { "period_id": "10DAY", "length_seconds": 864000, "length_months": 0, "unit_count": 10, "unit_name": "day", "display_name": "10 Days" }, { "period_id": "2YRS", "length_seconds": 0, "length_months": 24, "unit_count": 2, "unit_name": "year", "display_name": "2 Years" } ] '/v1/ohlcv/{symbol_id}/history': get: tags: - Ohlcv summary: '[ohlcv] Historical data' description: "Get OHLCV timeseries data returned in time ascending order. Data can be requested by the period and for the specific symbol eg `BITSTAMP_SPOT_BTC_USD`, if you need to query timeseries by asset pairs eg. `BTC/USD`, then please reffer to the Exchange Rates Timeseries data\r\n \r\n:::info\r\nThe OHLCV Historical endpoint data can be delayed a few seconds. Use OHLCV Latest endpoint to get real-time data without delay.\r\n:::" parameters: - name: symbol_id in: path description: Symbol identifier of requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (required, e.g. `5SEC` or `2MTH`)' schema: type: string - name: time_start in: query description: Timeseries starting time in ISO 8601 (required) schema: type: string - name: time_end in: query description: 'Timeseries ending time in ISO 8601 (optional, if not supplied then the data is returned to the end or when count of result elements reaches the limit)' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: include_empty_items in: query description: 'Include items with no activity? (optional, default value is `false`, possible values are `true` or `false`)' schema: type: boolean default: false responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-01-01T00:00:00.0000000Z", "time_period_end": "2017-01-02T00:00:00.0000000Z", "time_open": "2017-01-01T00:01:08.0000000Z", "time_close": "2017-01-01T23:59:46.0000000Z", "price_open": 966.34, "price_high": 1005.0, "price_low": 960.53, "price_close": 997.75, "volume_traded": 6850.59330859, "trades_count": 7815 }, { "time_period_start": "2017-01-02T00:00:00.0000000Z", "time_period_end": "2017-01-03T00:00:00.0000000Z", "time_open": "2017-01-02T00:00:05.0000000Z", "time_close": "2017-01-02T23:59:37.0000000Z", "price_open": 997.75, "price_high": 1032.0, "price_low": 990.01, "price_close": 1012.54, "volume_traded": 8167.38103018, "trades_count": 7871 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-01-01T00:00:00.0000000Z", "time_period_end": "2017-01-02T00:00:00.0000000Z", "time_open": "2017-01-01T00:01:08.0000000Z", "time_close": "2017-01-01T23:59:46.0000000Z", "price_open": 966.34, "price_high": 1005.0, "price_low": 960.53, "price_close": 997.75, "volume_traded": 6850.59330859, "trades_count": 7815 }, { "time_period_start": "2017-01-02T00:00:00.0000000Z", "time_period_end": "2017-01-03T00:00:00.0000000Z", "time_open": "2017-01-02T00:00:05.0000000Z", "time_close": "2017-01-02T23:59:37.0000000Z", "price_open": 997.75, "price_high": 1032.0, "price_low": 990.01, "price_close": 1012.54, "volume_traded": 8167.38103018, "trades_count": 7871 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-01-01T00:00:00.0000000Z", "time_period_end": "2017-01-02T00:00:00.0000000Z", "time_open": "2017-01-01T00:01:08.0000000Z", "time_close": "2017-01-01T23:59:46.0000000Z", "price_open": 966.34, "price_high": 1005.0, "price_low": 960.53, "price_close": 997.75, "volume_traded": 6850.59330859, "trades_count": 7815 }, { "time_period_start": "2017-01-02T00:00:00.0000000Z", "time_period_end": "2017-01-03T00:00:00.0000000Z", "time_open": "2017-01-02T00:00:05.0000000Z", "time_close": "2017-01-02T23:59:37.0000000Z", "price_open": 997.75, "price_high": 1032.0, "price_low": 990.01, "price_close": 1012.54, "volume_traded": 8167.38103018, "trades_count": 7871 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-01-01T00:00:00.0000000Z", "time_period_end": "2017-01-02T00:00:00.0000000Z", "time_open": "2017-01-01T00:01:08.0000000Z", "time_close": "2017-01-01T23:59:46.0000000Z", "price_open": 966.34, "price_high": 1005.0, "price_low": 960.53, "price_close": 997.75, "volume_traded": 6850.59330859, "trades_count": 7815 }, { "time_period_start": "2017-01-02T00:00:00.0000000Z", "time_period_end": "2017-01-03T00:00:00.0000000Z", "time_open": "2017-01-02T00:00:05.0000000Z", "time_close": "2017-01-02T23:59:37.0000000Z", "price_open": 997.75, "price_high": 1032.0, "price_low": 990.01, "price_close": 1012.54, "volume_traded": 8167.38103018, "trades_count": 7871 } ] '/v1/ohlcv/exchanges/{exchange_id}/history': get: tags: - Ohlcv summary: '[ohlcv] Historical data by exchange' description: "Get OHLCV timeseries data returned in time ascending order. Data can be requested by the period and for the specific exchange eg `BITSTAMP`\r\n \r\n:::info\r\nThe OHLCV Historical endpoint data can be delayed a few seconds.\r\nThe difference between `time_end` and `time_start` cannot be higher than 1 day.\r\nThe `period_id` cannot be higher than `1DAY`.\r\n:::" parameters: - name: exchange_id in: path description: Exchange identifier of requested timeseries (from the Metadata -> Exchanges) required: true schema: type: string - name: period_id in: query description: Identifier of requested timeseries period (e.g. `5SEC` or `1DAY`) required: true schema: type: string - name: time_start in: query description: Timeseries starting time in ISO 8601 required: true schema: type: string - name: time_end in: query description: Timeseries ending time in ISO 8601 required: true schema: type: string responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/Models.ExchangeTimeseriesItem' application/json: schema: type: array items: $ref: '#/components/schemas/Models.ExchangeTimeseriesItem' text/json: schema: type: array items: $ref: '#/components/schemas/Models.ExchangeTimeseriesItem' application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/Models.ExchangeTimeseriesItem' '/v1/ohlcv/{symbol_id}/latest': get: tags: - Ohlcv summary: '[ohlcv] Latest data' description: "Get OHLCV latest timeseries data returned in time descending order. Data can be requested by the period and for the specific symbol eg `BITSTAMP_SPOT_BTC_USD`, if you need to query timeseries by asset pairs eg. `BTC/USD`, then please reffer to the Exchange Rates Timeseries data\r\n \r\n:::info\r\nOHLCV Latest endpoint is providing real-time data without delay. The OHLCV Historical endpoint data can be delayed a few seconds.\r\n:::" parameters: - name: symbol_id in: path description: Symbol identifier of requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: period_id in: query description: 'Identifier of requested timeseries period (required, e.g. `5SEC` or `2MTH`)' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: include_empty_items in: query description: 'Include items with no activity? (optional, default value is `false`, possible values are `true` or `false`)' schema: type: boolean default: false responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-08-09T14:31:00.0000000Z", "time_period_end": "2017-08-09T14:32:00.0000000Z", "time_open": "2017-08-09T14:31:01.0000000Z", "time_close": "2017-08-09T14:31:46.0000000Z", "price_open": 3255.59, "price_high": 3255.59, "price_low": 3244.74, "price_close": 3244.74, "volume_traded": 16.90327455, "trades_count": 31 }, { "time_period_start": "2017-08-09T14:30:00.0000000Z", "time_period_end": "2017-08-09T14:31:00.0000000Z", "time_open": "2017-08-09T14:30:05.0000000Z", "time_close": "2017-08-09T14:30:35.0000000Z", "price_open": 3256.0, "price_high": 3256.01, "price_low": 3247.0, "price_close": 3255.6, "volume_traded": 58.13139792, "trades_count": 33 } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-08-09T14:31:00.0000000Z", "time_period_end": "2017-08-09T14:32:00.0000000Z", "time_open": "2017-08-09T14:31:01.0000000Z", "time_close": "2017-08-09T14:31:46.0000000Z", "price_open": 3255.59, "price_high": 3255.59, "price_low": 3244.74, "price_close": 3244.74, "volume_traded": 16.90327455, "trades_count": 31 }, { "time_period_start": "2017-08-09T14:30:00.0000000Z", "time_period_end": "2017-08-09T14:31:00.0000000Z", "time_open": "2017-08-09T14:30:05.0000000Z", "time_close": "2017-08-09T14:30:35.0000000Z", "price_open": 3256.0, "price_high": 3256.01, "price_low": 3247.0, "price_close": 3255.6, "volume_traded": 58.13139792, "trades_count": 33 } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-08-09T14:31:00.0000000Z", "time_period_end": "2017-08-09T14:32:00.0000000Z", "time_open": "2017-08-09T14:31:01.0000000Z", "time_close": "2017-08-09T14:31:46.0000000Z", "price_open": 3255.59, "price_high": 3255.59, "price_low": 3244.74, "price_close": 3244.74, "volume_traded": 16.90327455, "trades_count": 31 }, { "time_period_start": "2017-08-09T14:30:00.0000000Z", "time_period_end": "2017-08-09T14:31:00.0000000Z", "time_open": "2017-08-09T14:30:05.0000000Z", "time_close": "2017-08-09T14:30:35.0000000Z", "price_open": 3256.0, "price_high": 3256.01, "price_low": 3247.0, "price_close": 3255.6, "volume_traded": 58.13139792, "trades_count": 33 } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.TimeseriesItem' examples: Example response: value: [ { "time_period_start": "2017-08-09T14:31:00.0000000Z", "time_period_end": "2017-08-09T14:32:00.0000000Z", "time_open": "2017-08-09T14:31:01.0000000Z", "time_close": "2017-08-09T14:31:46.0000000Z", "price_open": 3255.59, "price_high": 3255.59, "price_low": 3244.74, "price_close": 3244.74, "volume_traded": 16.90327455, "trades_count": 31 }, { "time_period_start": "2017-08-09T14:30:00.0000000Z", "time_period_end": "2017-08-09T14:31:00.0000000Z", "time_open": "2017-08-09T14:30:05.0000000Z", "time_close": "2017-08-09T14:30:35.0000000Z", "price_open": 3256.0, "price_high": 3256.01, "price_low": 3247.0, "price_close": 3255.6, "volume_traded": 58.13139792, "trades_count": 33 } ] '/v1/trades/{symbol_id}/history': get: tags: - Trades summary: '[trades] Historical data' description: 'Get history transactions from specific symbol, returned in time ascending order.' parameters: - name: symbol_id in: path description: Symbol identifier for requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: time_start in: query description: Starting time in ISO 8601 (required) schema: type: string - name: time_end in: query description: 'Timeseries ending time in ISO 8601 (optional, if not supplied then the data is returned to the end or when result elements count reaches the limit)' schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: include_id in: query description: Information that additional exchange trade identifier should be included in the `id_trade` parameter of the trade if exchange providing identifiers. schema: type: boolean default: false responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] '/v1/trades/{symbol_id}/latest': get: tags: - Trades summary: '[trades] Latest data by symbol_id' description: Get latest trades executed up to 1 minute ago. Latest data is always returned in time descending order. parameters: - name: symbol_id in: path description: Symbol identifier for requested timeseries (from the Metadata -> Symbols) required: true schema: type: string - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 - name: include_id in: query description: Information that additional exchange trade identifier should be included in the `id_trade` parameter of the trade if exchange providing identifiers. schema: type: boolean default: false responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] /v1/trades/latest: get: tags: - Trades summary: '[trades] Latest data' description: Get latest trades executed up to 1 minute ago. Latest data is always returned in time descending order. parameters: - name: filter_symbol_id in: query description: Comma or semicolon delimited parts of symbol identifier used to filter response. (optional) schema: type: string - name: include_id in: query description: Information that additional exchange trade identifier should be included in the `id_trade` parameter of the trade if exchange providing identifiers. schema: type: boolean default: false - name: limit in: query description: 'Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)' schema: type: integer format: int32 default: 100 responses: '200': description: successful operation content: text/plain: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] text/json: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] application/x-msgpack: schema: type: array items: $ref: '#/components/schemas/v1.Trade' examples: Example response: value: [ { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T22:40:50.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "770c7a3b-7258-4441-8182-83740f3e2457", "price": 770.0, "size": 0.05, "taker_side": "BUY" }, { "symbol_id": "BITSTAMP_SPOT_BTC_USD", "time_exchange": "2013-09-28T23:12:59.0000000Z", "time_coinapi": "2017-03-18T22:42:21.3763342Z", "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2", "price": 770.0, "size": 0.05, "taker_side": "SELL" } ] components: schemas: Model.VWAP24RefRate: type: object properties: time: type: string format: date-time asset: type: string nullable: true rate: type: number format: double volume: type: number format: double additionalProperties: false Models.ExchangeTimeseriesItem: type: object properties: time_period_start: type: string description: The start time of the time period. format: date-time time_period_end: type: string description: The end time of the time period. format: date-time time_open: type: string description: The time when the price opened. format: date-time nullable: true time_close: type: string description: The time when the price closed. format: date-time nullable: true price_open: type: number description: The opening price. format: double nullable: true price_high: type: number description: The highest price during the time period. format: double nullable: true price_low: type: number description: The lowest price during the time period. format: double nullable: true price_close: type: number description: The closing price. format: double nullable: true volume_traded: type: number description: The total volume traded during the time period. format: double trades_count: type: integer description: The number of trades executed during the time period. format: int64 symbol_id_exchange: type: string nullable: true symbol_id_coinapi: type: string nullable: true additionalProperties: false description: Represents a timeseries item with price and volume information. v1.Asset: type: object properties: asset_id: type: string description: Gets or sets the asset ID. nullable: true name: type: string description: Gets or sets the name of the asset. nullable: true type_is_crypto: type: integer description: Gets or sets a value indicating whether the asset is a cryptocurrency. format: int32 data_quote_start: type: string description: Gets or sets the start date of quote data. format: date-time nullable: true data_quote_end: type: string description: Gets or sets the end date of quote data. format: date-time nullable: true data_orderbook_start: type: string description: Gets or sets the start date of order book data. format: date-time nullable: true data_orderbook_end: type: string description: Gets or sets the end date of order book data. format: date-time nullable: true data_trade_start: type: string description: Gets or sets the start date of trade data. format: date-time nullable: true data_trade_end: type: string description: Gets or sets the end date of trade data. format: date-time nullable: true data_symbols_count: type: integer description: Gets or sets the number of symbols. format: int64 nullable: true volume_1hrs_usd: type: number description: Gets or sets the USD volume in the last 1 hour. format: double nullable: true volume_1day_usd: type: number description: Gets or sets the USD volume in the last 1 day. format: double nullable: true volume_1mth_usd: type: number description: Gets or sets the USD volume in the last 1 month. format: double nullable: true price_usd: type: number description: Gets or sets the USD price of the asset. format: double nullable: true id_icon: type: string description: Gets or sets the ID of the icon for the asset. format: uuid nullable: true supply_current: type: number description: Gets or sets the current supply of the asset. format: double nullable: true supply_total: type: number description: Gets or sets the total supply of the asset. format: double nullable: true supply_max: type: number description: Gets or sets the maximum supply of the asset. format: double nullable: true chain_addresses: type: array items: $ref: '#/components/schemas/v1.ChainNetworkAddress' description: '' nullable: true data_start: type: string nullable: true readOnly: true data_end: type: string nullable: true readOnly: true additionalProperties: false description: Represents an asset. v1.ChainNetworkAddress: type: object properties: chain_id: type: string description: Gets or sets chain id nullable: true network_id: type: string description: Gets or sets network id nullable: true address: type: string description: Gets or sets chain address nullable: true additionalProperties: false description: Contains information about assets' chain network addresses v1.Exchange: type: object properties: exchange_id: type: string description: Gets or sets the exchange ID. nullable: true website: type: string description: Gets or sets the website URL of the exchange. nullable: true name: type: string description: Gets or sets the name of the exchange. nullable: true data_start: type: string nullable: true readOnly: true data_end: type: string nullable: true readOnly: true data_quote_start: type: string description: Gets or sets the start date of quote data. format: date-time nullable: true data_quote_end: type: string description: Gets or sets the end date of quote data. format: date-time nullable: true data_orderbook_start: type: string description: Gets or sets the start date of order book data. format: date-time nullable: true data_orderbook_end: type: string description: Gets or sets the end date of order book data. format: date-time nullable: true data_trade_start: type: string description: Gets or sets the start date of trade data. format: date-time nullable: true data_trade_end: type: string description: Gets or sets the end date of trade data. format: date-time nullable: true data_trade_count: type: integer description: Gets or sets the number of trades. format: int64 nullable: true data_symbols_count: type: integer description: Gets or sets the number of symbols. format: int64 nullable: true volume_1hrs_usd: type: number description: Gets or sets the USD volume in the last 1 hour. format: double nullable: true volume_1day_usd: type: number description: Gets or sets the USD volume in the last 1 day. format: double nullable: true volume_1mth_usd: type: number description: Gets or sets the USD volume in the last 1 month. format: double nullable: true metric_id: type: array items: type: string description: Gets or sets the list of metric IDs. nullable: true icons: type: array items: $ref: '#/components/schemas/v1.Icon' description: Gets or sets the list of icons for the exchange. nullable: true readOnly: true additionalProperties: false description: Represents an exchange. v1.ExchangeRate: type: object properties: time: type: string description: Gets or sets the time of the exchange rate. format: date-time asset_id_base: type: string description: Gets or sets the base asset ID of the exchange rate. nullable: true asset_id_quote: type: string description: Gets or sets the quote asset ID of the exchange rate. nullable: true rate: type: number description: Gets or sets the exchange rate value. format: double src_side_base: type: array items: $ref: '#/components/schemas/Model.VWAP24RefRate' description: Gets or sets the VWAP24 reference rates for the base asset. nullable: true src_side_quote: type: array items: $ref: '#/components/schemas/Model.VWAP24RefRate' description: Gets or sets the VWAP24 reference rates for the quote asset. nullable: true additionalProperties: false description: Represents an exchange rate. v1.ExchangeRatesRate: type: object properties: time: type: string description: Gets or sets the time of the exchange rate. format: date-time asset_id_quote: type: string description: Gets or sets the quote asset ID of the exchange rate. nullable: true rate: type: number description: Gets or sets the exchange rate value. format: double additionalProperties: false description: Represents an exchange rate within a collection of exchange rates. v1.ExchangeRatesTimeseriesItem: type: object properties: time_period_start: type: string description: Gets or sets the start time of the period. format: date-time time_period_end: type: string description: Gets or sets the end time of the period. format: date-time time_open: type: string description: Gets or sets the opening time of the period. format: date-time nullable: true time_close: type: string description: Gets or sets the closing time of the period. format: date-time nullable: true rate_open: type: number description: Gets or sets the opening rate for the period. format: double nullable: true rate_high: type: number description: Gets or sets the highest rate for the period. format: double nullable: true rate_low: type: number description: Gets or sets the lowest rate for the period. format: double nullable: true rate_close: type: number description: Gets or sets the closing rate for the period. format: double nullable: true additionalProperties: false description: Represents an item in the exchange rate timeseries. v1.ExchangeRates`1: type: object properties: asset_id_base: type: string description: Gets or sets the base asset ID. nullable: true rates: type: array items: $ref: '#/components/schemas/v1.ExchangeRatesRate' description: Gets or sets the list of exchange rates. nullable: true additionalProperties: false description: Represents exchange rates for a specific base asset. v1.GeneralData: type: object properties: entry_time: type: string description: Gets or sets the entry time for the data point. format: date-time recv_time: type: string description: Gets or sets the received time for the data point. format: date-time exchange_id: type: string description: Gets or sets the identifier for the exchange. nullable: true asset_id: type: string description: Gets or sets the identifier for the asset. nullable: true symbol_id: type: string description: Gets or sets the identifier for the symbol. nullable: true metric_id: type: string description: Gets or sets the identifier for the metric. nullable: true value_decimal: type: number description: Gets or sets the decimal value for the metric. format: double nullable: true value_text: type: string description: Gets or sets the textual representation of the value for the metric. nullable: true value_time: type: string description: Gets or sets the timestamp value for the metric. format: date-time nullable: true additionalProperties: false description: Class representation of general metric data. This class is an XML type with name 'general_data' and inherits from the BaseCsvModel class. v1.Icon: type: object properties: exchange_id: type: string description: Gets or sets the exchange ID associated with the icon. nullable: true asset_id: type: string description: Gets or sets the asset ID associated with the icon. nullable: true url: type: string description: Gets or sets the URL of the icon. nullable: true additionalProperties: false description: Represents an icon. v1.Index: type: object properties: index_id: type: string description: Gets or sets the index ID associated with the index. nullable: true name: type: string description: Gets or sets the name associated with the index. nullable: true description: type: string description: Gets or sets the descripion of the index. nullable: true additionalProperties: false description: Represents an index. v1.IndexTimeseriesItem: type: object properties: time_period_start: type: string description: The start time of the time period. format: date-time time_period_end: type: string description: The end time of the time period. format: date-time time_open: type: string description: The time when the value opened. format: date-time nullable: true time_close: type: string description: The time when the value closed. format: date-time nullable: true value_open: type: number description: The opening value. format: double nullable: true value_high: type: number description: The highest value during the time period. format: double nullable: true value_low: type: number description: The lowest value during the time period. format: double nullable: true value_close: type: number description: The closing value. format: double nullable: true value_count: type: integer description: The number of values during the time period. format: int64 additionalProperties: false description: Represents a timeseries item with value information. v1.IndexValue: type: object properties: timestamp: type: string format: date-time value: type: number format: double composition: type: array items: $ref: '#/components/schemas/v1.IndexValueComponent' nullable: true additionalProperties: false v1.IndexValueComponent: type: object properties: component_id: type: string nullable: true component_value: type: number format: double additionalProperties: false v1.LastTrade: type: object properties: time_exchange: type: string description: The exchange time of the last trade. format: date-time time_coinapi: type: string description: The CoinAPI time when the last trade was received. format: date-time uuid: type: string description: The UUID of the last trade. format: uuid price: type: number description: The price of the last trade. format: double size: type: number description: The size of the last trade. format: double taker_side: type: string description: The taker side of the last trade. nullable: true additionalProperties: false description: Represents the last executed transaction. v1.ListingItem: type: object properties: metric_id: type: string description: Gets or sets the metric ID. nullable: true symbol_id: type: string description: Gets or sets the symbol ID. nullable: true symbol_id_external: type: string description: Gets or sets the symbol ID from the exchange. nullable: true exchange_id: type: string description: Gets or sets the exchange ID. nullable: true asset_id: type: string description: Gets or sets the asset ID. nullable: true asset_id_external: type: string description: Gets or sets the asset ID from the exchange. nullable: true chain_id: type: string description: Gets or sets the chain id. nullable: true network_id: type: string description: Gets or sets the network id. nullable: true additionalProperties: false description: Represents a listing item. v1.Metric: type: object properties: metric_id: type: string description: Gets or sets the metric ID. nullable: true description: type: string description: Gets or sets the metric description. nullable: true additionalProperties: false description: Represents a metric. v1.MetricData: type: object properties: symbol_id: type: string description: Gets or sets the symbol id. nullable: true time: type: string description: Gets or sets the time at which the value is recorded. format: date-time value: type: number description: Gets or sets the value of the metric. format: double additionalProperties: false description: Represents a data model for metric data. v1.OrderBook: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The exchange time of the order book. format: date-time time_coinapi: type: string description: The CoinAPI time when the order book was received. format: date-time asks: description: The asks made by market makers. nullable: true bids: description: The bids made by market makers. nullable: true additionalProperties: false description: Represents an order book with additional information and functionality. v1.OrderBookBase: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The exchange time of the order book. format: date-time time_coinapi: type: string description: The CoinAPI time when the order book was received. format: date-time asks: description: The asks made by market makers. nullable: true bids: description: The bids made by market makers. nullable: true additionalProperties: false description: Represents the base model for order book data. v1.OrderBookDepth: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The exchange time of the order book. format: date-time time_coinapi: type: string description: The CoinAPI time when the order book was received. format: date-time ask_levels: type: integer description: The number of ask levels in the order book. format: int64 bid_levels: type: integer description: The number of bid levels in the order book. format: int64 ask_depth: type: number description: The depth of the ask side of the order book. format: double bid_depth: type: number description: The depth of the bid side of the order book. format: double additionalProperties: false description: Represents the depth of an order book. v1.Quote: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The exchange time of the quote. format: date-time time_coinapi: type: string description: The CoinAPI time when the quote was received. format: date-time ask_price: type: number description: The best asking price. format: double nullable: true ask_size: type: number description: 'The volume resting on the best ask. If the value is equal to zero, then the size is unknown.' format: double nullable: true bid_price: type: number description: The best bidding price. format: double nullable: true bid_size: type: number description: 'The volume resting on the best bid. If the value is equal to zero, then the size is unknown.' format: double nullable: true additionalProperties: false description: Represents a quote data model. v1.QuoteTrade: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The exchange time of the quote trade. format: date-time time_coinapi: type: string description: The CoinAPI time when the quote trade was received. format: date-time ask_price: type: number description: The best asking price. format: double nullable: true ask_size: type: number description: 'The volume resting on the best ask. If the value is equal to zero, then the size is unknown.' format: double nullable: true bid_price: type: number description: The best bidding price. format: double nullable: true bid_size: type: number description: 'The volume resting on the best bid. If the value is equal to zero, then the size is unknown.' format: double nullable: true last_trade: $ref: '#/components/schemas/v1.LastTrade' additionalProperties: false description: Represents a quote trade data model. v1.Symbol: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true exchange_id: type: string description: The exchange identifier. nullable: true symbol_type: type: string description: The symbol type. nullable: true asset_id_base: type: string description: The base asset identifier. nullable: true asset_id_quote: type: string description: The quote asset identifier. nullable: true asset_id_unit: type: string description: The unit asset identifier. nullable: true future_contract_unit: type: number description: The contract unit for futures. format: double nullable: true future_contract_unit_asset: type: string description: The asset used as the unit for futures contract. nullable: true future_delivery_time: type: string description: The future delivery time for futures contract. format: date-time nullable: true option_type_is_call: type: boolean description: Indicates whether the option type is a call. nullable: true option_strike_price: type: number description: The strike price for options. format: double nullable: true option_contract_unit: type: number description: The contract unit for options. format: double nullable: true option_exercise_style: type: string description: The exercise style for options. nullable: true option_expiration_time: type: string description: The expiration time for options. format: date-time nullable: true contract_delivery_time: type: string description: The delivery time for contracts. format: date-time nullable: true contract_unit: type: number description: The contract unit for contracts. format: double nullable: true contract_unit_asset: type: string description: The asset used as the unit for contracts. nullable: true contract_id: type: string description: The contract identifier. nullable: true contract_display_name: type: string description: The display name of the contract. nullable: true contract_display_description: type: string description: The display description of the contract. nullable: true data_start: type: string nullable: true readOnly: true data_end: type: string nullable: true readOnly: true data_quote_start: type: string description: The start date of quote data. format: date-time nullable: true data_quote_end: type: string description: The end date of quote data. format: date-time nullable: true data_orderbook_start: type: string description: The start date of order book data. format: date-time nullable: true data_orderbook_end: type: string description: The end date of order book data. format: date-time nullable: true data_trade_start: type: string description: The start date of trade data. format: date-time nullable: true data_trade_end: type: string description: The end date of trade data. format: date-time nullable: true index_id: type: string description: The index identifier. nullable: true index_display_name: type: string description: The display name of the index. nullable: true index_display_description: type: string description: The display description of the index. nullable: true volume_1hrs: type: number description: The volume in the last 1 hour. format: double nullable: true volume_1hrs_usd: type: number description: The volume in USD in the last 1 hour. format: double nullable: true volume_1day: type: number description: The volume in the last 1 day. format: double nullable: true volume_1day_usd: type: number description: The volume in USD in the last 1 day. format: double nullable: true volume_1mth: type: number description: The volume in the last 1 month. format: double nullable: true volume_1mth_usd: type: number description: The volume in USD in the last 1 month. format: double nullable: true price: type: number description: The price. format: double nullable: true symbol_id_exchange: type: string description: The symbol identifier in the exchange. nullable: true asset_id_base_exchange: type: string description: The base asset identifier in the exchange. nullable: true asset_id_quote_exchange: type: string description: The quote asset identifier in the exchange. nullable: true price_precision: type: number description: The price precision. format: double nullable: true size_precision: type: number description: The size precision. format: double nullable: true raw_kvp: type: object additionalProperties: type: string description: Not normalized raw kvp data. nullable: true additionalProperties: false description: Represents a symbol data model. v1.SymbolMapping: type: object properties: symbol_id: type: string description: The symbol ID. nullable: true symbol_id_exchange: type: string description: The exchange-specific symbol ID. nullable: true asset_id_base_exchange: type: string description: The exchange-specific base asset ID. nullable: true asset_id_quote_exchange: type: string description: The exchange-specific quote asset ID. nullable: true asset_id_base: type: string description: The base asset ID. nullable: true asset_id_quote: type: string description: The quote asset ID. nullable: true price_precision: type: number description: The price precision. format: double nullable: true size_precision: type: number description: The size precision. format: double nullable: true additionalProperties: false description: Represents symbol mapping information for exchange symbols. v1.TimeseriesItem: type: object properties: time_period_start: type: string description: The start time of the time period. format: date-time time_period_end: type: string description: The end time of the time period. format: date-time time_open: type: string description: The time when the price opened. format: date-time nullable: true time_close: type: string description: The time when the price closed. format: date-time nullable: true price_open: type: number description: The opening price. format: double nullable: true price_high: type: number description: The highest price during the time period. format: double nullable: true price_low: type: number description: The lowest price during the time period. format: double nullable: true price_close: type: number description: The closing price. format: double nullable: true volume_traded: type: number description: The total volume traded during the time period. format: double trades_count: type: integer description: The number of trades executed during the time period. format: int64 additionalProperties: false description: Represents a timeseries item with price and volume information. v1.TimeseriesPeriod: type: object properties: period_id: type: string description: The period ID. nullable: true length_seconds: type: integer description: The length of the period in seconds. format: int32 length_months: type: integer description: The length of the period in months. format: int32 unit_count: type: integer description: The unit count. format: int32 nullable: true unit_name: type: string description: The unit name. nullable: true display_name: type: string description: The display name of the timeseries period. nullable: true additionalProperties: false description: Represents a timeseries period used in exchange rate data. v1.Trade: type: object properties: symbol_id: type: string description: The symbol identifier. nullable: true time_exchange: type: string description: The time of trade reported by the exchange. format: date-time time_coinapi: type: string description: The time when the trade was received by CoinAPI. format: date-time uuid: type: string description: The unique identifier for the trade. format: uuid price: type: number description: The price of the transaction. format: double size: type: number description: The base asset amount traded in the transaction. format: double taker_side: type: string description: The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN). nullable: true id_trade: type: string description: The trade identifier. nullable: true id_order_maker: type: string description: The order maker identifier. nullable: true id_order_taker: type: string description: The order taker identifier. nullable: true additionalProperties: false description: Represents a trade executed on the exchange. securitySchemes: ApiKey: type: apiKey description: CoinApi API key needed to access the endpoints name: X-CoinAPI-Key in: header security: - ApiKey: [ ] tags: - name: Exchange Rates description: "\r\n\r\nExchange rate is defined as (VWAP-24H) last 24 hour (rolling window over time) Volume Weighted Average Price across multiple data sources listed on our platform. We are selecting and managing the data sources that are used in the calculation based on multiple factors to provide data of highest quality. \r\n\r\nAlgorithm is described below:\r\n\r\n 1. Exchange rates are produced from quotes, trades, and metadata datasets.\r\n 1. Symbols that are not data_type = \"SPOT\" are excluded from the calculation.\r\n 1. Symbols from the data sources that were marked by us as not legitimate are excluded from the calculation.\r\n 1. Quotes data where the spread is outside the range of ```<0$; 67%>``` are discarded. `spreadPrc = (ask - bid) / ((ask + bid) / 2)`\r\n 1. The midpoint from the quote data is used as a pricing reference and it's weighted by the passive cumulative volume resting on the best prices.\r\n 1. Volume from the trades is used to weight the midpoint prices in the VWAP24 algorithm.\r\n 1. Midpoint data that has not been updated in the last 5 minutes and 1 second is discarded.\r\n 1. The last 24-hour volume for each symbol is updated every 4 hours when approximately 20% of the data in the sliding window changes (also, the list of eligible markets is updated at the same time).\r\n 1. Everywhere in the algorithm below, we are using asset pairs only from exchanges that have the highest legitimacy rank, and the rest of the exchanges are discarded. As we establish the highest-ranking exchanges that have this data for each asset pair, we ensure that the highest quality data is used for each of them. The rank used for asset pairing is carried over to the following steps.\r\n 1. Every 1 second, we update VWAP24 data for every asset pair across all data sources.\r\n 1. For each asset pair, we also discard data that is outside the 3 sigma range if there are at least 3 exchanges for this asset pair.\r\n 1. From the VWAP24 data, we are creating a tree structure where node/vertex = asset and edge = rate.\r\n 1. By traversing the tree structure using the BFS algorithm and our secret sauce, we are able to establish the final exchange rates.\r\n " - name: Metadata description: - name: Order Book L3 description: "\n\nThis section describes calls related to order book data, also known as books or passive level 3 data." - name: Order Book description: "\n\nThis section describes calls related to order book data, also known as books or passive level 2 data.\n\n:::info\nWhen requesting current data for a specific symbol, output is not encapsulated into JSON array as only one item is returned.\n:::\n\n:::info\nGET `/v1/orderbooks/current` endpoint is charged one request per 100 data points returned after applying a filter defined by filter_symbol_id parameter. If filter symbols target more than one exchange, error is returned.\n:::\n\n:::info\nWhen requesting current order book data limited to a single level, then quotes are actually used. This information is important from the perspective that quotes data could be faster than order book data (behavior is dependent solely one the data source) and they can have the size equal to 0 when the size is unknown. Some data sources publish order books and separately quote data (without the sizes) at a higher frequency. In that case, we will merge the order book feed with quotes feed to make sure that our updates are as fast as possible. The quotes will have the size equal to 0 as the value is unknown and the customer can decide if these higher frequency updates without the sizes are valuable or if not then can discard them or ask for at least 2 order book levels (in case of a REST API call). For the data sources that publish order books only or order books and quotes with the sizes then this will not happen.\n:::" - name: Ohlcv description: "\n\n\nAPI calls described in this section are related to downloading OHLCV *(Open, High, Low, Close, Volume)* timeseries data.\nEach data point of this timeseries represents several indicators calculated from transactions activity inside a time range (period).\n\n:::info\nOHLCV data primary purpose is to present an overview of the market in human readable form. \nIt's often used to visualize market data on charts, websites, and various kinds of reports.\n:::\n\n:::tip\nCoinAPI expanded the standard OHLCV timeseries by including time of first and last trade and amount of trades executed inside period.\n:::\n " - name: Assets description: Controller for accessing asset information. - name: Indexes description: 'Indexes section of the API is in the Alpha release cycle. Use only for testing, evaluaton and feedback.' - name: Metrics description: "\r\nMetrics are quantitative measurements used to evaluate the performance and activity of cryptocurrency exchanges. These metrics include:\r\n\r\n1. Trading Volume: The total amount of cryptocurrency traded on an exchange within a specific time period, indicating liquidity and activity.\r\n1. Market Depth: The level of buy and sell orders at different price levels, providing insights into liquidity and potential price impact.\r\n1. Order Book: A record of outstanding buy and sell orders for a cryptocurrency, reflecting supply and demand dynamics.\r\n1. Spread: The difference between the highest bid and lowest ask prices, indicating liquidity and trading costs.\r\n1. Price Charts: Visual representations of cryptocurrency price movements over time, helping identify trends and inform trading decisions.\r\n1. Market Cap: The total value of a cryptocurrency calculated by its price multiplied by circulating supply, reflecting relative size and value.\r\n1. Trading Pairs: Combinations of cryptocurrencies available for trading, including volume, price, and spread for each pair.\r\n1. User Metrics: Data on active users, new registrations, user retention, and engagement, indicating platform popularity and growth.\r\n1. Trading Fees: Fees charged for executing trades, including fee structure, discounts, and revenue generated by the exchange.\r\n1. Security Metrics: Measures assessing the security of an exchange, such as past incidents, user fund protection, and security audits.\r\n\r\nThese metrics assist traders and investors in evaluating market activity, liquidity, and the reliability of crypto exchanges for informed decision-making." - name: OrderBooks3 description: Controller for managing order book L3 data. - name: OrderBooks description: Controller for managing order book data. - name: Quotes description: 'Controller for retrieving quotes data, also known as quotes or passive level 1 data.' - name: Symbols description: Controller for retrieving symbol information. - name: TimeSeries description: 'Controller for retrieving OHLCV (Open, High, Low, Close, Volume) timeseries data.' - name: Trades description: Controller for retrieving trade data related to executed transactions.