Skip to main content

Python exchange engine

Project description

Python native Exchange engine

WebsitePyPIPyPI - LicenseGitHub issues


Why Beige?

Because it's not particularly attractive, there's probably a better color out there, but it kinda works. I was surprised that there is no package existing with the name beige yet!

A simple, slow, exchange library

Beige is a pretty simple library that provides the full functionality of a matching engine, with features for tracking account balances and ongoing quote.


Import the right bits, and spin up the engine

from beige import Engine, Order, Market, Limit, Side

# Create the engine
eng = Engine()

Account balances can be initialized at the start of the market session

# Start a person off with some given account balance
eng.accounts.init('person-a', {'$':100.01, 'TSLA':1})

# Person is missing 1 dollar, and owns 10 'what?'
eng.accounts.init('person-b', {'$':-1, 'what?':10})

Then orders can be submitted in a fairly intuitive way:

# Limit buy order for 'what?' security, 1
# Store the ID, and we can query its status later
oid = eng.submit(
    instrument = 'what?',
    type_ = Limit(10),
    side = Side.Sell,
    quantity = 5,
    entity = 'person-b',

# Submit a market order that

Once the ID for an order has been retrieved, we can see the full information on the order at any time:

o = eng.status(oid)
# type(o) == dict
# o.keys() == ['sym','price','side','qty','acct','id','submitted','filled','averagepx','filledtime','status']

A full chronological transaction dataset is available

df = eng.txs
# df.columns = ['qty','px','time','sym']

At any point, a quote can be requested. Note that None will be returned for any value that isn't available, for example, last will be empty if no transactions have taken place yet.

bid, ask, last, bidsize, asksize, lastsize = eng.quote('TSLA')


  • Speed. The software hasn't been fully optimized and many of the data structures could really benefit from a bit of love and care.
  • Integer-only quantities
  • All account entities and securities are case insensitive, and will be displayed in all caps
  • the "$" security encodes cash, and is the base unit for all security transactions. Sorry ex-USA users!


  • Correctness => python3
  • Speed => python3 speed
  • Profiler => python3 profile

I'm averaging about 0.15 ms per order execution. This works in the sequential market I'm working on, but this may be orders of magnitude slower than needed in your use case. Feel free to improve the speed, but please pull request back to me.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

beige-0.1.2.tar.gz (4.5 kB view hashes)

Uploaded source

Built Distribution

beige-0.1.2-py2.py3-none-any.whl (3.7 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page