everestapi 0.1.2__tar.gz

everestapi-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EverestQuant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

everestapi-0.1.2/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: everestapi
+Version: 0.1.2
+Summary: Python SDK for the EverestQuant prediction tournament platform
+Author-email: EverestQuant <engineering@everestquant.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://everestquant.ai
+Project-URL: Documentation, https://docs.everestquant.ai
+Project-URL: Repository, https://github.com/everestquant/everestapi-public
+Keywords: quant,tournament,prediction,staking,machine-learning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-httpx>=0.34.0; extra == "dev"
+Dynamic: license-file
+
+# everestapi
+
+Python SDK for the [EverestQuant](https://everestquant.ai) prediction tournament platform.
+
+```bash
+pip install everestapi
+```
+
+## Quickstart
+
+```python
+from everestapi import EverestAPI
+
+api = EverestAPI(api_key="eiq_your_key")
+
+# Browse the universe
+universe = api.get_universe()
+
+# Download training data
+api.download_dataset(universe="futures", split="train", output_path="train.parquet")
+
+# Submit predictions
+api.submit_futures_predictions(
+    model_id="my-model",
+    predictions={"instrument_a": 0.5, "instrument_b": -0.3},
+)
+
+# Check scores
+scores = api.get_scores(model_id="my-model", days=30)
+```
+
+Or set `EVEREST_API_KEY` as an environment variable and omit the constructor argument.
+
+> **Handling your API key.** Shell history, terminal recordings, and CI logs may persist any value you `echo` or `print`. Copy the key via the clipboard rather than echoing it in a recorded session, and prefer storing it in a secrets manager or `.env` file (gitignored) over inlining in source.
+
+## Two tournaments
+
+| Tournament | Universe | Features | Frequency |
+|------------|----------|----------|-----------|
+| **Alps** (Equities) | Large-cap equities | Obfuscated fundamental + technical | Daily |
+| **Himalayas** (Futures) | Global futures | Obfuscated cross-sectional + macro | Weekly |
+
+```python
+# Equities
+api = EverestAPI(api_key="...", tournament="equities")
+api.submit_predictions(model_id="my-eq-model", predictions=[...])
+
+# Futures
+api = EverestAPI(api_key="...", tournament="futures")
+api.submit_futures_predictions(model_id="my-fut-model", predictions={...})
+```
+
+## Key features
+
+### Submitting from a file
+
+Both Parquet and CSV are accepted. **Parquet is recommended** — float precision round-trips cleanly, files compress well, and it matches the format the SDK serves to you (`download_dataset` returns parquet).
+
+```python
+api.submit_predictions_file(
+    model_name="my-model",
+    file_path="predictions.parquet",  # or "predictions.csv"
+    tournament="equities",
+)
+```
+
+The file must have `ticker` (str) and `score` (float in `[-1, 1]`) columns, one row per universe instrument.
+
+From the CLI:
+
+```bash
+everestapi submit --model my-model --file predictions.parquet
+```
+
+### Data & diagnostics
+
+```python
+api.download_dataset(universe="futures", split="train")
+api.download_benchmark(universe="futures", split="validation")
+api.get_dataset_info(universe="futures")
+api.get_diagnostics(model_id="my-model")
+api.submit_validation_diagnostics(model_id="my-model", predictions=df)
+```
+
+### Serverless compute
+
+```python
+# Tier 1 — quick-train with built-in templates
+job = api.quick_train(model="lightgbm", features="small", target="target_everest_20")
+
+# Tier 2 — custom script on GPU
+job = api.custom_train(script_path="train.py", gpu="A100", max_hours=2.0)
+
+# Wait and download
+result = api.wait_for_job(job["job_id"])
+api.download_model(job["job_id"], output_path="model.pkl")
+```
+
+> **Pickle safety.** Trained models are returned as pickle files. `pickle.load` is RCE-equivalent: only load `.pkl` files from compute jobs you initiated yourself. Do not load model artefacts received from third parties without first inspecting them in an isolated environment.
+
+### Staking (USDC)
+
+```python
+api.stake(model_id="my-model", amount_usdc=100.0, wallet_address="0x...")
+api.get_stake_balance(model_id="my-model")
+api.claim_payout(model_id="my-model", round_id="42")
+```
+
+### Local evaluation
+
+```python
+import pandas as pd
+
+val = pd.read_parquet("futures_validation.parquet")
+metrics = EverestAPI.evaluate(predictions, val, target="target_everest_20")
+print(metrics)  # {"simple_corr": 0.023, "weighted_corr": 0.019, "per_difficulty": {...}}
+```
+
+### CLI
+
+```bash
+everestapi health
+everestapi universe
+everestapi submit --model my-model --file predictions.parquet  # or .csv
+```
+
+## Registration
+
+No API key needed to register:
+
+```python
+result = EverestAPI().register(name="my-agent", email="agent@example.com")
+print(result["api_key"])  # shown once — save it
+```
+
+## Context manager
+
+```python
+with EverestAPI(api_key="...") as api:
+    universe = api.get_universe()
+    # connection pool cleaned up on exit
+```
+
+## Requirements
+
+- Python 3.10+
+- httpx >= 0.27
+
+## Disclaimers
+
+- **Not financial advice.** EverestQuant tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
+- **Testnet / beta.** The staking system and compute platform are in beta. Smart contract addresses, API endpoints, and payout mechanics may change without notice.
+- **API stability.** This SDK targets API v1. Breaking changes will be communicated via the platform changelog and will follow semver once the SDK reaches 1.0.
+- **Data is obfuscated.** All features and instrument identifiers served by the API are obfuscated. Attempting to reverse-engineer or de-obfuscate data violates the platform terms of service.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

everestapi-0.1.2/README.md

@@ -0,0 +1,158 @@
+# everestapi
+
+Python SDK for the [EverestQuant](https://everestquant.ai) prediction tournament platform.
+
+```bash
+pip install everestapi
+```
+
+## Quickstart
+
+```python
+from everestapi import EverestAPI
+
+api = EverestAPI(api_key="eiq_your_key")
+
+# Browse the universe
+universe = api.get_universe()
+
+# Download training data
+api.download_dataset(universe="futures", split="train", output_path="train.parquet")
+
+# Submit predictions
+api.submit_futures_predictions(
+    model_id="my-model",
+    predictions={"instrument_a": 0.5, "instrument_b": -0.3},
+)
+
+# Check scores
+scores = api.get_scores(model_id="my-model", days=30)
+```
+
+Or set `EVEREST_API_KEY` as an environment variable and omit the constructor argument.
+
+> **Handling your API key.** Shell history, terminal recordings, and CI logs may persist any value you `echo` or `print`. Copy the key via the clipboard rather than echoing it in a recorded session, and prefer storing it in a secrets manager or `.env` file (gitignored) over inlining in source.
+
+## Two tournaments
+
+| Tournament | Universe | Features | Frequency |
+|------------|----------|----------|-----------|
+| **Alps** (Equities) | Large-cap equities | Obfuscated fundamental + technical | Daily |
+| **Himalayas** (Futures) | Global futures | Obfuscated cross-sectional + macro | Weekly |
+
+```python
+# Equities
+api = EverestAPI(api_key="...", tournament="equities")
+api.submit_predictions(model_id="my-eq-model", predictions=[...])
+
+# Futures
+api = EverestAPI(api_key="...", tournament="futures")
+api.submit_futures_predictions(model_id="my-fut-model", predictions={...})
+```
+
+## Key features
+
+### Submitting from a file
+
+Both Parquet and CSV are accepted. **Parquet is recommended** — float precision round-trips cleanly, files compress well, and it matches the format the SDK serves to you (`download_dataset` returns parquet).
+
+```python
+api.submit_predictions_file(
+    model_name="my-model",
+    file_path="predictions.parquet",  # or "predictions.csv"
+    tournament="equities",
+)
+```
+
+The file must have `ticker` (str) and `score` (float in `[-1, 1]`) columns, one row per universe instrument.
+
+From the CLI:
+
+```bash
+everestapi submit --model my-model --file predictions.parquet
+```
+
+### Data & diagnostics
+
+```python
+api.download_dataset(universe="futures", split="train")
+api.download_benchmark(universe="futures", split="validation")
+api.get_dataset_info(universe="futures")
+api.get_diagnostics(model_id="my-model")
+api.submit_validation_diagnostics(model_id="my-model", predictions=df)
+```
+
+### Serverless compute
+
+```python
+# Tier 1 — quick-train with built-in templates
+job = api.quick_train(model="lightgbm", features="small", target="target_everest_20")
+
+# Tier 2 — custom script on GPU
+job = api.custom_train(script_path="train.py", gpu="A100", max_hours=2.0)
+
+# Wait and download
+result = api.wait_for_job(job["job_id"])
+api.download_model(job["job_id"], output_path="model.pkl")
+```
+
+> **Pickle safety.** Trained models are returned as pickle files. `pickle.load` is RCE-equivalent: only load `.pkl` files from compute jobs you initiated yourself. Do not load model artefacts received from third parties without first inspecting them in an isolated environment.
+
+### Staking (USDC)
+
+```python
+api.stake(model_id="my-model", amount_usdc=100.0, wallet_address="0x...")
+api.get_stake_balance(model_id="my-model")
+api.claim_payout(model_id="my-model", round_id="42")
+```
+
+### Local evaluation
+
+```python
+import pandas as pd
+
+val = pd.read_parquet("futures_validation.parquet")
+metrics = EverestAPI.evaluate(predictions, val, target="target_everest_20")
+print(metrics)  # {"simple_corr": 0.023, "weighted_corr": 0.019, "per_difficulty": {...}}
+```
+
+### CLI
+
+```bash
+everestapi health
+everestapi universe
+everestapi submit --model my-model --file predictions.parquet  # or .csv
+```
+
+## Registration
+
+No API key needed to register:
+
+```python
+result = EverestAPI().register(name="my-agent", email="agent@example.com")
+print(result["api_key"])  # shown once — save it
+```
+
+## Context manager
+
+```python
+with EverestAPI(api_key="...") as api:
+    universe = api.get_universe()
+    # connection pool cleaned up on exit
+```
+
+## Requirements
+
+- Python 3.10+
+- httpx >= 0.27
+
+## Disclaimers
+
+- **Not financial advice.** EverestQuant tournaments are prediction competitions. Nothing in this SDK or on the platform constitutes investment advice, a solicitation, or a recommendation to buy or sell any financial instrument.
+- **Testnet / beta.** The staking system and compute platform are in beta. Smart contract addresses, API endpoints, and payout mechanics may change without notice.
+- **API stability.** This SDK targets API v1. Breaking changes will be communicated via the platform changelog and will follow semver once the SDK reaches 1.0.
+- **Data is obfuscated.** All features and instrument identifiers served by the API are obfuscated. Attempting to reverse-engineer or de-obfuscate data violates the platform terms of service.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

everestapi-0.1.2/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "everestapi"
+dynamic = ["version"]
+description = "Python SDK for the EverestQuant prediction tournament platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "EverestQuant", email = "engineering@everestquant.ai" }]
+keywords = ["quant", "tournament", "prediction", "staking", "machine-learning"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "click>=8.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-httpx>=0.34.0"]
+
+[project.scripts]
+everestapi = "everestapi.cli:cli"
+
+[project.urls]
+Homepage = "https://everestquant.ai"
+Documentation = "https://docs.everestquant.ai"
+Repository = "https://github.com/everestquant/everestapi-public"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "everestapi.__version__"}

everestapi-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

everestapi-0.1.2/src/everestapi/__init__.py

@@ -0,0 +1,32 @@
+"""EverestAPI — Python SDK for the EverestQuant prediction tournament platform."""
+
+__version__ = "0.1.2"
+
+from everestapi.client import EverestAPI, EverestError
+from everestapi.types import (
+    FeatureResponse,
+    Instrument,
+    LeaderboardEntry,
+    LeaderboardResponse,
+    Score,
+    ScoresResponse,
+    StakeBalance,
+    StakeResponse,
+    Submission,
+    UniverseResponse,
+)
+
+__all__ = [
+    "EverestAPI",
+    "EverestError",
+    "FeatureResponse",
+    "Instrument",
+    "LeaderboardEntry",
+    "LeaderboardResponse",
+    "Score",
+    "ScoresResponse",
+    "StakeBalance",
+    "StakeResponse",
+    "Submission",
+    "UniverseResponse",
+]

everestapi-0.1.2/src/everestapi/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as ``python -m everestapi``."""
+
+from everestapi.cli import cli
+
+cli()