Skip to content

Commit 4a57ff3

Browse files
committed
Auto-generate SDK for CoinAPI Market Data API REST Historical
1 parent c5b7ebc commit 4a57ff3

File tree

131 files changed

+1018
-922
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

131 files changed

+1018
-922
lines changed

coinapi/market-data-api-rest/sdk/ada/src/client/-clients.adb

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -292,7 +292,7 @@ package body .Clients is
292292
.Models.Deserialize (Reply, "", Result);
293293
end V_1Exchanges_Icons_Size_Get;
294294

295-
-- List of symbols for the exchange
295+
-- List of active symbols for the exchange
296296
procedure V_1Symbols_Exchange_Id_Get
297297
(Client : in out Client_Type;
298298
Exchange_Id : in Swagger.UString;
@@ -313,7 +313,9 @@ package body .Clients is
313313
.Models.Deserialize (Reply, "", Result);
314314
end V_1Symbols_Exchange_Id_Get;
315315

316-
-- Get symbol history for an exchange with pagination.
316+
-- List all historical symbols for an exchange.
317+
-- This endpoint provides access to symbols that are no longer actively traded or listed on a given exchange.
318+
-- The data is provided with pagination support.
317319
procedure V_1Symbols_Exchange_Id_History_Get
318320
(Client : in out Client_Type;
319321
Exchange_Id : in Swagger.UString;
@@ -334,8 +336,8 @@ package body .Clients is
334336
.Models.Deserialize (Reply, "", Result);
335337
end V_1Symbols_Exchange_Id_History_Get;
336338

337-
-- List all symbols
338-
-- Retrieves all symbols with optional filtering.
339+
-- List all active symbols
340+
-- Retrieves all currently active (listed) symbols, with optional filtering.
339341
--
340342
-- :::info
341343
-- "price_precision" and "size_precision" are data precisions and are not always the same precisions used for trading eg. for the "BINANCE" exchanges.
@@ -436,7 +438,7 @@ package body .Clients is
436438
.Models.Deserialize (Reply, "", Result);
437439
end V_1Symbols_Get;
438440

439-
-- List symbol mapping for the exchange
441+
-- List active symbol mapping for the exchange
440442
procedure V_1Symbols_Map_Exchange_Id_Get
441443
(Client : in out Client_Type;
442444
Exchange_Id : in Swagger.UString;

coinapi/market-data-api-rest/sdk/ada/src/client/-clients.ads

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -141,24 +141,26 @@ package .Clients is
141141
Size : in Integer;
142142
Result : out .Models.V1Icon_Type_Vectors.Vector);
143143

144-
-- List of symbols for the exchange
144+
-- List of active symbols for the exchange
145145
procedure V_1Symbols_Exchange_Id_Get
146146
(Client : in out Client_Type;
147147
Exchange_Id : in Swagger.UString;
148148
Filter_Symbol_Id : in Swagger.Nullable_UString;
149149
Filter_Asset_Id : in Swagger.Nullable_UString;
150150
Result : out .Models.V1Symbol_Type_Vectors.Vector);
151151

152-
-- Get symbol history for an exchange with pagination.
152+
-- List all historical symbols for an exchange.
153+
-- This endpoint provides access to symbols that are no longer actively traded or listed on a given exchange.
154+
-- The data is provided with pagination support.
153155
procedure V_1Symbols_Exchange_Id_History_Get
154156
(Client : in out Client_Type;
155157
Exchange_Id : in Swagger.UString;
156158
Page : in Swagger.Nullable_Integer;
157159
Limit : in Swagger.Nullable_Integer;
158160
Result : out .Models.V1Symbol_Type_Vectors.Vector);
159161

160-
-- List all symbols
161-
-- Retrieves all symbols with optional filtering.
162+
-- List all active symbols
163+
-- Retrieves all currently active (listed) symbols, with optional filtering.
162164
--
163165
-- :::info
164166
-- "price_precision" and "size_precision" are data precisions and are not always the same precisions used for trading eg. for the "BINANCE" exchanges.
@@ -246,7 +248,7 @@ package .Clients is
246248
Filter_Asset_Id : in Swagger.Nullable_UString;
247249
Result : out .Models.V1Symbol_Type_Vectors.Vector);
248250

249-
-- List symbol mapping for the exchange
251+
-- List active symbol mapping for the exchange
250252
procedure V_1Symbols_Map_Exchange_Id_Get
251253
(Client : in out Client_Type;
252254
Exchange_Id : in Swagger.UString;

coinapi/market-data-api-rest/sdk/android/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -97,10 +97,10 @@ Class | Method | HTTP request | Description
9797
*MetadataApi* | [**v1ExchangesExchangeIdGet**](docs/MetadataApi.md#v1ExchangesExchangeIdGet) | **GET** /v1/exchanges/{exchange_id} | List all exchanges by exchange_id
9898
*MetadataApi* | [**v1ExchangesGet**](docs/MetadataApi.md#v1ExchangesGet) | **GET** /v1/exchanges | List all exchanges
9999
*MetadataApi* | [**v1ExchangesIconsSizeGet**](docs/MetadataApi.md#v1ExchangesIconsSizeGet) | **GET** /v1/exchanges/icons/{size} | List of icons for the exchanges
100-
*MetadataApi* | [**v1SymbolsExchangeIdGet**](docs/MetadataApi.md#v1SymbolsExchangeIdGet) | **GET** /v1/symbols/{exchange_id} | List of symbols for the exchange
101-
*MetadataApi* | [**v1SymbolsExchangeIdHistoryGet**](docs/MetadataApi.md#v1SymbolsExchangeIdHistoryGet) | **GET** /v1/symbols/{exchange_id}/history | Get symbol history for an exchange with pagination.
102-
*MetadataApi* | [**v1SymbolsGet**](docs/MetadataApi.md#v1SymbolsGet) | **GET** /v1/symbols | List all symbols
103-
*MetadataApi* | [**v1SymbolsMapExchangeIdGet**](docs/MetadataApi.md#v1SymbolsMapExchangeIdGet) | **GET** /v1/symbols/map/{exchange_id} | List symbol mapping for the exchange
100+
*MetadataApi* | [**v1SymbolsExchangeIdGet**](docs/MetadataApi.md#v1SymbolsExchangeIdGet) | **GET** /v1/symbols/{exchange_id} | List of active symbols for the exchange
101+
*MetadataApi* | [**v1SymbolsExchangeIdHistoryGet**](docs/MetadataApi.md#v1SymbolsExchangeIdHistoryGet) | **GET** /v1/symbols/{exchange_id}/history | List all historical symbols for an exchange.
102+
*MetadataApi* | [**v1SymbolsGet**](docs/MetadataApi.md#v1SymbolsGet) | **GET** /v1/symbols | List all active symbols
103+
*MetadataApi* | [**v1SymbolsMapExchangeIdGet**](docs/MetadataApi.md#v1SymbolsMapExchangeIdGet) | **GET** /v1/symbols/map/{exchange_id} | List active symbol mapping for the exchange
104104
*MetricsV1Api* | [**v1MetricsAssetCurrentGet**](docs/MetricsV1Api.md#v1MetricsAssetCurrentGet) | **GET** /v1/metrics/asset/current | Current metrics for given asset
105105
*MetricsV1Api* | [**v1MetricsAssetHistoryGet**](docs/MetricsV1Api.md#v1MetricsAssetHistoryGet) | **GET** /v1/metrics/asset/history | Historical metrics for asset
106106
*MetricsV1Api* | [**v1MetricsAssetListingGet**](docs/MetricsV1Api.md#v1MetricsAssetListingGet) | **GET** /v1/metrics/asset/listing | Listing of all supported metrics for asset

coinapi/market-data-api-rest/sdk/android/docs/MetadataApi.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ Method | HTTP request | Description
1212
[**v1ExchangesExchangeIdGet**](MetadataApi.md#v1ExchangesExchangeIdGet) | **GET** /v1/exchanges/{exchange_id} | List all exchanges by exchange_id
1313
[**v1ExchangesGet**](MetadataApi.md#v1ExchangesGet) | **GET** /v1/exchanges | List all exchanges
1414
[**v1ExchangesIconsSizeGet**](MetadataApi.md#v1ExchangesIconsSizeGet) | **GET** /v1/exchanges/icons/{size} | List of icons for the exchanges
15-
[**v1SymbolsExchangeIdGet**](MetadataApi.md#v1SymbolsExchangeIdGet) | **GET** /v1/symbols/{exchange_id} | List of symbols for the exchange
16-
[**v1SymbolsExchangeIdHistoryGet**](MetadataApi.md#v1SymbolsExchangeIdHistoryGet) | **GET** /v1/symbols/{exchange_id}/history | Get symbol history for an exchange with pagination.
17-
[**v1SymbolsGet**](MetadataApi.md#v1SymbolsGet) | **GET** /v1/symbols | List all symbols
18-
[**v1SymbolsMapExchangeIdGet**](MetadataApi.md#v1SymbolsMapExchangeIdGet) | **GET** /v1/symbols/map/{exchange_id} | List symbol mapping for the exchange
15+
[**v1SymbolsExchangeIdGet**](MetadataApi.md#v1SymbolsExchangeIdGet) | **GET** /v1/symbols/{exchange_id} | List of active symbols for the exchange
16+
[**v1SymbolsExchangeIdHistoryGet**](MetadataApi.md#v1SymbolsExchangeIdHistoryGet) | **GET** /v1/symbols/{exchange_id}/history | List all historical symbols for an exchange.
17+
[**v1SymbolsGet**](MetadataApi.md#v1SymbolsGet) | **GET** /v1/symbols | List all active symbols
18+
[**v1SymbolsMapExchangeIdGet**](MetadataApi.md#v1SymbolsMapExchangeIdGet) | **GET** /v1/symbols/map/{exchange_id} | List active symbol mapping for the exchange
1919

2020

2121

@@ -383,7 +383,7 @@ Name | Type | Description | Notes
383383

384384
> List<V1Symbol> v1SymbolsExchangeIdGet(exchangeId, filterSymbolId, filterAssetId)
385385
386-
List of symbols for the exchange
386+
List of active symbols for the exchange
387387

388388
### Example
389389

@@ -431,7 +431,9 @@ Name | Type | Description | Notes
431431

432432
> List<V1Symbol> v1SymbolsExchangeIdHistoryGet(exchangeId, page, limit)
433433
434-
Get symbol history for an exchange with pagination.
434+
List all historical symbols for an exchange.
435+
436+
This endpoint provides access to symbols that are no longer actively traded or listed on a given exchange. The data is provided with pagination support.
435437

436438
### Example
437439

@@ -441,8 +443,8 @@ Get symbol history for an exchange with pagination.
441443

442444
MetadataApi apiInstance = new MetadataApi();
443445
String exchangeId = null; // String | The ID of the exchange.
444-
Integer page = 1; // Integer | The page number.
445-
Integer limit = 100; // Integer | Number of records to return.
446+
Integer page = 1; // Integer | The page number for pagination (starts from 1).
447+
Integer limit = 100; // Integer | Number of records to return per page.
446448
try {
447449
List<V1Symbol> result = apiInstance.v1SymbolsExchangeIdHistoryGet(exchangeId, page, limit);
448450
System.out.println(result);
@@ -458,8 +460,8 @@ try {
458460
Name | Type | Description | Notes
459461
------------- | ------------- | ------------- | -------------
460462
**exchangeId** | **String**| The ID of the exchange. | [default to null]
461-
**page** | **Integer**| The page number. | [optional] [default to 1]
462-
**limit** | **Integer**| Number of records to return. | [optional] [default to 100]
463+
**page** | **Integer**| The page number for pagination (starts from 1). | [optional] [default to 1]
464+
**limit** | **Integer**| Number of records to return per page. | [optional] [default to 100]
463465

464466
### Return type
465467

@@ -479,9 +481,9 @@ Name | Type | Description | Notes
479481

480482
> List&lt;V1Symbol&gt; v1SymbolsGet(filterSymbolId, filterExchangeId, filterAssetId)
481483
482-
List all symbols
484+
List all active symbols
483485

484-
Retrieves all symbols with optional filtering. :::info \&quot;price_precision\&quot; and \&quot;size_precision\&quot; are data precisions and are not always the same precisions used for trading eg. for the \&quot;BINANCE\&quot; exchanges. ::: :::info You should not assume that the market data will be always within the resolution provided by the \&quot;price_precision\&quot; and \&quot;size_precision\&quot;. 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. ::: ### Symbol identifier Our symbol identifier is created using a pattern that depends on symbol type. Type | &#x60;symbol_id&#x60; pattern --------- | --------- SPOT | &#x60;{exchange_id}_SPOT_{asset_id_base}_{asset_id_quote}&#x60; FUTURES | &#x60;{exchange_id}_FTS_{asset_id_base}_{asset_id_quote}_{YYMMDD of future_delivery_time}&#x60; OPTION | &#x60;{exchange_id}_OPT_{asset_id_base}_{asset_id_quote}_{YYMMDD of option_expiration_time}_{option_strike_price}_{option_type_is_call as C/P}&#x60; PERPETUAL | &#x60;{exchange_id}_PERP_{asset_id_base}_{asset_id_quote}&#x60; INDEX | &#x60;{exchange_id}_IDX_{index_id}&#x60; CREDIT | &#x60;{exchange_id}_CRE_{asset_id_base}&#x60; CONTACT | &#x60;{exchange_id}_COT_{contract_id}&#x60; :::info In the unlikely event when the \&quot;symbol_id\&quot; for more than one market is the same. We will append the additional term (prefixed with the \&quot;_\&quot;) at the end of the duplicated identifiers to differentiate them. :::info ### Symbol types list (enumeration of &#x60;symbol_type&#x60; output variable) Type | Name | Description -------- | - | ----------- SPOT | FX Spot | Agreement to exchange one asset for another one *(e.g. Buy BTC for USD)* FUTURES | Futures contract | FX Spot derivative contract where traders agree to trade fx spot at predetermined future time OPTION | 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 PERPETUAL | Perpetual contract | FX Spot derivative contract where traders agree to trade fx spot continously without predetermined future delivery time INDEX | Index | Statistical composite that measures changes in the economy or markets. CREDIT | Credit/Funding | Margin funding contract. Order book displays lending offers and borrow bids. Price represents the daily rate. CONTRACT | Contract | Represents other types of financial instruments *(e.g. spreads, interest rate swap)* ### Additional output variables for &#x60;symbol_type &#x3D; INDEX&#x60; Variable | Description --------- | ----------- index_id | Index identifier index_display_name | Human readable name of the index *(optional)* index_display_description | Description of the index *(optional)* ### Additional output variables for &#x60;symbol_type &#x3D; FUTURES&#x60; Variable | Description --------- | ----------- future_delivery_time | Predetermined time of futures contract delivery date in ISO 8601 future_contract_unit | Contact size *(eg. 10 BTC if &#x60;future_contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;future_contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* future_contract_unit_asset | Identifier of the asset used to denominate the contract unit ### Additional output variables for &#x60;symbol_type &#x3D; PERPETUAL&#x60; Variable | Description --------- | ----------- future_contract_unit | Contact size *(eg. 10 BTC if &#x60;future_contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;future_contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* future_contract_unit_asset | Identifier of the asset used to denominate the contract unit ### Additional output variables for &#x60;symbol_type &#x3D; OPTION&#x60; Variable | Description --------- | ----------- option_type_is_call | Boolean value representing option type. &#x60;true&#x60; for Call options, &#x60;false&#x60; for Put options option_strike_price | Price at which option contract can be exercised option_contract_unit | Base asset amount of underlying spot which single option represents option_exercise_style | Option exercise style. Can be &#x60;EUROPEAN&#x60; or &#x60;AMERICAN&#x60; option_expiration_time | Option contract expiration time in ISO 8601 ### Additional output variables for &#x60;symbol_type &#x3D; CONTRACT&#x60; Variable | Description --------- | ----------- contract_delivery_time | Predetermined time of contract delivery date in ISO 8601 contract_unit | Contact size *(eg. 10 BTC if &#x60;contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* contract_unit_asset | Identifier of the asset used to denominate the contract unit contract_id | Identifier of contract by the exchange
486+
Retrieves all currently active (listed) symbols, with optional filtering. :::info \&quot;price_precision\&quot; and \&quot;size_precision\&quot; are data precisions and are not always the same precisions used for trading eg. for the \&quot;BINANCE\&quot; exchanges. ::: :::info You should not assume that the market data will be always within the resolution provided by the \&quot;price_precision\&quot; and \&quot;size_precision\&quot;. 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. ::: ### Symbol identifier Our symbol identifier is created using a pattern that depends on symbol type. Type | &#x60;symbol_id&#x60; pattern --------- | --------- SPOT | &#x60;{exchange_id}_SPOT_{asset_id_base}_{asset_id_quote}&#x60; FUTURES | &#x60;{exchange_id}_FTS_{asset_id_base}_{asset_id_quote}_{YYMMDD of future_delivery_time}&#x60; OPTION | &#x60;{exchange_id}_OPT_{asset_id_base}_{asset_id_quote}_{YYMMDD of option_expiration_time}_{option_strike_price}_{option_type_is_call as C/P}&#x60; PERPETUAL | &#x60;{exchange_id}_PERP_{asset_id_base}_{asset_id_quote}&#x60; INDEX | &#x60;{exchange_id}_IDX_{index_id}&#x60; CREDIT | &#x60;{exchange_id}_CRE_{asset_id_base}&#x60; CONTACT | &#x60;{exchange_id}_COT_{contract_id}&#x60; :::info In the unlikely event when the \&quot;symbol_id\&quot; for more than one market is the same. We will append the additional term (prefixed with the \&quot;_\&quot;) at the end of the duplicated identifiers to differentiate them. :::info ### Symbol types list (enumeration of &#x60;symbol_type&#x60; output variable) Type | Name | Description -------- | - | ----------- SPOT | FX Spot | Agreement to exchange one asset for another one *(e.g. Buy BTC for USD)* FUTURES | Futures contract | FX Spot derivative contract where traders agree to trade fx spot at predetermined future time OPTION | 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 PERPETUAL | Perpetual contract | FX Spot derivative contract where traders agree to trade fx spot continously without predetermined future delivery time INDEX | Index | Statistical composite that measures changes in the economy or markets. CREDIT | Credit/Funding | Margin funding contract. Order book displays lending offers and borrow bids. Price represents the daily rate. CONTRACT | Contract | Represents other types of financial instruments *(e.g. spreads, interest rate swap)* ### Additional output variables for &#x60;symbol_type &#x3D; INDEX&#x60; Variable | Description --------- | ----------- index_id | Index identifier index_display_name | Human readable name of the index *(optional)* index_display_description | Description of the index *(optional)* ### Additional output variables for &#x60;symbol_type &#x3D; FUTURES&#x60; Variable | Description --------- | ----------- future_delivery_time | Predetermined time of futures contract delivery date in ISO 8601 future_contract_unit | Contact size *(eg. 10 BTC if &#x60;future_contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;future_contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* future_contract_unit_asset | Identifier of the asset used to denominate the contract unit ### Additional output variables for &#x60;symbol_type &#x3D; PERPETUAL&#x60; Variable | Description --------- | ----------- future_contract_unit | Contact size *(eg. 10 BTC if &#x60;future_contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;future_contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* future_contract_unit_asset | Identifier of the asset used to denominate the contract unit ### Additional output variables for &#x60;symbol_type &#x3D; OPTION&#x60; Variable | Description --------- | ----------- option_type_is_call | Boolean value representing option type. &#x60;true&#x60; for Call options, &#x60;false&#x60; for Put options option_strike_price | Price at which option contract can be exercised option_contract_unit | Base asset amount of underlying spot which single option represents option_exercise_style | Option exercise style. Can be &#x60;EUROPEAN&#x60; or &#x60;AMERICAN&#x60; option_expiration_time | Option contract expiration time in ISO 8601 ### Additional output variables for &#x60;symbol_type &#x3D; CONTRACT&#x60; Variable | Description --------- | ----------- contract_delivery_time | Predetermined time of contract delivery date in ISO 8601 contract_unit | Contact size *(eg. 10 BTC if &#x60;contract_unit&#x60; &#x3D; &#x60;10&#x60; and &#x60;contract_unit_asset&#x60; &#x3D; &#x60;BTC&#x60;)* contract_unit_asset | Identifier of the asset used to denominate the contract unit contract_id | Identifier of contract by the exchange
485487

486488
### Example
487489

@@ -529,7 +531,7 @@ Name | Type | Description | Notes
529531

530532
> List&lt;V1SymbolMapping&gt; v1SymbolsMapExchangeIdGet(exchangeId)
531533
532-
List symbol mapping for the exchange
534+
List active symbol mapping for the exchange
533535

534536
### Example
535537

0 commit comments

Comments
 (0)