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

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14Windows x86

alphameta-2.6.6-cp314-cp314-musllinux_1_2_x86_64.whl (11.6 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

alphameta-2.6.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.5 MB view details)

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

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

Uploaded CPython 3.14macOS 11.0+ ARM64

alphameta-2.6.6-cp313-cp313-win_amd64.whl (7.4 MB view details)

Uploaded CPython 3.13Windows x86-64

alphameta-2.6.6-cp313-cp313-win32.whl (6.4 MB view details)

Uploaded CPython 3.13Windows x86

alphameta-2.6.6-cp313-cp313-musllinux_1_2_x86_64.whl (11.7 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

alphameta-2.6.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.5 MB view details)

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

alphameta-2.6.6-cp313-cp313-macosx_11_0_arm64.whl (10.3 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12Windows x86

alphameta-2.6.6-cp312-cp312-musllinux_1_2_x86_64.whl (11.7 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

alphameta-2.6.6-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.6-cp312-cp312-macosx_11_0_arm64.whl (10.3 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: alphameta-2.6.6-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.6-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 07566f12f1b88553b85d5f98515407d12477d0eee8176206128bc39d07504440
MD5 4d72a368501057e5ff43daf9c97b2246
BLAKE2b-256 34945156437711419a37342ae7b4bbd53493c9a22b1de0748d1e82257541271b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.6-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.6-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 c174c727add9d2912dd7446b5981ff896a43e899b4fb85a567c8b079fb591444
MD5 6eb09d2dff23e1faa3ff20ad2ea7ae20
BLAKE2b-256 2899a594a338e871aa3e1f188057cb62957f1b59331b9fd4c78dafb471b626f8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 f75c9c88df8d0243444393d31c3531bc73900180ffc63a8a8297d6a3f2f967c5
MD5 77e9ad78a9c75d7e2de8aca04645dea5
BLAKE2b-256 efb5922affc04e9591a02802ce1c9121eb3bfe2376bf576a41090ccd9add038f

See more details on using hashes here.

File details

Details for the file alphameta-2.6.6-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.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cebc4cd915e25d3b1aed15e0b324811886ae98aae2a8870cbe98d66fb9ad0a7c
MD5 fde5f06d145f709bb85888cdbc358c04
BLAKE2b-256 aa482eb4736f8758bac97696d4f75440675a26b7ef6509fdcdfb8bbb4ff62a96

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c7f5ba620b5f5e65fa60526db2462a4aad7a20bc5d6de0ccaed7eb5038ee8527
MD5 76f0f2f93490d43ece2b9cbd252018e6
BLAKE2b-256 2802bd7e77b8077b8bf5e3a893d6d66aa0e5e596c014190e3bda7fc871b576cb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.6-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 7.4 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.6-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 eb2ad9dddb5b5d8e36eb2d5a0a6b0d2a15ee88b8ec8dedcc898f4215ce354627
MD5 84d31352c8946589e029f16f3407ca78
BLAKE2b-256 14906e64d1049c522c35e24d8a74a68086dece5416f33b61e5e586e83bf41715

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.6-cp313-cp313-win32.whl
  • Upload date:
  • Size: 6.4 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.6-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 f94e171496271ec8f17ba68bde8f06b36db791f7e7e649c71eb54ac06f54aa4a
MD5 e471f224d048a54bfa88f254184ad051
BLAKE2b-256 808f0fb3ad22b081a9cb9d196d1812ab25edbd5499dccb722a14a16385a7959c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 72e2036e24294bf866c3e7ce22f6f531e95241aac58dc35cdabdb6f95f7b6ee7
MD5 6a32019a5a5a6f2eb9ff849f4824b047
BLAKE2b-256 2561f1dc8a86d0622e6d11e4f216dc6432e267f3b1153bbcddb068cca0e850b2

See more details on using hashes here.

File details

Details for the file alphameta-2.6.6-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.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 e1c8182a3637bd344851bbd6cac0cfe646717757f8f73627fb440507fd6b206e
MD5 054944bf1d17d0b39cb490a01ce28e98
BLAKE2b-256 deabef099aed065daf72f0ec4a338544e1bd5911a51bd0d5d06ab2211aa2db00

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c64c26b3ad26938fd94df01af0595610f80a83a8ecb54c2519be6722bcc1fda7
MD5 c7791be076b30db34cab0874997082d8
BLAKE2b-256 e98f8fd2d92ac69417b0dcd833f3fd2cc8eb90240d9c74cd3e67ff9c1e3d9d34

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.6-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.6-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 868d64e9de3c47d485b5838574e73fdb3d59d6961f1fe9cf17f09402570a1e35
MD5 321e80b4124a61e2f83c08f78ab77c0f
BLAKE2b-256 cd9f5aa3a41690819d94f6b2ae295d7c04f55d6187583978620741320afa85dd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.6-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.6-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 4f135cd5a4dfeb2a8880f4792c879365ed30525761f9da210e3468a356f95081
MD5 ca23ca47092e17a7223c645b7da365eb
BLAKE2b-256 9110af93d6d78134da8976f3801840784cd49028beb7ea3b8c9573543b2cf486

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 51de237989df6d8da049b11c0ffa63bcb0df3642826d762bda6c9323afbf3826
MD5 6a7c6e8632e9363761b2a921d8b71227
BLAKE2b-256 77691501e87ec28392e2194f27e81769939a2043d486ef2d943369c392011fd5

See more details on using hashes here.

File details

Details for the file alphameta-2.6.6-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.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 86e82c9c75fee6ade0aa66cc82ff3bc6643e77b0476829fdd53c9d971547f73f
MD5 3a077e11ec53913a051fbe68573c7d15
BLAKE2b-256 733a1fc4b5a347e9eb5f09505d6942a6ca734f20b06d36de6ab860b118f2fc3e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.6-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 02bf614f1aa55baaa719f522fbe5748b82bb522215ae9416c156b49de786f3e9
MD5 6db81372eb2ee609906a36d805ec3575
BLAKE2b-256 1ac623cb77c6ee12c7b8fad9562eeaf855badf211dbb8325e22232324943a843

See more details on using hashes here.

Release history Release notifications | RSS feed

2.6.7

15 files

This release

2.6.6 This release

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