Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ralphilius/cryptogas

This Google Apps Script library provide functions to retrieve values from cryptocurrency marketplace in order to build a portfolio.
https://github.com/ralphilius/cryptogas

crypto cryptocurrency cryptocurrency-marketplace google-apps-script google-sheets portfolio

Last synced: 2 days ago
JSON representation

This Google Apps Script library provide functions to retrieve values from cryptocurrency marketplace in order to build a portfolio.

Host: GitHub
URL: https://github.com/ralphilius/cryptogas
Owner: ralphilius
License: apache-2.0
Created: 2017-12-28T15:34:59.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2023-12-15T20:15:28.000Z (11 months ago)
Last Synced: 2024-04-20T19:37:29.707Z (7 months ago)
Topics: crypto, cryptocurrency, cryptocurrency-marketplace, google-apps-script, google-sheets, portfolio
Language: JavaScript
Size: 18.6 KB
Stars: 4
Watchers: 2
Forks: 5
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        


CryptoGAS



This Google Apps Script library provide functions to retrieve values from cryptocurrency marketplace in order to build a portfolio.

# Installation :zap:

1. Create or open desired Google Sheets

2. Open Tools >> Script Edit 

3. Create `jsSHA.gs` and `CryptoGAS.gs` files with content from this repo

# Supported Sites

Currently, CryptoGAS has API integration with below trading platforms:

- Bittrex

- HitBTC

- Binance (In Development)

# Usage 

## 1. Bittrex

Open a sheet then type following function with all required parameters 

`=Bittrex(apiMethod,apiKey,apiSecret, query, parseOptions)`

|Parameter|Required|Description|

|---------|:------:|-----------|

|apiMethod|:red_circle:|See below for all supported methods|

|apiKey   |:red_circle:|API Key obtained in the Settings|

|apiSecret|:red_circle:|Secret passphrase to sign request|

|query    |:white_circle:|A comma-separated list of fields to import, decided by the path of the header. Use `rawHeaders` option below to get the path info|

|parseOptions|:white_circle:|A comma-separated list of these options: `noInherit`, `noTruncate`, `rawHeaders`, `noHeaders`, `noParseNumbers`, `debugLocation`|

**Example:** `=Bittrex('account/getbalances','myApiKey','mySecretKey')`

### apiMethod

|Method|Status|Description|

|------|:----:|-----------|

|public/getmarkets|:heavy_check_mark:|Used to get the open and available trading markets at Bittrex along with other meta data.|

|public/getcurrencies|:heavy_check_mark:|Used to get all supported currencies at Bittrex along with other meta data.|

|public/getticker|:x:|Used to get the current tick values for a market.|

|public/getmarketsummaries|:heavy_check_mark:|Used to get the last 24 hour summary of all active exchanges|

|public/getmarketsummary|:x:|Used to get the last 24 hour summary of all active exchanges for a given market|

|public/getorderbook|:x:|Used to get retrieve the orderbook for a given market|

|public/getmarkethistory|:x:|Used to retrieve the latest trades that have occured for a specific market.|

|market/getopenorders|:x:|Get all orders that you currently have opened. A specific market can be requested (in development)|

|account/getbalances|:heavy_check_mark:|Used to retrieve all balances from your account|

|account/getbalance|:x:|Used to retrieve the balance from your account for a specific currency.|

|account/getdepositaddress|:x:|Used to retrieve or generate an address for a specific currency. If one does not exist, the call will fail and return ADDRESS_GENERATING until one is available.|

|account/getorder|:x:|Used to retrieve a single order by uuid.|

|account/getorderhistory|:heavy_check_mark:|Used to retrieve your order history.|

|account/getwithdrawalhistory|:heavy_check_mark:|Used to retrieve your withdrawal history.|

|account/getdeposithistory|:heavy_check_mark:|Used to retrieve your deposit history.|

Methods with :x: required additional parameters which are not supported yet.

API Reference: https://bittrex.com/Home/Api

### parseOptions

|Option|Description|

|------|-----------|

|noInherit|Don't inherit values from parent elements|

|noTruncate|Don't truncate values|

|rawHeaders|Don't prettify headers|

|noHeaders|Don't include headers, only the data|

|noParseNumbers|Don't parse number from string, leave it as it is|

|debugLocation|Prepend each value with the row & column it belongs in|

## 2. HitBTC

Open a sheet then type following function with all required parameters 

`=HitBTC(apiMethod,apiKey,apiSecret, query, parseOptions)`

|Parameter|Required|Description|

|---------|:------:|-----------|

|apiMethod|:red_circle:|See below for all supported methods|

|apiKey   |:red_circle:|API Key obtained in the Settings|

|apiSecret|:red_circle:|Secret passphrase to sign request|

|query    |:white_circle:|A comma-separated list of fields to import, decided by the path of the header. Use `rawHeaders` option below to get the path info|

|parseOptions|:white_circle:|A comma-separated list of these options: `noInherit`, `noTruncate`, `rawHeaders`, `noHeaders`, `noParseNumbers`, `debugLocation`|

**Example:** `=HitBTC('account/balance','myApiKey','mySecretKey')`

### apiMethod

|Method|Status|Description|

|------|:----:|-----------|

|public/currency|:heavy_check_mark:|Return the actual list of available currencies, tokens, ICO etc.|

|public/currency/{currency}|:heavy_check_mark:|Return the information of a specific currency.|

|public/symbol|:heavy_check_mark:|Return the actual list of currency symbols (currency pairs) traded on HitBTC exchange.|

|public/symbol/{symbol}|:heavy_check_mark:|Return information of a specific symbol|

|public/ticker|:heavy_check_mark:|Return ticker information|

|public/ticker/{symbol}|:heavy_check_mark:|Return ticker information of a specific symbol|

|public/orderbook/{symbol}|:exclamation:|Return an order book which is an electronic list of buy and sell orders for a specific symbol, organized by price level.|

|public/candles/{symbol}|:exclamation:|Return a candles used for OHLC a specific symbol.|

|trading/balance|:heavy_check_mark:|Get trading balance all all currencies|

|order|:heavy_check_mark:|Return array of active orders.|

|order/{clientOrderId}|:heavy_check_mark:|Return information of a specific order|

|trading/fee/{symbol}|:heavy_check_mark:|Get personal trading commission rate.|

|history/order|:exclamation:|Return all order history. All orders older then 24 hours without trades are deleted.|

|history/trades|:exclamation:|Return all trades history.|

|history/order/{orderId}/trades|:heavy_check_mark:|Return all trades history for an order|

|account/balance|:heavy_check_mark:|Get all account balances|

|account/transactions|:exclamation:|Get all transactions history|

|account/transactions/{id}|:exclamation:|Get transaction by transaction ID|

Methods with :exclamation: only support default parameters. They will be functional when the script support additional parameters in the function. Check API Reference for default values: https://api.hitbtc.com

## 3. Bitsane

_In development_

# Roadmap

 - Support API Method parameters

 - Coinbase API

 - GDAX API

 - Bitfinex API

# Donation

 - BTC: 16hDsVgy6VFW2aW8w9z2pogbq5XThToswF

 - ETH: 0x212799fbd9CD3e273E0CB6761b1708B284477e5E

 - LTC: LQtecz6SAbRzJXEfDpNLz8AzkhWKY4qQyv

 - BCH: 13mT5ubjZUKTviGXDSVHxRkrrxDFzzUFd4

# Credits

Thanks to below projects, developing CryptoGAS can be done as fast as possible.

 - [bradjasper/ImportJSON](https://github.com/bradjasper/ImportJSON)

 - [Caligatio/jsSHA](https://github.com/Caligatio/jsSHA/)

# License

Apache 2.0 License