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

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14Windows x86

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

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13Windows x86

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12Windows x86

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 27a65b863956c960a02e6c2f45d47f76838fbce529455d7e063f96fa18f8f92d
MD5 8724012692128b5640737879664d0276
BLAKE2b-256 38e69102de6360fa8047b2810d3ed6a3b75691d8a070f3b7754394eb2f9de0a6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 407751b55b130cbedbd486fa5d689eb01aa454ca48a717c7245e2b0490c379d0
MD5 b0eb133e225cc556ed9105cc64f7e025
BLAKE2b-256 2467ebba75343ffcfd5e8e04be1ad01cde4f3f94651dab27e3bb2a16c0316d06

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 ab547aa071ef1b86d535572bd360f31919720b71dec121c2f4c453bc80d9de9a
MD5 aa73910bc09c23f0c13ccfbbe97f63d4
BLAKE2b-256 14e4bdd23f21427a80bcd8569582367601b46d73d7b3599d5cf71e2fb314882d

See more details on using hashes here.

File details

Details for the file alphameta-2.6.4-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.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6e07304f66db143b6b5a1edc3a75d94deeeb743155e23076facc0dfe4d51f672
MD5 62185fede255277318adfb0024274717
BLAKE2b-256 1820df1ef56369ecf2e9794107484daf233174046e453cee94cc120ec7476fb8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5be6fa3ab88adaa3f3fffd5314ad29e1279e3f43f1eb9d5615fcde489f4121b7
MD5 9893a982b544f9ffbbaf805eb1c0cb28
BLAKE2b-256 7ec81f7b27d6580cbbf340823faadc78e65a3ddf8cf53beacdab5ab052d5e40b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 b4b92d558c76f854ddec5a0afdfeb0170fdb0a79e6f7c627a55f47ce2e7d0e65
MD5 246cb68565c44a6f13f028ea514adc40
BLAKE2b-256 8d5ba7d19ea4f450aa14e86fdd9a21f044e0521693a8fdde21ad824b6517e5e3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 e8a0cfe4f23e578910d774d2e7e316ad3122faa86399853076f34d5d8b0b9e3d
MD5 8ff7f4fabb2abf9082cba82530f34430
BLAKE2b-256 185a03d06cb314e767c10deb45a3b1a37b15e3306534f04af370c81871dde59a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 94edc056452b4738d8e47c937ef2140cf4fa39486697bdcec5a0019f98b855f2
MD5 c56abccd379583fd840228aa79f1a7cb
BLAKE2b-256 125303768f950046913cc35ff733ef18f9527f1a00d310a1e45afac169a4d9bc

See more details on using hashes here.

File details

Details for the file alphameta-2.6.4-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.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 1deb51b52ebf6b61b313f7863c50037eb8755207ebfaf55f76ce89f742909a3e
MD5 2d3e05e11c8245e4167ded1615e3aa8b
BLAKE2b-256 a648600285cde12b88ee883549df94b2f7dd3fe69473d3f7921c3d0f7e8f5853

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2300614bcd54268c08c3b2f2f5f088286b9196ec730538078740406547031e1e
MD5 31a0ae5ca34e348e786950f137f5edd3
BLAKE2b-256 bfd2a4b4976259d8883f7fcd517e55e01d5f3bd5c2d650e20d946f60799ce35e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 5df5ce0e76954968a01f61792b637368c320ff2a67bf2a8caa2e9547b73c2d06
MD5 023ea71f802df1aaa083dee202d343d0
BLAKE2b-256 7da36d5e6304122483caaae3f203ffdf63d69646c75068dced7cf0cf33e3576f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.4-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.4-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 0214221200d201a727ff4c1428a44714b7b7ffdb0fb48a0d8412931f79306857
MD5 e923f87f7b9e06aaa8228079f7391218
BLAKE2b-256 9347c62518b9e9e342b3838cdaa314dc50c7bfacd47b3262fc6e49bb2e9079f3

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 c00eecba18e5ac9e171cd4a1ba99a972ae089ecc295855ef08d3898e87ba1d84
MD5 4fa6f37e6f1b0f9b831f44b14a9cbfc9
BLAKE2b-256 677aa2160c3339724302a5057bfaf79193673d4e77a28f5068c42191a0f4ede0

See more details on using hashes here.

File details

Details for the file alphameta-2.6.4-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.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c351cebe05e3dee2a6eb3fc3c3352012af0fbbf3b8c412ccff0c5863fb5ebd36
MD5 b6a409deaea33697f5b50a0393d7c58a
BLAKE2b-256 9cf0ec6357f456dc34663c6cfdd422dbd16a03d4cd990eedb568c281a0f69458

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.4-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c88c2b5cdc3b2c3d8157f45431872a80e54fcc86b6c3441e305c6aa6dd1b890a
MD5 5bddd4a9d201db091c0cc4adff5afbcf
BLAKE2b-256 f3aef7ec877b79d43a3e709f573faf962656e53d40142b24bea443cf58ff7c22

See more details on using hashes here.

Release history Release notifications | RSS feed

2.6.7

15 files

2.6.6

15 files

2.6.5

15 files

This release

2.6.4 This release

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