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
Market Data quote, add, remove, kline, depth, chain, range, info, align, prequalify, oadd
Fundamentals financial-report, financial-statement, sec, filings, investors, insider-trades, calc-index, consensus, earnings, fundamental, news, operating
Technicals dex, gex, dge, maxpain, capital-flow, straddle, advice, reporter
Trading buy, cancel, modify, evict, fast, scale
Portfolio positions, balance, orders, executions, report, cash
Automation ifthen, iflist, ifrm, ifclear, ifgroup, auto, sched-add, sched-list, sched-cancel, tasklist, taskcancel
Watchlist qadd, qremove, qlist, qsave, qrestore, qdelete, qclean, qsnapshot, qloadsnapshot, colorset, colorsload, alert
Utilities math, say, expand, simulate, paper, daydumper, details, 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:
Latest release

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.7-cp314-cp314-win_amd64.whl (7.5 MB view details)

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14Windows x86

alphameta-2.6.7-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.7-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.7-cp314-cp314-macosx_11_0_arm64.whl (10.2 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13Windows x86

alphameta-2.6.7-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.7-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.7-cp313-cp313-macosx_11_0_arm64.whl (10.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12Windows x86

alphameta-2.6.7-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.7-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.7-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.7-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 e6effb6bd4931483c15ee053228127831fb260df6483ceaf27252d84ebb58656
MD5 5f4f99ff92a40a4a7e9ff8af893e86a2
BLAKE2b-256 7f5b6182dc8f2d7c98d0c2336f92cfbe92ed9680c32b7c76664b4c3d95acdece

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 96547b1369b9532bae06c07528bbf946be70bd150c5f50d0dd128fff167d3ecc
MD5 7d6951b04a29a0591301be961e7f9357
BLAKE2b-256 3e724a0242e7fd696ec3498eb6b01026063374009228d41ddc1e6036eb0eed10

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 b039a3e7d89dd1d70d8cc87002b27b68091e9abc563b640d56a69934ba973035
MD5 b1bbd46b52e66afcf22aa73ee66fad23
BLAKE2b-256 97db1f81c27d516e8d0b3f3745418d8cdb418717f26b092c604e0203f89606f4

See more details on using hashes here.

File details

Details for the file alphameta-2.6.7-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.7-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6e91bf3c1c857e51597b1a25d513d2af6a789f41a1f897207142ef9c902b9c3f
MD5 ac7b587fddf4967ef4c2f848cc8b417d
BLAKE2b-256 157677b7dd5aba8f166dc3b77f55938af58e5bc5738dfab0fbcf0f601cd2904e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2842b53274fe20bf9eebe344142498c5df67e8301b6c67497b32057de34ae4c4
MD5 c3e05ff2d37b38e191710c6053aa7589
BLAKE2b-256 d6a1d5d566d6fc80db2d7b5d1fcbf1866e7fcc4771a2123786dd787fd0c13fc1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 12c4acba9a3ef8e2d5d050eded6df2127a6915a1c1877068de301060c785cd53
MD5 6170a2e5440fb76510bee0fe60fa3c08
BLAKE2b-256 dc6469cb0583edbeecf8ea0916de654764d8e9fa85aea685325ee34e8ed99e05

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 f7098f1d2e7d9da0b0c7f15b68982200ea4d6b019e6ce780b342ab9f5f823000
MD5 7c2297e1593a3e6a127635c23f861f98
BLAKE2b-256 5b6749a85fe46750a4751bcb66af7a17be80de23efd12433615b054787456f90

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 152f61c84ed54b91329996cf0dfb7c592ca27c52675f9de9322dfdf7130e1511
MD5 77995aeb051b7d0a0c9acf2e5b656254
BLAKE2b-256 996da2e2736c7e2e68366b3561cbb7a755c75e44bd60fb63aac3166a032e7e46

See more details on using hashes here.

File details

Details for the file alphameta-2.6.7-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.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 50b190ae597638720ad690596b7e1a02966d5dedaf245e7b520fb3aae8bde593
MD5 1fd38b915a3c69ed5fb9688eef8c1e3f
BLAKE2b-256 57e6a8ee18bc6561d78aba8e532e8399e202c4c9c7e5a16876896354418c242f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c79d6f87f275c488ba15e5372e8394b710ebef3cbe8873c53859616cf9b2160f
MD5 be5d518799e54240c1bfb8117cb13930
BLAKE2b-256 0e5eab7f4dfe5f22a9b8c198c82e42665b11e9006ec020b41799b5b5fc2c401a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 d4c7b180441fedda8b2b25ced3f646b2c415bdc102a7b50bee87bbc0e44bc020
MD5 cd1ca971f9a269403e1e828e96e0bdb9
BLAKE2b-256 f71a8eb290a98c840c59353004209fde96d5b54085645b29bba99f5928ae7f5b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.7-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.7-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 e7c28dd6a15a2a4fad76399b211d0954b93d357546f288ce742397d49444e040
MD5 ed0a04ce8c1c0db405f40fcd904c7975
BLAKE2b-256 cd8a2f19fc9d30b532fcfe9026aa9cc69bb4de3a1aab1c444d25900cf917121b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 02d31b3402c4da8bad1e368c6c1c6b32ab2b7457bd7dabfa7fe3cfc37ec08380
MD5 3d0beac35b782f3c41742179ea73f82b
BLAKE2b-256 e184d61cdbcb6ce8551202a9af2a885330306c0eed1d11c5e263974c6331918e

See more details on using hashes here.

File details

Details for the file alphameta-2.6.7-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.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8db88d6e0d04409f79e05d857bf0b1858d274e5c0c5ff00786497d7ccb7779f2
MD5 67f3444783cb49e04b7f80f140d87eed
BLAKE2b-256 0c2b586ea2cb661ad38aa19d3fd3e8567339ede1c0e52886e9309b70ddb45237

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.7-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a66d3cde44ea484d37c519adc6d1c4f206db065bee79a85963b153be6b770c3d
MD5 16dd962b5983e1accc70bd8b980f6d97
BLAKE2b-256 a3499036b6b8da6135f4a65bab4d7558fef7e9d2a380a0e3cefb8261bc85d63a

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.6.7 This release

15 files

2.6.6

15 files

2.6.5

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