AlphaMeta

PyPI - Version Python Version Platform PyPI - Downloads Downloads PyPI - License

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 start the server:

export ALPHAMETA_API_KEY=am-xxx
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.
Persist config in ~/.alphameta/.env (see .env.example).

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

Apache-2.0

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

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14Windows x86

alphameta-2.6.1-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.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (11.2 MB view details)

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

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

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13Windows x86

alphameta-2.6.1-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.1-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.1-cp313-cp313-macosx_11_0_arm64.whl (10.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

alphameta-2.6.1-cp312-cp312-win_amd64.whl (7.2 MB view details)

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12Windows x86

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

File metadata

  • Download URL: alphameta-2.6.1-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.1-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 097824979b21824cd425af7ecb6908ca4cc49830eba1cbf2dc40caa2fb04ebb5
MD5 6e15395eb4b8e0e859386007e91ad004
BLAKE2b-256 f9b25b53e903b32abff45f53ea2e03936228e65410e716e156e19b2ce4a8aaeb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.1-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.1-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 9e1ea3686a314380c570b50e56252e2884827d0fad4d72cc161eae288333172f
MD5 63a3afa70077b47d080860635ac5e661
BLAKE2b-256 5423b4964d484b940950647a82025b2e2bf437304890c67bea01b3c8587a9721

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 f3e8a46fb49a2921f38c9ea37a6f876812d45a3ca8ace5e7f17c666db63c0b2c
MD5 e25e4a8ab37f39b3443af3d7950cee75
BLAKE2b-256 75c46bf1585605711d7b82160444ee5e01199bdacea28d4e084290f1040be21f

See more details on using hashes here.

File details

Details for the file alphameta-2.6.1-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.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2e3fb097deb190a2a71b262da9aa66170002c2060bfda4cb697be25a71c5a303
MD5 1ab3501a0f3819e3d8a23d3352d452b8
BLAKE2b-256 d53569888d54a95f23340d5332a987dd4a580d52784c7ad2eaf6f8428f56fcaf

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3ff538efb14bb331311b345f172813ce56ad7bb6ee5177588fc13b573daddcce
MD5 2625efa81650b9e3cf04bdec83ba261a
BLAKE2b-256 0986153c441bd0383d168cf42e4b3bd9a5615f21b6e8c5173f9b9e2de251e5a2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.1-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.1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 6cd7dabe6d50c8ffad7c26a39aca5f609f200233ec7bce0cbc51cdab333896d7
MD5 94dda2c1b2818d149d94a1bff2d6ffff
BLAKE2b-256 9ed49991d8f398223636d15785354cd22ebe0776273a747725e93ba8484607e5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.1-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.1-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 5119e74fae99155adf6f82ad94cb96a7d4c9456bb5846963067d55adf262478e
MD5 a88dab7992951bba9f874bb69cbc5f84
BLAKE2b-256 937e65b84e28cd186dda185a11ba645147843541687fd14d2489885cf87bc005

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 b0927c9fa6f9ba50f0ca6f040d2878b0e9fa4712b7d172fc640fadaee9698d55
MD5 2773fd75b537680efcc5cfc6633d5774
BLAKE2b-256 76726b85cff5786b327dce16e65f15d14e4e7d7dc2262685e29f5d5c05405c56

See more details on using hashes here.

File details

Details for the file alphameta-2.6.1-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.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4e0ab823278b9a1e6ec39f8ce800285a73a78ba0eafe5190465941c7e7631cfc
MD5 650ce6e07cdfe15d607202861448a7d2
BLAKE2b-256 908539a76f7b820e13038dd5fb6b2e6bc92a4d50f11a7fd32e6a80ad85bef478

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c176edb7c3a0527c90312ab27f8c71003ba8a0cde9b806158eb3f4452b6e1e77
MD5 b7d9f8f529d66b3d347ad33dd3b12fd1
BLAKE2b-256 205fdb14d74352d9a2e4b4f98c8be5c32261623a49062b5319a43944855a84f6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.1-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 7.2 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.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 c7ff7ac73b9bc7f50cc811c65066c821a665a548f1edf620df8f9430785b9d3c
MD5 beb2ac019d9ece78cbe3d2c9d8abecfa
BLAKE2b-256 20ef37edbde832abb661b138dff0263f613833b1c91584333159b3d4556fd553

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.1-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.1-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 e9c73519280300d5bea083e045d55bdcc0e4f4649dbdf6fdff86409c3a1c60d1
MD5 df1676faea757f8096181ae1deaf4ff6
BLAKE2b-256 7060394d380935804c3dd676f1f8451ecfb6f942c3c8c25d60c1a4dacadef8a2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 75d239256b0216997d0ee11204810a72809317aac659beb8c2c7cd3f8c0d3545
MD5 64ad47d0bbf00b229bed75bbaf143111
BLAKE2b-256 df1029fc650d6112f450d74b275737f201260aa97cf79da7a8b0f635b9930819

See more details on using hashes here.

File details

Details for the file alphameta-2.6.1-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.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 99afbc936fa3bb22145166fc15bd32d57969c3190e9fce37ab7b6054f0868a0a
MD5 2e9afbe4508daf4f69278738fcc21466
BLAKE2b-256 54bcd1a4a653bdfb09d3d8f8a06cb39a2292f943a0b7657ebe1c3b4ae06fefa4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 616d9f508f31ee0a8ac3743f3130f59fc159efae39fb166f26932d139a1a4bc1
MD5 96630d471208022d66c1d28ace1ed167
BLAKE2b-256 73981f63ac43202b91ac73b7102c82c6ddde0d75ebc57274fa7ed2fdc2d52cd2

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

2.6.3

15 files

2.6.2

15 files

This release

2.6.1 This release

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