AlphaMeta

PyPI - Version Python Version Platform PyPI - Downloads Downloads WeChat

AlphaMeta is a REST API gateway for IBKR (Interactive Brokers) — live trading and real-time market data for stocks, options, futures, and crypto via a standardized REST API. Commands run as HTTP endpoints behind a FastAPI gateway, callable via curl or any HTTP client.

Also includes SEC EDGAR research commands — filing listing, 13F investors, insider trades, XBRL financial statements and segment data.

Quick start

pip install alphameta

Get a free API key at alphameta.app, then create ~/.alphameta/.env:

# API Key (Required) — get one free at https://alphameta.app
ALPHAMETA_API_KEY=am-xxx

# IBKR Account ID (Required for trading)
ALPHAMETA_IBKR_ACCOUNT_ID=U1234567

# IBKR Gateway connection
ALPHAMETA_IBKR_HOST=127.0.0.1
ALPHAMETA_IBKR_PORT=4001
ALPHAMETA_IBKR_CLIENT_ID=0

# Timezone (default: US/Eastern)
# ALPHAMETA_TIMEZONE=Asia/Shanghai

Start the server:

alphameta --ibkr

The API serves at http://127.0.0.1:18080 by default:

# Live quotes
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "quote AAPL"}'

# SEC research (no IBKR needed)
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "filings AAPL 10-K"}'

Trading also requires a running IBKR Gateway or TWS.

AI Agent Skills

alphameta-skills provides agent skills for AI coding assistants (Claude Code, Codex, Cursor, etc.) — use AlphaMeta in natural language for market data, trading, portfolio analysis, and more.

npx skills add intelliscale/alphameta-skills -g

Features

Commands by category

Category Commands
Live Market Quotes quote, add, remove, kline, depth, chain, range, info, align, prequalify, oadd, filings, investors, insider-trades, financial-report, financial-statement, sec, calc-index, capital-flow, consensus, operating
Order Management buy, cancel, modify, evict, fast, scale, straddle
Portfolio positions, balance, orders, executions, report
Technical Indicators dex, gex, dge, maxpain
Predicate Management ifthen, iflist, ifrm, ifclear, ifgroup, auto
Quote Management qadd, qremove, qlist, qsave, qrestore, qdelete, qclean, qsnapshot, qloadsnapshot, colorset, colorsload
Schedule Management sched-add, sched-list, sched-cancel
Task Management tasklist, taskcancel
Utilities cash, math, alert, say, expand, simulate, paper, reporter, daydumper, details, advice, alias, clear, meta, qualify, reconnect, calendar, set

Examples

Bulk symbol expansion:

# Add/remove multiple option strikes at once
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "add SPY240412{P,C}005{1,2,3}0000"}'

# Remove by row id
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "remove :{31..37}"}'

Multi-symbol orders:

# Buy ~$15k of each symbol
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "expand buy {META,MSFT,NVDA,AMD,AAPL} $15_000 MID"}'

Flexible order pricing:

# By quantity or dollar amount, with bracket orders
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "buy AAPL 100 AF @ 233.33 ± 10"}'

Conditional triggers:

# Execute command when price condition is met
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "if AAPL last > 300: buy AAPL 100 AF"}'

Account calculator:

# Calculate shares buyable on margin, combine with growth projections
curl -X POST "http://127.0.0.1:18080/api/v1/execute" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "(/ :BP3 AAPL)"}'

License

© 2026 Intelliscale Technologies, Inc.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.6.7)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kelvingao from gravatar.com kelvingao

Credits

Author: GAO KE

License

Apache-2.0

Requires

Python >=3.12

Report project as malware

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

alphameta-2.6.5-cp314-cp314-win_amd64.whl (7.5 MB view details)

Uploaded CPython 3.14Windows x86-64

alphameta-2.6.5-cp314-cp314-win32.whl (6.5 MB view details)

Uploaded CPython 3.14Windows x86

alphameta-2.6.5-cp314-cp314-musllinux_1_2_x86_64.whl (11.5 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

alphameta-2.6.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.4 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

alphameta-2.6.5-cp314-cp314-macosx_11_0_arm64.whl (10.2 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

alphameta-2.6.5-cp313-cp313-win_amd64.whl (7.3 MB view details)

Uploaded CPython 3.13Windows x86-64

alphameta-2.6.5-cp313-cp313-win32.whl (6.3 MB view details)

Uploaded CPython 3.13Windows x86

alphameta-2.6.5-cp313-cp313-musllinux_1_2_x86_64.whl (11.6 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

alphameta-2.6.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.4 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

alphameta-2.6.5-cp313-cp313-macosx_11_0_arm64.whl (10.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

alphameta-2.6.5-cp312-cp312-win_amd64.whl (7.4 MB view details)

Uploaded CPython 3.12Windows x86-64

alphameta-2.6.5-cp312-cp312-win32.whl (6.4 MB view details)

Uploaded CPython 3.12Windows x86

alphameta-2.6.5-cp312-cp312-musllinux_1_2_x86_64.whl (11.6 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

alphameta-2.6.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.5 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

alphameta-2.6.5-cp312-cp312-macosx_11_0_arm64.whl (10.2 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

File details

Details for the file alphameta-2.6.5-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 7.5 MB
  • Tags: CPython 3.14, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 6f47892ac980d397f47aef3530f5e98d123bd2309ccfe4ff10fcec8a3822158d
MD5 23d205483aa5b9b8efb747d3727d49ad
BLAKE2b-256 6b86c34ca9f0305788fcd86aba46e27f875c44cbc96552116284fa709af8df32

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp314-cp314-win32.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp314-cp314-win32.whl
  • Upload date:
  • Size: 6.5 MB
  • Tags: CPython 3.14, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 6fe004ad31b3dc262aaed245b766a332516e485cfdd0057f9286b4db7e4ecd33
MD5 7e74d851c81210dd71dd8aaf6e0585f2
BLAKE2b-256 8b557bfe855d02e424dfd3e1ff0a0c992000ef7a709d0d14e38da03483c06e47

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp314-cp314-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 4f1c50d05be57da380bdc3f6a1473a2f6b5e4130128b676fdfd64649c8a555ff
MD5 15792ed2358ab760c2fb9cfad9b01f55
BLAKE2b-256 b50e3a851de2db329a9e0c2dd96b5170cfb46c50d0e21aa7928f56e2b3728510

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1b38ba4b135ab8d99320bd72d2fd4fcb612eac7f983bf9fc601efc6c9d415180
MD5 e4e468fc9974c474130df03d55a8f757
BLAKE2b-256 b2bdd25757589fe3be295873c9e4f144cf6225603e20a1a9d455d1447e38a752

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 13bb3d0b199fdc0886c86ba5a2108189cca374f00af4305e628432514ba7eb62
MD5 81be87614c4966ed4a259eaeeed1f954
BLAKE2b-256 e850a4817d9daa3d8de596161e2dd4b0ed451ca8bfbf5782688cc7553ebdc469

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 7.3 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 3ae530a4c114efb18efd44b4a2c56b1951f59466577ad0ca2534f9cd46db932d
MD5 4d34e402a906c429bd5270752630b38f
BLAKE2b-256 fcf4fab03a31f61bf9826b516aa15a5e908cb51f22a879baa321e35e92f9d7d6

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp313-cp313-win32.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp313-cp313-win32.whl
  • Upload date:
  • Size: 6.3 MB
  • Tags: CPython 3.13, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 93192d5d684f1a70f484ce36da19c46ce4bfcb23c8f2acfd22ae76ee028fe262
MD5 58f7782bc5d210e818a31030b7988ef9
BLAKE2b-256 fd03e21b29c63ac8d42f3c309ae43f83c44ca3e52ff2bbca50bc37607513c9e9

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 5ac8e32c43b5392064da4f2fcf547750d2cbb3d36db8cf490ad184a8420ede5c
MD5 d8bc5381c83c40ba8aaa1f89eb1821c0
BLAKE2b-256 d3208f9e80fe7a841849255f88f430264fe2bbde9307949c5e67ec6832632259

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a0c7b9e6b756d7043eaa19e402b5302b5fecfa81026bc4062db116b743b4136e
MD5 2ad4a1765c3d9b40a2b0f4a765769faf
BLAKE2b-256 481c97b48daf0ccbb9bdb53def0869335eca4dedd418d09c7e2aa092084e0a92

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 39d4c757e633bbcc1047d339e134bbb69fc3fdcaba677395525478a2dba1ba15
MD5 50f3510af8326e47cab58ce754933f9c
BLAKE2b-256 d758c9aaa9f8c45490af5b63558a92943099947be99912fe1ea2d2e2fb55c093

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 7.4 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 fddfeaaa5de3654323b3436b65dc16693435e6585b7cc6663343292ed243e30b
MD5 d8d8f7e0ec47625ae8a76cf7f3582ac9
BLAKE2b-256 c7224c81149d5c6c607e7056b51da5bf809bec7f24644ea3c5d355dcc4a3ea53

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp312-cp312-win32.whl.

File metadata

  • Download URL: alphameta-2.6.5-cp312-cp312-win32.whl
  • Upload date:
  • Size: 6.4 MB
  • Tags: CPython 3.12, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for alphameta-2.6.5-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 1f78dfef1126ea37fa62410f0e4e8f119340e77cc6d45238e688865924be57ec
MD5 3c79c4d1553ce5473c38b80ce94aee31
BLAKE2b-256 fa5f6f30bf3de9b83750d81005981aae2da5c83d2d8e019d6ff3e878334e6913

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 19edfad9eba348085293c318ac8a85619be5e4e1583dc78ae2523d782ff42e80
MD5 a556af42f7c2e1390ca109788e285ddc
BLAKE2b-256 c3954777f6d84306e4a0ebf4dc56cd8deee8a20725e114b46620f685959011b8

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1ee32dbc64158761b661a78a89d3370a13896d85823e26d429cfe2bef599e788
MD5 23aa5a8d8efa07acf9f57c9a95882cb5
BLAKE2b-256 e377a658a465baee9e66a8907065fad9f50a8cc1f56d299983e5fa9c9c28b54c

See more details on using hashes here.

File details

Details for the file alphameta-2.6.5-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for alphameta-2.6.5-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 9ca84c276b3866e47e75775faad4f10cd4a4a87426ac77213248b81afe337dac
MD5 bcf6b4f35b4d2c072af7aede189a2c65
BLAKE2b-256 a46320793bf3dbd2a6caa1dc9575dc211ab186728b78063a9a42f3b068282648

See more details on using hashes here.

Release history Release notifications | RSS feed

2.6.7

15 files

2.6.6

15 files

This release

2.6.5 This release

15 files

2.6.4

15 files

2.6.3

15 files

2.6.2

15 files

2.6.1

15 files

2.6.0

15 files

2.5.2

15 files

2.5.1

15 files

2.4.4

10 files

2.4.3

6 files

2.4.2

6 files

Supported by

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