tribulnation-catalogue

Python client for the Tribulnation Catalogue — a typed, open catalogue of crypto assets, trading platforms, and instrument mappings.

Install

pip install tribulnation-catalogue

Usage

from tribulnation.catalogue import Catalogue

catalogue = Catalogue.load()

btc     = catalogue.assets["bitcoin"]
binance = catalogue.platforms["binance"]

On first call, load() downloads the catalogue and caches it at ~/.cache/tribulnation/catalogue. Subsequent calls load from cache.

Loading options

# Use cache, download if not present (default)
catalogue = Catalogue.load()

# Force a fresh download
catalogue = Catalogue.load(refresh=True)

# Load from an explicit local folder
catalogue = Catalogue.load("data")

# Custom source URL or cache directory
catalogue = Catalogue.load(
    url="https://my-mirror.example.com/data.zip",
    cache_dir=".cache/catalogue",
)

# Suppress the download message
catalogue = Catalogue.load(silent=True)

What's available

catalogue.assets           # dict[str, Asset]
catalogue.platforms        # dict[str, Platform]
catalogue.blockchains      # filtered view: kind == 'blockchain'
catalogue.cexs             # filtered view: kind == 'cex'
catalogue.dexs             # filtered view: kind == 'dex'

catalogue.spot_instruments        # dict[platform, dict[id, Spot]]
catalogue.perpetual_instruments   # dict[platform, dict[id, Perpetual]]
catalogue.debt_instruments        # dict[platform, dict[id, Debt]]
catalogue.pools                   # dict[platform, dict[id, Pool]]

catalogue.asset_translations      # dict[platform, dict[exchange_id, asset_id]]
catalogue.network_translations    # dict[platform, dict[exchange_id, network_id]]

catalogue.spam                    # dict[platform, dict[address, SpamAddress]]

Types

All types are available from the package root:

from tribulnation.catalogue import (
    Asset, AssetPeg, ExternalIds,
    Platform, Blockchain, CexPlatform, DexPlatform,
    Spot, Perpetual, Debt, Pool,
    SpamAddress,
)

Release files for tribulnation-catalogue 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tribulnation-catalogue 0.3.2
File	Size	Uploaded
tribulnation_catalogue-0.3.2.tar.gz	27.1 kB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tribulnation-catalogue 0.3.2
File	Interpreter	ABI	Platform	Reset
tribulnation_catalogue-0.3.2-py3-none-any.whl 36.1 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 63.1 kB

Release files / tribulnation_catalogue-0.3.2.tar.gz

Download URL	tribulnation_catalogue-0.3.2.tar.gz
Size	27.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`e3f57d4f3cffc6d5835ce5a9259e5de990b2742e1aea6eefce521794dc5938ae`
BLAKE2b-256 checksum How to use checksums	`214ccf85fafb6a0c62e809f0ef827df171fbe12df76017bc2c74f5aa14c69178`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tribulnation/catalogue
Publishing commit: github.com/tribulnation/catalogue/tree/87a713576913470ff08eea21a9600b6962a790cb

Workflow

Publishing configuration: github.com/tribulnation/catalogue/blob/87a713576913470ff08eea21a9600b6962a790cb/.github/workflows/release-python.yml
Publishing logs: github.com/tribulnation/catalogue/actions/runs/34945673809/attempts/1

Artifact

Subject: tribulnation_catalogue-0.3.2.tar.gz
SHA-256 checksum: e3f57d4f3cffc6d5835ce5a9259e5de990b2742e1aea6eefce521794dc5938ae Verifying attestations

Release files / tribulnation_catalogue-0.3.2-py3-none-any.whl

Download URL	tribulnation_catalogue-0.3.2-py3-none-any.whl
Size	36.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`be656d37a27ad11283cfd82227382b05b4676c21f834aee909da6dec9b82e32a`
BLAKE2b-256 checksum How to use checksums	`28c317d65ac2b04e82182d5b853bfb8e905119e1f9ff491360183388fa0469e4`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tribulnation/catalogue
Publishing commit: github.com/tribulnation/catalogue/tree/87a713576913470ff08eea21a9600b6962a790cb

Workflow

Publishing configuration: github.com/tribulnation/catalogue/blob/87a713576913470ff08eea21a9600b6962a790cb/.github/workflows/release-python.yml
Publishing logs: github.com/tribulnation/catalogue/actions/runs/34945673809/attempts/1

Artifact

Subject: tribulnation_catalogue-0.3.2-py3-none-any.whl
SHA-256 checksum: be656d37a27ad11283cfd82227382b05b4676c21f834aee909da6dec9b82e32a Verifying attestations