AlphaMeta

PyPI - Version Python Version Platform PyPI - Downloads Downloads

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

Uploaded CPython 3.14Windows x86-64

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

Uploaded CPython 3.14Windows x86

alphameta-2.6.2-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.2-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.2-cp314-cp314-macosx_11_0_arm64.whl (10.0 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

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

Uploaded CPython 3.13Windows x86-64

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

Uploaded CPython 3.13Windows x86

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

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

Uploaded CPython 3.12Windows x86

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 f04c7c3ab8895a49a6ab852b667751edfb99d8b22d79e887e6b78676cd488d5d
MD5 4d92740bdbee28a0d16e481cd03bbbfc
BLAKE2b-256 90b84c04047dee790d86e9d700b3f84027ced164c9a56e0897e639778c5a0cf7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp314-cp314-win32.whl
Algorithm Hash digest
SHA256 a12fbf1e6393f6ec2f8a0774efd74852c15c7401c332c77cebf99d3a8bfbea2b
MD5 4bbb7663f4f1d2f6d484448ae0824e0e
BLAKE2b-256 47c2b398925b3db26c36c61f4e10c1991a55f5f3846b811a48843d56c6eb08fc

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 09fb1ef5afc8c08b267704f7e835073bbee34b687d17e4ca113ff25bb15c233f
MD5 43fb818a641c9aa7fe5a82928e75c76b
BLAKE2b-256 603122990fcb47845c292833febbe1ab338c844c9af1de3def3176f610f2f618

See more details on using hashes here.

File details

Details for the file alphameta-2.6.2-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.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 81e0f60c63aa862184e176590d3ae79a67bcc3a64a460b71033962d3716f3715
MD5 5d1f68765332c87e79b13347e3761c06
BLAKE2b-256 5a03302e44e9203efcdf593cdb25067a9b9c68f28d6b589988eb6663e028e7bf

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0025a41846252fcc44ce9de463cb61f01dad7c9fef1a98de7d1f6c0a1ac6273e
MD5 21c89c7abb844fb0254371dd4be459f2
BLAKE2b-256 d986994062be072677523c2837f0167fa21aee3cd9b7446345aeca46d073de91

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 6c1aaff7da40c0e3477626089a0a87c19837d8f10274fb3272596c32ff3cdb0e
MD5 fd0bba611f69eae6bf19c1e8a81bf3dd
BLAKE2b-256 b7a00d0af1bdbad3c011c9a116af63b90d6e6d969a3df70732a2b45bec3d6ae2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 1dbcb367199db0a51451f9188df68ef4cf7d515e1127c1939405957abac43508
MD5 af8c0f6d385f5aabf2fdb0776c1eb96c
BLAKE2b-256 fcffd5e0ab93375c9ac3f9c25590f5f2424f374f5836c59ea36cc48e73202c49

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 7b06bc60d171e1486a3d6d0f685763d544559f156a292fcbe46bfeaa24f978f4
MD5 d2af71834493d936c2efcf1c20d7c1fa
BLAKE2b-256 1687a3d55832e5cb3a632f1add4c766e891a2ce90454082fc3814481420ff1bc

See more details on using hashes here.

File details

Details for the file alphameta-2.6.2-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.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c1bed84e45fdc24d69ab5f34d305af4305a6268744da3cee397dcb6e07bf4bca
MD5 fbdb2aaa841d5df0c2eaeaab492c2834
BLAKE2b-256 47548f5512e904f0b25c9415e32fcd89cc6ca5d7824dc470026ce91246f3563e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 addddd15076b448bbe23a1a06b63e6ddaa3838b95cf4d8239ed9910f464297c6
MD5 9d84fd4a3d60b3ea59baa9e880747a56
BLAKE2b-256 7e246bbbd83ca08399a46afa5e0c0aff1f26fce726a237e05606ba67459edc84

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b07387d9b7f8875513301fb3b5b2c127abea4a71cfdc7cb962281e2aecf5e232
MD5 2c94ce7ece33ff96391e88fb81ad00a1
BLAKE2b-256 b773424193a6dcd4a2ed66887c61ff49a3e0ab98822e4c4010f2deb8c9494e61

See more details on using hashes here.

File details

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

File metadata

  • Download URL: alphameta-2.6.2-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.2-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 799654c34849482dde8f288f8de335b3fced5264e2674edb616692712031e740
MD5 180694337154ef05f4361d58d5425538
BLAKE2b-256 7e800be6a6810a773e03272e9fca568b666b93bd56859a989b72e93cd6d9ee1d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 cc2812d720a54fa3677b533c571179cee3693f94ffb0dd854cd041606c9bf5f5
MD5 0feea28542fba7e220bbfbf5dcab29b9
BLAKE2b-256 080c491fe5abbd5071d8d630020c97ad6cf339ef6f6b92e164a7d2b6486c58ad

See more details on using hashes here.

File details

Details for the file alphameta-2.6.2-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.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 44d8e554b353734e3e73889711cd47f30b89e1837b93d82dcd070f46f43f3091
MD5 8b04251b5aed04a9cf39ca821c3e6eb8
BLAKE2b-256 3be1c935a4237d1e9a9c5e7af144fc779ef14523702efc16b2a0b5fdf9857bd0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for alphameta-2.6.2-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ff95ac5fb3834684a37291c340c38c5abe3f301a099ef8ad5ab5ccbc964474f2
MD5 2e6ab30e9194d5bb11fd1ea1d0d50e71
BLAKE2b-256 f03e577447d4d18e672f6ac6da71884d50bd57fc6a2957d78b18c3f9c09192c1

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

This release

2.6.2 This release

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