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, unset

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

Uploaded CPython 3.14Windows x86-64

alphameta-2.6.3-cp314-cp314-win32.whl (6.4 MB view details)

Uploaded CPython 3.14Windows x86

alphameta-2.6.3-cp314-cp314-musllinux_1_2_x86_64.whl (11.4 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

alphameta-2.6.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.3 MB view details)

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

alphameta-2.6.3-cp314-cp314-macosx_11_0_arm64.whl (10.0 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

alphameta-2.6.3-cp313-cp313-win_amd64.whl (7.2 MB view details)

Uploaded CPython 3.13Windows x86-64

alphameta-2.6.3-cp313-cp313-win32.whl (6.2 MB view details)

Uploaded CPython 3.13Windows x86

alphameta-2.6.3-cp313-cp313-musllinux_1_2_x86_64.whl (11.4 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

alphameta-2.6.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.3 MB view details)

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

alphameta-2.6.3-cp313-cp313-macosx_11_0_arm64.whl (10.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

alphameta-2.6.3-cp312-cp312-win_amd64.whl (7.3 MB view details)

Uploaded CPython 3.12Windows x86-64

alphameta-2.6.3-cp312-cp312-win32.whl (6.3 MB view details)

Uploaded CPython 3.12Windows x86

alphameta-2.6.3-cp312-cp312-musllinux_1_2_x86_64.whl (11.5 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

alphameta-2.6.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.3 MB view details)

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

alphameta-2.6.3-cp312-cp312-macosx_11_0_arm64.whl (10.1 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 7.4 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.3-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 f4c359144e95ace6cc5347c7993b7a8d8d91bb4d9632accd3de3cfdbc84574e2
MD5 59d94ce0daa68f30aa6d0b56ff1f6166
BLAKE2b-256 7223fe546f7d099ed25355493b82b2c0cb2df280f4a823286bf2eaef0e0106ab

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp314-cp314-win32.whl
  • Upload date:
  • Size: 6.4 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.3-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 fa8007880e48230ea905d14eb1879fea10ac3eacf3cbaa7c77e9fe3b58af30a7
MD5 ceeae3ad0918a2c240f9a93a84de475a
BLAKE2b-256 ca2cddca435d9113f94b1b74fe65fd4732eb00a1c725337e4487f69312a3765f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 debf9f81ea53adda7145a2edbba4eb1d6d269c91575858dfba75ec572a3f8f86
MD5 a5234330020336dc0a5d2b3c97079d2c
BLAKE2b-256 ddf3a9a1b1fa06570b628c9e18df3677a7d38ed5283145c905c6599f4b025731

See more details on using hashes here.

File details

Details for the file alphameta-2.6.3-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.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 91be80e8f3e1a2ad9e2f4a3c8cb55f231cd373c6ec80bb2ecae55ba2247fec6e
MD5 96f79e58455ae59614895c628c4ca536
BLAKE2b-256 87cc95918d410b4e70244197986272aacec6b7355aba195e08e45326c247b75e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7ad9894e1a40d70734577a779d7e6531312656f3396a14de9ac8051fe0ca79bc
MD5 bb5f7f8657c0dac4f04ebe2b8017dcce
BLAKE2b-256 f5a7669d586c385068b8bf9f7c2c4b4d23db97f94bfb5d1db8e4439939169667

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 7.2 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.3-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 dac359b10f2e83bb7c91cad9cff66da1f9703ea02aec48b15367eecaaef52b8a
MD5 a0629aae2db2e3e019d1344702a4fb3a
BLAKE2b-256 a6a4da1c83e2205eba50ea9df753b7eddd998eb16f4e2a914efbc72df248a6e7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp313-cp313-win32.whl
  • Upload date:
  • Size: 6.2 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.3-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 d86417e8bdec9d175730a2e155118d2c0f8b8b09d8356b3f799b6ef9c82b5c92
MD5 b7eefe0a2e36af1880a00c680470a956
BLAKE2b-256 9c22825f2df7a2791fa39b08cbd8c829dc4410871e48962f24b72d8777383013

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 4a08f0e78858a2ea9f9c922a4c22ba049f9d9cc53bb38cb09a62928b291cc835
MD5 29d6484e70385ccd313cfca08c610cca
BLAKE2b-256 d59015e7a5e8565b3ace4ac4628fa6737004a55841fa2137c113b9e6b3fc2c16

See more details on using hashes here.

File details

Details for the file alphameta-2.6.3-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.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 27d2e6d6ea33e38ac6c8f663c8eb8de3b4020975c3f4e3d3841e415877738ea0
MD5 7687c6c0d9563f3c3e11a5df68047b8c
BLAKE2b-256 78c56884fb07a0bcc7aca96558bc1ea943b4a07fe878f05b7f3f32de21630d9e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a280665cf190cfe6fd9de3a1c343c582f6b847cbad93eafa921f39fb52c13542
MD5 9b0e5c0eaecb3bc25252d4906f0c742a
BLAKE2b-256 486a16ce0f574b62185bf81363a12abdde484d1e792d30aaf5dff8a2ba97d1de

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 7.3 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.3-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 887fa351a13b869162592c1d1cf68ec7c0ce7826c796929400c9754a6a5259d5
MD5 c26c76a3b4ef54ee9b81d0e3d85334f0
BLAKE2b-256 9459f9b94f797f920aea5297c1a846b243416fb9a4ac39d8c2a7cc167a735b78

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.3-cp312-cp312-win32.whl
  • Upload date:
  • Size: 6.3 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.3-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 e041008303515181bcbf8ef02ecdc32d406d6b03e5e70835d898657383e9e8ba
MD5 5557a23900a8042e08269884f1444916
BLAKE2b-256 cbd16174a23d36953bbbd68f1b19f9ada4ca8d8657f145d0ee2803def39445ff

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 74382c3e9ae5dfeb5990d8807e9e0c2fe8c58b36de563b00f2a269fd2e1be8a1
MD5 97f132f9f7af126f12180805ebc7e3a8
BLAKE2b-256 f9ed1c4f6f42dfdaab8fa780d0dc8e009f8e4a87a884f3210fdbc1d99ac44fa1

See more details on using hashes here.

File details

Details for the file alphameta-2.6.3-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.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 723708e1febc57a29c121324162a33ffd81a3d2eba7db12f9bff770486b53c79
MD5 6a0ed9416cfcc189750ccfdc0aa4eda2
BLAKE2b-256 08bbe753f5aeb44551cef2d920d99b9da3a0a7b825eb9baecc2deee2180615e2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.3-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5dd19accb127efaf9a6e57bac36ed30c02a2e3e07adb91f11d35658e55c73394
MD5 0e344b204d81f795fe1ffa049928314a
BLAKE2b-256 d4b0361b38922f324464114b99ac4e3875d91766db98abfecf033aebe28c0a25

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

2.6.4

15 files

This release

2.6.3 This release

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