Mettalex SDK

​Website​
Access the world’s first DEX focused on token based commodities trading using this SDK. Accessible 24/7 with tight trading spreads, low margin requirements and unique hedge instruments that ensure you don’t get liquidated prior to settlement dates.
Pre requisites
This package is designed for python 3. While using pip, pip should be configured for python3.
Installation
Mettalex for python can be installed directly from github using the following command:
pip install -e git+https://github.com/fetchai/[email protected]#egg=mettalex-sdk
Usage
Importing
from mettalex import apiSDK
Connecting to a network
Mettalex provides 3 networks for connecting to Metallex exchange, namely, 'bsc-testnet', 'kovan' and 'bsc-mainnet'. You will need to connect to one of these to be able to access Mettalex. You will require your key while connecting to any network. Infura project ID and Infura API Secret are required only when connecting to kovan.
1
apiSDK.connect([network], [userkey], [infuraSecret ? Optional], [infuraProjectId ? Optional])
Copied!
You can pass credentials as a json file (e.g. trade_sdk_creds.json).
1
{
2
  "kovan": {
3
    "infura": {
4
      "project_id": "...",
5
      "secret": "..."
6
    },
7
    "user": {
8
      "address": "0x...",
9
      "key": "14a..."
10
    }
11
  },
12
  "bsc-mainnet": {
13
    "user": {
14
      "address": "", 
15
      "key": ""
16
    }
17
  },
18
  "bsc-testnet": {
19
    "user": {
20
      "address": "", 
21
      "key": ""
22
    }
23
  }
24
}
Copied!
then connect with:
1
apiSDK.connect('kovan', filename=os.path.expanduser('~/trader_sdk_creds.json'))
Copied!
Getting Commodities
apiSDK.getCommodities(network_id=optional, coin_id='default') This function returns a pandas DataFrame with details of all the commodities in the connected network.
Use this function typically while getting the list of all commodities available on a network.
The optional network_id argument allows the user to examine commodities present on different networks. If unspecified the connected network is used.
The optional coin_id argument specifies the underlying collateral.
Note: on bsc-mainnet BUSD is "real money": please exercise caution and understand the risks involved.
1
commodities = apiSDK.getCommodities(coin='BUSD')
2
commodities.loc[:, ['category', 'commodity_symbol', 'id']]
3
Out[27]: 
4
  category commodity_symbol   id
5
0   Spread          BTCTSLA  338
6
1   Crypto              BTC  336
Copied!
Creating a commodity instance to trade
commodity = apiSDK.Commodity([commodity symbol or commodity ID]) 
A Commodity instance can be created using the commodity symbol. This initializes a class instance of the particular commodity. An instance of a commodity needs to be created to be able to execute trades and getting expected prices. We can get commodity symbols available by calling getCommodities() and looking at the commodity_symbol column. If there are multiple commodities with the same symbol, e.g. settled and active commodities, then it is better to use the commodity_id to access a market.
Expected trading prices
Two functions ask and bid can be used to retrieve trading prices. These functions can be called on commodity instances created, taking two arguments of token and amount to be traded.
1
commodity.ask(token, amount) - amount of coin required to buy token amount
2
​
3
commodity.bid(token, amount) - amount of coin received from sell token amount
Copied!
Token is provided as a string and can be either "long" or "short".
Amount is provided by default as a float using token amounts taking token decimals into account.
If the unitless parameter is set to True the amount values are in int
Trading
Trading in a commodity is quite simple. We have to call trade function on a commodity instance providing in token, out token and the amount we want to trade. In token and Out Token can take "long","short", or "coin" as values.
Amount is provided as a float or int as for bid and ask methods. commodity.trade([In Token], [Out Token], [amount In], [minimum amount Out])
Example
1.Setup and imports in ipython console;
1
%load_ext autoreload
2
%autoreload 2
3
import pandas as pd
4
import os
5
from mettalex import apiSDK
6
pd.set_option('display.width', 1000)
7
pd.set_option('display.max_columns', None)
Copied!
  2. Connect to blockchain and list commodities;
1
apiSDK.connect('kovan', filename=os.path.expanduser('~/trader_sdk_creds.json'))
2
commodities = apiSDK.getCommodities('kovan', output='dataframe')
3
Connected to network ID 42
4
commodities.groupby('category')['id'].count()
5
Out[6]: 
6
category
7
Agricultural    1
8
Crypto          3
9
Ferrous         5
10
Forex           1
11
Indices         1
12
Industrial      5
13
Other           1
14
Spread          5
15
Test QA         2
16
Name: id, dtype: int64
17
commodities.loc[commodities.category == 'Spread', ['id', 'commodity_symbol', 'commodity_name']]
18
Out[7]: 
19
     id commodity_symbol            commodity_name
20
5   303         LINKBAND          Link Band Spread
21
12  286           BTCETH   Bitcoin Ethereum Spread
22
17  299          BTCTSLA      Bitcoin Tesla Spread
23
18  307        SDEFISCEX         sDEFI sCEX spread
24
19  211          SRSCSPR  Steel Rebar Scrap Spread
Copied!
  3. Connect to specific market and trade.
1
commodity = apiSDK.Commodity('BTCTSLA')
2
connection established sucessfully
3
commodity
4
Out[11]: 
5
BTCTSLA: Bitcoin Tesla Spread
6
Mettalex Vault: 0x37eeDc79D22980Bd60652751072ac252C300959a
7
  Prices - Floor: 50.0 Spot: 79.2 Cap: 100.0
8
  Coin : 0xe551960F80e5f855bB75d36016Ca92c981314b3E  568937.305831
9
  Short: 0x6aE1854843e5AD57e103E68C6E1A455530336750  11374.34611
10
  Long : 0x924D2bf052538F4DF696450214A827D0575127b6  11374.34611
11
Mettalex Liquidity Pool: 0x071826Eb1FD5bCC1a2219CC8F9ae99a1A6eC9AFE
12
  Coin : 0xe551960F80e5f855bB75d36016Ca92c981314b3E  {'y_vault': 330.505877, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 594117.125268}
13
  Short: 0x6aE1854843e5AD57e103E68C6E1A455530336750  {'y_vault': 0.0, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 7776.0527}
14
  Long : 0x924D2bf052538F4DF696450214A827D0575127b6  {'y_vault': 0.0, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 9659.39263}
15
Short spot price: 23.953781  Long spot price : 27.070647
16
commodity.getUserBalance()
17
Out[12]: (35752.557059, 0.0, 0.0)
18
commodity.ask('long', 100)
19
Out[13]: 2727.088497
20
commodity.ask('long', 10)
21
Out[14]: 270.887126
22
commodity.bid('long', 10)
23
Out[15]: 259.778631
24
commodity.bid('long', 100)
25
Out[16]: 2580.950892
26
commodity.trade('coin', 'long', 3000)
27
Swapped 3000.000 coin to 109.926 long
28
Out[17]: (3000.0, 109.92576)
29
commodity.getUserBalance()
30
Out[18]: (32752.557059, 0.0, 109.92576)
Copied!
Example Showing Mint and Redeem Operations
1
commodity = apiSDK.commodity_from_symbol('BTCTSLA')
2
connection established sucessfully
3
commodity
4
Out[7]: 
5
BTCTSLA: Bitcoin Tesla Spread
6
Mettalex Vault: 0xdd458CDBbEAEE04C010C721E50fD4C4BEA02507c
7
  Prices - Floor: 50.0 Spot: 83.0 Cap: 100.0
8
  Coin : 0x6e71C530bAdEB04b95C64a8ca61fe0b946A94525  475250.192
9
  Short: 0xe17d1431D2f13044e660fa25Fea2009316F8Bf2c  9504.96
10
  Long : 0xbf97902FfEB9520DbB0014DF36961B59cfB1875a  9504.96
11
Mettalex Liquidity Pool: 0x5629f27EBF0921605c99269f92F537F1eDCb860a
12
  Coin : 0x6e71C530bAdEB04b95C64a8ca61fe0b946A94525  {'y_vault': 279605.588519, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 746369.04679}
13
  Short: 0xe17d1431D2f13044e660fa25Fea2009316F8Bf2c  {'y_vault': 0.0, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 6038.29334}
14
  Long : 0xbf97902FfEB9520DbB0014DF36961B59cfB1875a  {'y_vault': 0.0, 'vault_controller': 0.0, 'strategy': 0.0, 'balancer': 4064.57865}
15
Short spot price: 13.137957  Long spot price : 37.889255
16
commodity.getUserBalance()  # See our coin, short, long account balance
17
Out[8]: (99979707.333966, 0.0, 0.0)
18
paid_trade, received_trade = commodity.trade('coin', 'long', 100)
19
Swapped 100.000 coin to 2.639 long
20
commodity.getUserBalance()  # See our coin, short, long account balance
21
Out[10]: (99979607.333966, 0.0, 2.63863)
22
paid_mint, received_mint = commodity.mint(200)  # Mint $200 worth of long and short tokens
23
Paid 200.000 coin to mint 3.984 long and short
24
commodity.getUserBalance()  # See our coin, short, long account balance
25
Out[12]: (99979407.333966, 3.98406, 6.62269)
26
paid_trade_2, received_trade_2 = commodity.trade('coin', 'short', 100)  # Buy $100 worth of short tokens
27
Swapped 100.000 coin to 7.611 short
28
commodity.getUserBalance()  # See our coin, short, long account balance
29
Out[14]: (99979307.333966, 11.59466, 6.62269)
30
paid_redeem, received_redeem = commodity.redeem(5)  # Redeem 5 long and short token pairs for coin
31
Redeemed 5.000 long and short for 250.000 coin
32
commodity.getUserBalance()  # See our coin, short, long account balance
33
Out[16]: (99979557.333966, 6.59466, 1.62269)
34
# Close position either by swapping long to coin, short to coin
35
# or redeeming max number of pairs and then trading the remaining position tokens for coin
Copied!
Mettalex DEX: LP MTLX Rewards Walkthrough
Fetch.ai’s Stop-Loss agent for DeFi Liquidity Providers
Last modified 4mo ago
Copy link
Contents
Example Showing Mint and Redeem Operations