#### Repository
https://github.com/nnmix/py-primedice-bot

#### What Will I Learn?
- You will learn to automate a PrimeDice Bot given your own rules
- You will learn to use Python: 'requests' and 'json' libraries
- You will learn to use your Prime Dice Account Token
- You will learn to fetch your account details: Coins / Balance
- You will learn to execute automated 'Rule Based' dice rolls

#### Requirements
#####   Personal Prerequisite
- Existing [primedice](https://primedice.com/) account
#####   System prerequisites:
- [Jupyter](https://jupyter.org/) notebook for python 
#####   Knowledge prerequisites:
- Basic understanding of python programming
- Basic understanding of Http Methods, APIs

#### Difficulty
- Intermediate

#### Description
In this tutorial you will get the ability to automate your own flavored Dice Roller Bot on your prime dice account

#### Content

Before getting to the python scripting section you will need the primedice account token to be used in the http method calls.
#####   1. Primedice Account Token:
   a. Sign in to your existing primedice account
   b. Go to MORE > SETTINGS > TOKENS > REVEAL > Copy
       ![e5pgwm318g.gif](https://img.esteem.ws/e5pgwm318g.gif)

#####   2. Jupyter / Python

* You can access jupyter [Online](https://jupyter.org/try) or [Intall](https://jupyter.org/install.html) it locally on your pc. 

* When done open a new python file:
![c0p4o64haw.png](https://img.esteem.ws/c0p4o64haw.png)

* When the file is open, if you are on the online version, you can delete existing sample cell by clicking the cell border (blue highlight) than double pressing 'D'
![vh7xz5m2hw.png](https://img.esteem.ws/vh7xz5m2hw.png)
Until you have an empty cell to write your script within:
![lwrckeg0nt.png](https://img.esteem.ws/lwrckeg0nt.png)

* Now your jupyter editor is up you can start typing your code and run it by pressing **ctrl+enter**

#####   3. Dice Roller/ Python
Let us start talking about the prime dice roller implementation

* Primedice API URL is <code>https://api.primedice.com/graphql</code>
* HTTP Request Header should contain the account token
<code>**'x-access-token' : 'your prime dice account bet token'**</code>
* Post Request Data: 
e.g. to get the list of coins balances (operation name is Balances):
````
[{
	"operationName": "Balances",
	"variables": {
		"available": true
	},
	"query": "query Balances($available: Boolean = false, $vault: Boolean = false) {\\n  user {\\n    id\\n    balances {\\n      available @include(if: $available) {\\n        currency\\n        amount\\n        __typename\\n      }\\n      vault @include(if: $vault) {\\n        currency\\n        amount\\n        __typename\\n      }\\n      __typename\\n    }\\n    __typename\\n  }\\n}\\n"
}]
````

* Executing The API call in python 
e.g.
````
  # requests lib
  import requests
  
  # api url
  api = 'http://me.api.com'
  
  # http headers
  headers =  {
  	'content-type': 'application/json',
  	'x-access-token': '<token-access-keys>'
  }
  
  # http request post raw data
  data = '{ "param" : "value" }'
  
  # invoke api call and get the response
  response = requests.post('api url', headers= httpHeader, data= postData)
````

Now on the prepared python functions to use are:

* <code>def headers()</code>
within this function replace <token-access-keys> with your own keys
  
*  <code>def balance(coin) </code>
  call it to get the balance in Satoshi Units
  -- supported coins in primedice are btc, ltc, bch, doge, eth.
  -- e.g. <code> satoshis = balance('btc') </code>
  
* <code>def roll(amount, condition, target, coin)</code>
  call it to run a dice roll
  -- pass the amount in satoshis unit
  -- your bet target condition 'above' or 'below'
  -- your desired dice target number range ] 0, 100 [
  -- returns success (true or false), result (dice number result), payout (0 on loss, on win it is the total payout including the bet amount) 
  -- e.g. bet amount of 100 satoshis for a roll target above 70:
  <code>success, result, payout = roll(100, 'above', 70, 'btc')</code>

#### The End! 
Finally most of the steps are covered, it is your time to configure your own rules / algorithm that may give you your optimal winning payouts.
  
**Feel free** to share and list your own automation python bot script on the project github project page with your fresh good results for others to try ! 😃
  
#### Related
- [My steemit announcement: primedice-python](https://steemit.com/primedice/@aro.steem/primedice-python)

#### Proof of Work Done
https://github.com/nnmix/py-primedice-bot/blob/master/main.py