invespider

Official Python client for the InveSpider API — deterministic macroeconomic regime data. No AI, no black box: every number traces back to a real, cited source (CBRT EVDS, World Bank Open Data, IMF World Economic Outlook, Fitch sovereign ratings) and a documented, literature-standard method (rolling Z-score normalization, Winsorization, and Growth×Inflation quadrant classification — the "Investment Clock" framework, Merrill Lynch / Trevor Greetham, 2004).

This API never gives investment advice. It answers "what regime is this economy in, and what does history say it most resembles" — never "buy", "sell", or "hold".

Install

pip install invespider

Quick start

from invespider import InveSpiderClient

client = InveSpiderClient(api_key="YOUR_API_KEY")  # optional -- omit for anonymous access, shares a lower rate limit

result = client.compare(
    country="TR",
    year_a="2024", quarter_a="Q2",
    year_b="2018", quarter_b="Q3",
)

for period_id, period in result.periods.items():
    print(period_id, period.regime.quadrant, "-", period.regime.description)

print("Axis deltas:", result.deltas)
print("Quadrant stability (last periods):", result.stability)

Why this is cheap to build on

All data is precomputed server-side on a scheduled batch cadence (monthly/ quarterly ingestion + recompute) — every API call is a fast read against already-computed results. There's no per-request compute cost passed on to you, and no rate-limit pressure from "expensive" queries: similarity search and N-way comparisons cost the same as a single vector lookup.

Access and rate limits

Free during this initial phase, for everyone -- there is currently no paid tier. All 27 supported countries, full ingested history, and N-way comparison (2-4 periods) are available whether or not you pass an api_key.

The only thing an API key changes today is rate limiting: anonymous requests share one limit; a key gets its own tracked 200 requests/24h (sliding window). Create a key from your account's API Keys page at https://invespider.com. If paid tiers with higher limits are introduced later, a key will be required to use them -- this README will be updated when that happens, not before.

Regime-shift email alerts (/api/subscriptions) are a separate, free, public feature -- no API key needed.

Error handling

from invespider import InveSpiderClient, InveSpiderNotComputedError, InveSpiderAuthError, InveSpiderRateLimitError

client = InveSpiderClient(api_key="YOUR_API_KEY")

try:
    result = client.compare("TR", "2024", "Q2", "1999", "Q1")
except InveSpiderNotComputedError:
    print("No data ingested yet for one of these periods.")
except InveSpiderAuthError:
    print("Your API key is missing, invalid, or has been revoked.")
except InveSpiderRateLimitError:
    print("Rate limit exceeded for this key -- wait 24h or use a different key.")

Development

pip install -e ".[dev]"
pytest

This package is prepared for PyPI publication but has not yet been published or uploaded.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mete-dotcom from gravatar.com mete-dotcom

Credits

Author: mete-dotcom

License

Other/Proprietary License (Copyright (c) 2026 mete-dotcom)

Requires

Python >=3.9

Provides Extra

dev

Tags

macroeconomics economic-data api-client finance regime-classification

Classifiers

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.

invespider-0.1.4-cp312-cp312-win_amd64.whl (99.7 kB view details)

Uploaded CPython 3.12Windows x86-64

invespider-0.1.4-cp312-cp312-win32.whl (88.8 kB view details)

Uploaded CPython 3.12Windows x86

invespider-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (622.1 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

invespider-0.1.4-cp312-cp312-macosx_11_0_arm64.whl (112.8 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

invespider-0.1.4-cp311-cp311-win_amd64.whl (100.1 kB view details)

Uploaded CPython 3.11Windows x86-64

invespider-0.1.4-cp311-cp311-win32.whl (89.1 kB view details)

Uploaded CPython 3.11Windows x86

invespider-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (589.3 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

invespider-0.1.4-cp311-cp311-macosx_11_0_arm64.whl (111.4 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

invespider-0.1.4-cp310-cp310-win_amd64.whl (101.0 kB view details)

Uploaded CPython 3.10Windows x86-64

invespider-0.1.4-cp310-cp310-win32.whl (90.1 kB view details)

Uploaded CPython 3.10Windows x86

invespider-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (568.0 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

invespider-0.1.4-cp310-cp310-macosx_11_0_arm64.whl (113.0 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

invespider-0.1.4-cp39-cp39-win_amd64.whl (101.5 kB view details)

Uploaded CPython 3.9Windows x86-64

invespider-0.1.4-cp39-cp39-win32.whl (90.5 kB view details)

Uploaded CPython 3.9Windows x86

invespider-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (565.3 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

invespider-0.1.4-cp39-cp39-macosx_11_0_arm64.whl (113.7 kB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

File details

Details for the file invespider-0.1.4-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.4-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 99.7 kB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 1fc9fdd40e4ba531208873b8b5041cd09a70829ebccf3afc74aaa1ceb99a6265
MD5 1d6f7afcb56eccb224c74d9deff3e23a
BLAKE2b-256 d5cc2b89fc669df3e558f0d3ca568268d12ba01103471ee6be7d23dfd852ce30

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp312-cp312-win_amd64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp312-cp312-win32.whl.

File metadata

  • Download URL: invespider-0.1.4-cp312-cp312-win32.whl
  • Upload date:
  • Size: 88.8 kB
  • Tags: CPython 3.12, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 e08c20689013583d8cd2bcbee6e1b6288beae602517182045dbb5d2de9525940
MD5 47afb2ada0cf283e5e831b72914fa96f
BLAKE2b-256 a4ab0bb95c79cf73da80248662b44516022507368e4a76593d7db5c053aae3a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp312-cp312-win32.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7f51692758b90e7f7fe1ea2bf76c4bc1be4bf191c2d446af71876d7f6c8da800
MD5 82fc4f504352f1a80278429b45b9f5a9
BLAKE2b-256 3d379eee496e9c2310eecf5bbadf1b9665a3ab18dd0065255141ee01ed9bb5e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bcc4dd631ede8687aab4654e88730cf3ee30c0c9fa465e98670191bea2ecacae
MD5 1605d06487ab66d4f6fb6cb4d1fbc874
BLAKE2b-256 43a71b4746b9962855100a63cc53f5471b8091fc011d0dc227ebb9f34201b2ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.4-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 100.1 kB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 f004b89d49413f3eab7f4ff11a96f692fdaa6ea74dbfd1e7c39de0be4ef7e905
MD5 a0b2b3ff58d22da31665423682f95050
BLAKE2b-256 1cb6aabf2f198dce64de116423356bd0ae6eeacefe0e4d4595a2919b51544b35

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp311-cp311-win_amd64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp311-cp311-win32.whl.

File metadata

  • Download URL: invespider-0.1.4-cp311-cp311-win32.whl
  • Upload date:
  • Size: 89.1 kB
  • Tags: CPython 3.11, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 2567366b2db43d59a52376638ad8e548c89ad6a1706e9a6bf61b4d74b63f2f45
MD5 075f09489b104d41f4bb096561c8dcb8
BLAKE2b-256 3130731183f3ad599339b9cbb3e082dd7629a697a3f74c65097e4426d6ad36b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp311-cp311-win32.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e188cb853cef3bb88c8e15661f437f6b332b56b02644dee87ebf1f59a21ebd1f
MD5 22aa4915593302fa59b93a6d9cee0e5f
BLAKE2b-256 df0e56cbc0aa82aba38e99eb79670a24b3d34e737f990cbba0ae0aa9a0334081

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a7d2c087b0a574282f6834a449d00668fee2de878753a1fe7e00ded8e64ee118
MD5 b083be47cba4f3bea593d552cf8906ff
BLAKE2b-256 ec86494d459302350384ffbc0d7114be37fa8c7239a3bab886aa387ff17203f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.4-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 101.0 kB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 cf91479ff558dac496905ee7c2b950e5e0a40cd3d809e9d9a61bbc796d9ddc57
MD5 82b6dd6658980d4d1a247f86408bce39
BLAKE2b-256 7afaf5abce410a8187ab701f2d1000d1f96644775c9b17d52728201797e14d5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp310-cp310-win_amd64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp310-cp310-win32.whl.

File metadata

  • Download URL: invespider-0.1.4-cp310-cp310-win32.whl
  • Upload date:
  • Size: 90.1 kB
  • Tags: CPython 3.10, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp310-cp310-win32.whl
Algorithm Hash digest
SHA256 e5ed6f1cfcfcd188d35a67d4474ad236b5b14410eba18d25cd83ea0c9ff7775a
MD5 bb23a74a23734afa797d95e8cbca5cc8
BLAKE2b-256 94898460474d336d1ff3083b2b5adf7b9bb9cfb6c6ecdf38848e1cc0ffb7bdd8

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp310-cp310-win32.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 5d4537d18640fea8d5303f3ef4953e717e24f10c0db75bd6a0b50f6782ed7707
MD5 d1f0ee618b639b510a529a6ee50e757e
BLAKE2b-256 78473d58e628d84dae54df1130bfb29e165f8eb852f2f18d4dc02d90350ffadb

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b32d0cc956b26ce8207289e87fda089c2dace2e2269fc36b312a354206ec9b58
MD5 4208ec8731716baff702c62f6e6de0c3
BLAKE2b-256 70385c705259e54f69cfdb4ad051704e2b974cb21df4e7e952623b38c43704c3

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.4-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 101.5 kB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 60f52b9c8282a2999118cabf4ebf03376468f954046329c7733eda1731eb4674
MD5 2f09702ac6cd16e4d4339cbbd005e326
BLAKE2b-256 ae1ca4a4b7204dc955e128ba71101afc988a9066d15689181ef127cd8d76cfe7

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp39-cp39-win_amd64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp39-cp39-win32.whl.

File metadata

  • Download URL: invespider-0.1.4-cp39-cp39-win32.whl
  • Upload date:
  • Size: 90.5 kB
  • Tags: CPython 3.9, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invespider-0.1.4-cp39-cp39-win32.whl
Algorithm Hash digest
SHA256 d2731f0d09adb839696846f8f0f9b8199d3189d1399ca235a45509c3d9ddeeb9
MD5 f60aab0e16cb7312805f41d7d353f0e2
BLAKE2b-256 a935e996a25a0564fcd3d992931beb0e48c6f68091b2eef2840ca9df552826e4

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp39-cp39-win32.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 12adbdf5b37eaf88ed5f9a8ee6728cc39d3924ece32cbb5d4a744b0df255be29
MD5 e80ef64d98d4876b4c7b989c9db133d8
BLAKE2b-256 36a939ec38656de68fe5e48c6786c1c566d730fec8dc3535eb7b7468d32fa3a1

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file invespider-0.1.4-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.4-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 016c5a646110b518de9072c0ef8c735d8996f50a9ee3a8c3b1e5f6499a205458
MD5 a45b0e1166b86c0ec1903619e76b4bdf
BLAKE2b-256 12220a2b81725bbae912423149944796cbdd8c57447a0c8034b6cf5aea000b8e

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.4-cp39-cp39-macosx_11_0_arm64.whl:

Publisher: publish.yml on mete-dotcom/invespider-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.4 This release

16 files

0.1.1

16 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page