Skip to main content

Unofficial Fennel.com Invest API written in Python Requests

Project description

Unofficial Fennel Invest API

This is an unofficial API for Fennel.com. It is a simple Python wrapper around the Fennel.com GraphQL API. It is not affiliated with Fennel.com in any way.

Fennel does everything via GraphQL, so yes, this is very slow.

This is still a work in progress, so it will have bugs and missing features. Please feel free to contribute!

Installation

pip install fennel-invest-api

Usage: Logging In

from fennel_invest_api import Fennel

fennel = Fennel()
fennel.login(
    email="your-email@email.com",
    wait_for_2fa=True # When logging in for the first time, you need to wait for email 2FA
)

If you'd like to handle the 2FA yourself programmatically instead of waiting for input(), you can call it with wait_for_2fa=False, catch the 2FA exception, then call it again with the 2FA code:

fennel.login(
    email="your-email@email.com",
    wait_for_2fa=False
    code="123456" # Should be six-digit integer from email
)

Usage: Get Stock Holdings

account_ids = fennel.get_account_ids()
for account_id in account_ids:
    print(account_id)
    positions = fennel.get_stock_holdings(account_id)
    for position in positions:
        print(position)

Usage: Get Portfolio

# For all accounts
full_portfolio = fennel.get_full_accounts()
print(full_portfolio)
# For a single account ID
portfolio = fennel.get_portfolio_summary(account_id)
print(portfolio)

Usage: Placing Orders

order = fennel.place_order(
    account_id=account_id,
    symbol="AAPL",
    quantity=1,
    side="buy", # Must be "buy" or "sell"
    price="market" # Only market orders are supported for now
)
print(order)

Contributing

Found or fixed a bug? Have a feature request? Feel free to open an issue or pull request!

Enjoying the project? Feel free to Sponsor me on GitHub or Ko-fi!

Sponsor ko-fi

DISCLAIMER

DISCLAIMER: I am not a financial advisor and not affiliated with Fennel.com. Use this tool at your own risk. I am not responsible for any losses or damages you may incur by using this project. This tool is provided as-is with no warranty.

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

fennel_invest_api-1.0.7.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fennel_invest_api-1.0.7-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file fennel_invest_api-1.0.7.tar.gz.

File metadata

  • Download URL: fennel_invest_api-1.0.7.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for fennel_invest_api-1.0.7.tar.gz
Algorithm Hash digest
SHA256 9d2a1a3adfbc2b4055166d688359f995b07897e228177d8c3bf8d24073b6bdf9
MD5 6f866cf8cf734b658c8dcdbaf4264fd9
BLAKE2b-256 188c3f64e4bad9c909d00d4fe7a81c974ce025a06cfb205d1136e3b203ac7cb8

See more details on using hashes here.

File details

Details for the file fennel_invest_api-1.0.7-py3-none-any.whl.

File metadata

File hashes

Hashes for fennel_invest_api-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 c085ee047dad4c955c1f420910a3238e2c33374df2f1118aacfc15d771818cbe
MD5 e89781794790e2be29bd8ceb7e3748df
BLAKE2b-256 aa315f245c6e4cb7d6730bd8121a53df109786afbc34343f903cf6c348a2e82c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page