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:
Newer release available (0.1.4)

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.1-cp312-cp312-win_amd64.whl (91.6 kB view details)

Uploaded CPython 3.12Windows x86-64

invespider-0.1.1-cp312-cp312-win32.whl (81.8 kB view details)

Uploaded CPython 3.12Windows x86

invespider-0.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (554.5 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

invespider-0.1.1-cp312-cp312-macosx_11_0_arm64.whl (102.2 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

invespider-0.1.1-cp311-cp311-win_amd64.whl (92.5 kB view details)

Uploaded CPython 3.11Windows x86-64

invespider-0.1.1-cp311-cp311-win32.whl (82.3 kB view details)

Uploaded CPython 3.11Windows x86

invespider-0.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (516.2 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

invespider-0.1.1-cp311-cp311-macosx_11_0_arm64.whl (102.2 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

invespider-0.1.1-cp310-cp310-win_amd64.whl (94.0 kB view details)

Uploaded CPython 3.10Windows x86-64

invespider-0.1.1-cp310-cp310-win32.whl (82.5 kB view details)

Uploaded CPython 3.10Windows x86

invespider-0.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (493.3 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

invespider-0.1.1-cp310-cp310-macosx_11_0_arm64.whl (102.7 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

invespider-0.1.1-cp39-cp39-win_amd64.whl (94.6 kB view details)

Uploaded CPython 3.9Windows x86-64

invespider-0.1.1-cp39-cp39-win32.whl (83.0 kB view details)

Uploaded CPython 3.9Windows x86

invespider-0.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (491.4 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

invespider-0.1.1-cp39-cp39-macosx_11_0_arm64.whl (103.5 kB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: invespider-0.1.1-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 91.6 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.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 1f9ab86e8b7c7d0a6b8f26e31ebda39e9b859e90da35b3f62db1e350e36373e2
MD5 c522cdbea68d98a2d341f5a60b924b31
BLAKE2b-256 fc175ac7500c25aa3ac9ee89d1f350e2813c32f7de9aa209855809e858b30b1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp312-cp312-win32.whl.

File metadata

  • Download URL: invespider-0.1.1-cp312-cp312-win32.whl
  • Upload date:
  • Size: 81.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.1-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 33685761731059f64159549cf037b0dcb3127d8661eed386769e12a6399cb3aa
MD5 0634954d9c225fe1f5cac157615ea415
BLAKE2b-256 260973d787eda3789e5b5a83d4e4da5ba9c66c6d58364b26448b6e485e36f00c

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8c2d42a39449e5fa1afbfbdfcf9ec75cb67da2f8f35b4a3b90546f964f756c82
MD5 c7da4fe257cc3d783418ddead0baf911
BLAKE2b-256 4acd59d96441ff7847709035b51fead3f8d12b4df1ae159d1af37ea0bc92dc7d

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 eae1d11be5ee1355b38ee790c23a73f858216de8be5b1b7f88d9c2a83d1da792
MD5 3fe0eff297fc31552cc44ad45f189967
BLAKE2b-256 17e85f81c1119020b2e53e99a7d0387817e0cd605e2b68bedeb6fc3fd29296d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.1-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 92.5 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.1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 901866c335c341eaa901237cebefcd0006aef6e1111b3d32755af6befed1cbf7
MD5 2263c96f840c4df53127435810d9e9cd
BLAKE2b-256 9bffcf6a1c3b861e0b17736c6ba67fa8c7faf3db20cc4d644876ff63b2553f1d

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp311-cp311-win32.whl.

File metadata

  • Download URL: invespider-0.1.1-cp311-cp311-win32.whl
  • Upload date:
  • Size: 82.3 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.1-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 78d0351c58a0d7ac2d56dfbfc38206adc7afd1f20c517c1e4442267ef8469b19
MD5 d70724629a6b483ed5d37e91561bc5a4
BLAKE2b-256 d4523f7b3fd2fc990169967047400404210b812e9cb20990189ca4549491c8a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 fb7fe6e59ba219feb0de24d7020f25bc379683f48d4bfbaa8fc1acc799c355ca
MD5 cef73ace726dd0011c0a08e7b1ebc202
BLAKE2b-256 066c8c883fd8fd3748518612fb2be2a1ceca5ae657b750838ccf6ded1cb63617

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4ce3a9439a698bb9606e1c2184ed5b6078978eba05cd7c8559e9e1cc4dfcc300
MD5 d6bd841586f2a1730dc1cac8ce580b15
BLAKE2b-256 0a1573cd062611efa5d02620aca19b2dd088bc6b15aeb43fe3fe054237df1ce8

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.1-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 94.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.1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 b07c1f3fd1b15d77620d6b0a2acbd3672baf7446dca218964f2dddd5d0ffc0eb
MD5 5ca8dbdf1ad7d8ca0a2a461ec682516e
BLAKE2b-256 8d045eaa879f94a5e1098b9023542b41011d7709935dcbdda234ece47dbcbf4d

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp310-cp310-win32.whl.

File metadata

  • Download URL: invespider-0.1.1-cp310-cp310-win32.whl
  • Upload date:
  • Size: 82.5 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.1-cp310-cp310-win32.whl
Algorithm Hash digest
SHA256 8389ba56d819ff85b218ec4f30fd300dde32de186e25ea49338572bc41d709e6
MD5 45827389f3048d98e0da1b2ea5004f8a
BLAKE2b-256 f5f0f4041ca2b77fb8371cadc739609be722de3c6144006cb950e8027ab388df

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 a64c1894802e08b60928e888695f0c26fe064a13e27ce634ec0d64a7164e4a2b
MD5 a2c252fa08f49a34935cac5f4f6f9b80
BLAKE2b-256 17bc71b6f321c4755fd3d23397aca4382d7b2116fb343b5b5161a96fe29a573f

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 62740003906446b00ef22b9ffbc0077a20519e6c86123baf4f8216967304ab71
MD5 6214136efabd688863256f3b7345d493
BLAKE2b-256 a6ebf23ab71916cabcaf3ae1007688491cc5453b62eb23c7cab463e38a8eea1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: invespider-0.1.1-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 94.6 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.1-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 e0c5b7d26688da68a75e6d16b815724bab9ff37bc3d8bc4d2277b33f8d15fcea
MD5 3276c2a7fbaf3a4deb10b0778cbdf1f1
BLAKE2b-256 67f21266bda06054e95ff0756864b7c13552a33cd20a1eb207efacf243fa091d

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp39-cp39-win32.whl.

File metadata

  • Download URL: invespider-0.1.1-cp39-cp39-win32.whl
  • Upload date:
  • Size: 83.0 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.1-cp39-cp39-win32.whl
Algorithm Hash digest
SHA256 4d8933b8fe8988a562a93176b4e356d648cf4679d7544b6ac32005bc181f2dde
MD5 30e1ba9863105cf79ff3f5154aed177e
BLAKE2b-256 fe87b4c06cb4a03db3078b4d52ca230c5dfadc9ba7a529c9ab278da314999a81

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 802d84af7c8e43be9ea4cab208ed9cfcfd4ee1ebfd35a135bd838890b2d4004c
MD5 828663ee7a46c1d24dff24098358352d
BLAKE2b-256 f38e691b079e74c9c6106156690182a03334c78ac7fec255d45335f0a2e59f3b

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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.1-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for invespider-0.1.1-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3d04a89eb49cb71eed6c1c508e899566f8f0ecb5506ab8262acdcf72561f5a23
MD5 ff19ec01ed9719a52289481a6585e602
BLAKE2b-256 29dba9373f85cca45ea0be7c57f340bf61e1fd925a1b37e04be05e9712d33f3d

See more details on using hashes here.

Provenance

The following attestation bundles were made for invespider-0.1.1-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

0.1.4

16 files

This release

0.1.1 This release

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