No project description provided
Project description
mango-explorer-v4
Python client library for interacting with Mango Markets V4.
Installation
mango-explorer-v4
is available as a Python package on PyPI and can be installed as:
pip install mango-explorer-v4
Example usage
Assuming that you have a SOL wallet already set up, visit https://app.mango.markets to create a Mango account and fund it so that you can place orders. You can find all available examples here.
import asyncio
from mango_explorer_v4.mango_client import MangoClient
from solana.keypair import Keypair
from base58 import b58decode
async def main():
mango_client = await MangoClient.connect()
# General data functions:
print(mango_client.symbols())
print(await mango_client.orderbook_l2('SOL/USDC'))
print(await mango_client.fills('SOL-PERP'))
# It is possible to livestream both orderbook & fills, look for incremental_*.py in the examples folder
# Fill in your Mango account public key e.g 9XJt2tvSZghsMAhWto1VuPBrwXsiimPtsTR8XwGgDxK2
mango_account = await mango_client.get_mango_account('PUBLIC_KEY')
print(await mango_client.balances(mango_account))
print(await mango_client.equity(mango_account))
# You can look up any Mango account using
# https://app.mango.markets/?address=9XJt2tvSZghsMAhWto1VuPBrwXsiimPtsTR8XwGgDxK2
# Fill in output from Phantom's "Export Private Key" e.g 2pvKRVh ... 1fL5qGq
keypair = Keypair.from_secret_key(b58decode('SECRET_KEY'))
# Place a limit order
print(await mango_client.place_order(mango_account, keypair, 'SOL/USDC', 'bid', 10, 0.1, 'limit'))
# Place an oracle pegged perp order: https://docs.mango.markets/mango-markets/oracle-peg-orders
print(
await mango_client.place_perp_pegged_order(
mango_account,
keypair,
'SOL-PERP',
'bid',
price_offset=-5, # Will always be $5 under oracle price
peg_limit=10, # If the oracle price moves $10 or more, the order will expire
quantity=1
)
)
# Cancel all orders
print(
await mango_client.cancel_all_orders(
mango_account,
keypair,
'SOL-PERP'
)
)
# There's a simple quoter, using atomic cancel-replace in examples/market_maker.py
asyncio.run(main())
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mango_explorer_v4-0.7.1.tar.gz
(74.9 kB
view hashes)
Built Distribution
Close
Hashes for mango_explorer_v4-0.7.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7e7860f89792c3e5c3a6eeb8cc9a038c00e582596294f0416f69ab1203091e19 |
|
MD5 | 3fff057e8e4fe124a41a013d652be4a9 |
|
BLAKE2b-256 | 29649ffb53163caed61c9224b31a0eb21aac68d323c68cb480373687c9eae0d6 |