# Bitrecs V2

## Docs

- [Agent endpoints — retrieve agent data](https://docs.bitrecs.ai/api/agents.md): Look up a stored agent by evaluation run ID, or fetch the Gist metadata associated with an agent ID. Returns 404 when the resource does not exist.
- [POST /check — validate miner submission](https://docs.bitrecs.ai/api/check.md): Validate a miner's artifact before committing to the chain. Runs all eligibility and format checks without persisting data.
- [Evaluation run endpoints in Bitrecs V2](https://docs.bitrecs.ai/api/evaluation-runs.md): Inspect a single evaluation run's lifecycle status, score result, error codes, and raw logs from the bitrecs-evals container for any run ID.
- [Evaluation endpoints in Bitrecs V2](https://docs.bitrecs.ai/api/evaluations.md): Retrieve a fully hydrated evaluation record — including status and aggregate score — for any evaluation run ID in the Bitrecs V2 system.
- [Inference endpoints — models and cost](https://docs.bitrecs.ai/api/inference.md): Estimate LLM inference costs, report completed inference runs, retrieve per-agent cost summaries, and list all currently available hot models.
- [Scoring endpoints — weights and Pareto data](https://docs.bitrecs.ai/api/scoring.md): Access miner scores, Pareto frontier data, winner-take-all weights, screener thresholds, scoring constants, and validator weight sets via the scoring API.
- [Statistics endpoint — problem set data](https://docs.bitrecs.ai/api/statistics.md): Query per-problem statistics for any evaluation set, including pass rates and score distributions. Responses are cached for 15 minutes to reduce database load.
- [POST /submit — submit a miner artifact](https://docs.bitrecs.ai/api/submit.md): Permanently submit a miner artifact to the Bitrecs V2 evaluation pipeline. Requires a valid chain commitment and transport-layer signatures.
- [Bitrecs V2 system architecture](https://docs.bitrecs.ai/architecture.md): An overview of the Bitrecs V2 components: the platform API, validator nodes, screener nodes, the bitrecs-evals container, PostgreSQL, and Cloudflare R2.
- [How Bitrecs V2 works: lifecycle and evaluation pipeline](https://docs.bitrecs.ai/how-it-works.md): Walkthrough of the Bitrecs V2 pipeline: artifact creation, GitHub Gist upload, screener stages, validator scoring, and onchain weight assignment.
- [Bitrecs V2: a Bittensor subnet for prompt evolution](https://docs.bitrecs.ai/introduction.md): Bitrecs V2 is a Bittensor subnet where miners compete by evolving prompt artifacts to power a live ecommerce recommendation engine.
- [Artifact YAML reference for Bitrecs miners](https://docs.bitrecs.ai/mining/artifact-reference.md): Field-by-field reference for the artifact.yaml format: required values, template variables, sampling parameters, fewshot examples, and JSON output rules.
- [Get started mining on Bitrecs V2](https://docs.bitrecs.ai/mining/quickstart.md): Install the toolchain, configure your environment, create an artifact.yaml, upload it to GitHub Gist, and submit your first onchain artifact in minutes.
- [Submitting an artifact to Bitrecs V2](https://docs.bitrecs.ai/mining/submission-process.md): Submit your artifact.
- [Tips for effective Bitrecs mining](https://docs.bitrecs.ai/mining/tips.md): Practical guidance on avoiding disqualification, tuning prompts for ecommerce recommendations, choosing a provider, and understanding screener thresholds.
- [Emission decay for long-running artifacts](https://docs.bitrecs.ai/scoring/decay.md): How Bitrecs V2 reduces emissions for artifacts that have been live for extended periods, including the grace period, daily decay rate, and minimum floor.
- [How Bitrecs V2 scores miner artifacts](https://docs.bitrecs.ai/scoring/overview.md): A full walkthrough of the Bitrecs V2 scoring pipeline: screener gates, validator evaluation, Pareto frontier selection, and onchain weight setting.
- [Pareto dominance and the scoring frontier](https://docs.bitrecs.ai/scoring/pareto-dominance.md): How Bitrecs V2 uses ε-Pareto dominance across task environments to identify the best-performing miners and protect against Sybil copying.
- [Winner-takes-all scoring in Bitrecs V2](https://docs.bitrecs.ai/scoring/winner-takes-all.md): How subset scores, Z-score thresholds, and first-commit priority combine to select a single winning miner and convert scores to onchain weights.
- [Validator environment variables and settings](https://docs.bitrecs.ai/validating/configuration.md): Reference for every environment variable accepted by the Bitrecs V2 validator, with types, defaults, and usage guidance.
- [Run Bitrecs validator with Docker Compose](https://docs.bitrecs.ai/validating/docker-setup.md): Start, monitor, update, and stop the Bitrecs V2 validator using Docker Compose, with Watchtower handling automatic image updates.
- [Set up a Bitrecs V2 validator node](https://docs.bitrecs.ai/validating/quickstart.md): Install Docker and UV, configure your Bittensor wallet, and run the Bitrecs validator using Docker Compose on Ubuntu 24 LTS.

## OpenAPI Specs

- [openapi](https://docs.bitrecs.ai/api-reference/openapi.json)