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.6.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.6-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fennel_invest_api-1.0.6.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.6.tar.gz
Algorithm Hash digest
SHA256 0a95c3c773d0f110b3d9d7e230ce74fd53442c2aa3fc74450211093b6185ebd4
MD5 75e76f770607eca208010dc5a7734ae7
BLAKE2b-256 09dd5a8dc903c1a096b6d98af73a6ab4a260290cb3509247894805fa4291dd9f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fennel_invest_api-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 142423f635afbce7691250b6034e2627e5512e7fd0cef4373f5e1cdb503383f8
MD5 0bf9442da2512bfd1a1521260a6dee87
BLAKE2b-256 b46d7ac8d953880e469606507644bb4d2e26b3a2b38a05118933374908e8641d

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