Package: gryphon
Gryphonis an open source software platform for building and running algorithmic trading strategies in cryptocurrency markets. It was built by Tinker, one of the earliest cryptocurrency trading companies, and has traded billions in volume to date.DocumentationBuildWhat's includedGryphon is both a software library that can be integrated into other projects, and an application suite for running trading strategies and operating a trading business. How you use Gryphon depends on your goals. Some highlights are:Library highlights:20+ Exchange pair integrations ~ Gryphon defines a single abstract interface for exchanges, with semantic function calls likegemini_btc_usd.get_orderbook(), and integrates 20+ trading pairs on 6 exchanges under that interface. Exchange integrations abstract away all the annoying individual quirks of different exchanges, like rate limits, rounding behaviour, nonces, and undocumented features. This allows the user to write strategies against a single, reliable interface, and focus completely on designing trading behaviour.Strategy Building Blocks ~ Common operations, like checking for arbitrage opportunities, are already implemented and tested in for different strategy classes are provided in gryphon's strategy building block libraries. Many common strategy types can be implemented in as few as 3-5 function calls.Application suite highlights:Strategy Engine~ the primary executable of gryphon loads strategy files and executes them, providing to the strategy developer redundant exchange connections, trade history persistence, monitoring, instrumentation, and lots of other features that make gryphon the easiest way to build and run strategies.Gryphon Data Service~ a standalone service for ingesting market data and other events at high frequencies. Built using rabbitmq, GDS can be used in advanced installations of gryphon to massively speed up tick speeds or to build up datasets for use in machine learning.Dashboards~ a webserver that connects to your trading database to help you visualize the activity of your trading strategies and understand the health of your trading business.InstallationThe gryphon library can be installed directly through pip oncea few prerequisitesare installed.$pipinstallgryphonTo use gryphon for trading, there are extra install steps to set up the execution engine. See this page for details:Installing Gryphon.If you are going to extend or modify gryphon, we recommend downloading the codebase and installing through pip with the-eflag.UsageCredentials and environment variablesWhen using Gryphon, sensitive credentials like API keys never leave your machine. Instead, gryphon applications read credentials from a.envfile stored in the directory they are launched from..envfiles are simple lists of key-value pairs.The .env entries for an exchange like Coinbase look something like this.COINBASE_BTC_USD_API_KEY=[YOUR KEY]
COINBASE_BTC_USD_API_SECRET=[YOUR SECRET]
COINBASE_BTC_USD_API_PASSPHRASE=[YOUR PASSPHRASE]Depending on the features you wish to use and the exchanges you wish to trade on, you'll need to have certain entries in your .env file. You can read theEnvironment Variable Referenceto find out which you will need.Run a built-in strategyOnce you have followed the strategy engine install stepshere. You can use the gryphon execution environment to run strategies. Gryphon ships with a few simple built-in strategies. These aren't designed for serious trading but can be useful for testing and learning the framework.One such strategy is called 'Simple Marketmaking'. It can be run as follows:$gryphon-execstrategysimple_mm--builtin[--execute]If you don't include the--executeflag, the strategy runs in test-mode, and won't place any orders on exchanges. This is a feature of the execution environment, not the strategy, so this flag works with every strategy you run or build on gryphon. Only use the--executeflag when you're ready to run or test a strategy with real money.Write and run your first strategyGryphon has a lot of building-block libraries that make common tasks quite simple. For example, we can use the gryphon arbitrage library to write a simple arbitrage strategy in only three major function calls.fromgryphon.execution.strategies.baseimportStrategyimportgryphon.lib.arbitrageasarbclassGeminiCoinbaseArbitrage(Strategy):deftick(self):cross=arb.get_crosses(self.harness.gemini_btc_usd.get_orderbook(),self.harness.coinbase_btc_usd.get_orderbook(),)executable_volume=arb.get_executable_volume(cross,self.coinbase_btc_usd.get_balance(),self.gemini_btc_usd.get_balance(),)ifcrossandexecutable_volume:self.harness.gemini_btc_usd.market_order(cross.volume,'BID')self.harness.coinbase_btc_usd.market_order(cross.volume,'ASK')Copy this code into a python file named 'arbitrage.py' in the same directory as your .env file, and you can run it in test mode withgryphon-exe strategy arbitrage.Notice how much functionality is in play here:gryphon-execsets up the environment that strategies run in and orchestrates the tick-by-tick operation, the exchange integrations for Coinbase and Gemini abstract away all the implementation details of working with those APIs into simple semantic function calls, and the arbitrage library simplifies some complex calculations into just two function calls.Getting HelpIf you want help with an issue, there are a few ways to ask:Join thegryphon slackto ask a question to the developersReporta bugSearch or read inthe docsAsk a question on stackoverflow with the tag‘gryphonframework’TheGryphon Websitecan also be used as an alternate alternate jumping-off point for users new to Gryphon.Contribution guidelinesWe useGitHub issuesfor
tracking requests and bugs.See theContributing to Gryphonfor pull request checklists and ideas about how you can contribute.