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.9.tar.gz (6.5 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.9-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fennel_invest_api-1.0.9.tar.gz
  • Upload date:
  • Size: 6.5 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.9.tar.gz
Algorithm Hash digest
SHA256 273268f4a405be9e6cbc7a4c6f09452fcd2f2fb45c560bcb03de7b4a0bcc78d2
MD5 ad7a43802fbec9591ae9b0b97d7dd33d
BLAKE2b-256 0c33132871931e50d361a68d991b8348a7ee4814e33235a42a2f5edbff5c4975

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fennel_invest_api-1.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 02845135cc3e8536decd6f72427f673a1b50ebe3ac644ed98b9104ea788eaab4
MD5 16e65cc730d3ff7f8bb991dca1791007
BLAKE2b-256 f0fed31ff744cfb075d5acda23412867de091dddaa38cf6cb9d416cff0e25b88

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