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.1

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.1
File	Size	Uploaded
tribulnation_catalogue-0.3.1.tar.gz	26.3 kB	Sep 14, 2026	Details

Built distribution (wheel)

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

Total release size: 62.4 kB

Release files / tribulnation_catalogue-0.3.1.tar.gz

Download URL	tribulnation_catalogue-0.3.1.tar.gz
Size	26.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`700c999ac49e14ffc03ab9246bcea11346001bca0b35d382ab93d24434957a7a`
BLAKE2b-256 checksum How to use checksums	`de25ec047fa43233cf43967ea4daa093a9009ccc72d9e18a05f1f69a25fde016`
Upload date	Sep 14, 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/fbe76945db82a51ac1e92eb9b839f0d6c7a8d093

Workflow

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

Artifact

Subject: tribulnation_catalogue-0.3.1.tar.gz
SHA-256 checksum: 700c999ac49e14ffc03ab9246bcea11346001bca0b35d382ab93d24434957a7a Verifying attestations

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

Download URL	tribulnation_catalogue-0.3.1-py3-none-any.whl
Size	36.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ed9fe767a85d6a05fd98fe943be02829a89759d6c01c8015593797807239c055`
BLAKE2b-256 checksum How to use checksums	`9be02644e8e4a397a79a408089ed1cf8bde30569b7bed821a9ceec237edb7ad9`
Upload date	Sep 14, 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/fbe76945db82a51ac1e92eb9b839f0d6c7a8d093

Workflow

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

Artifact

Subject: tribulnation_catalogue-0.3.1-py3-none-any.whl
SHA-256 checksum: ed9fe767a85d6a05fd98fe943be02829a89759d6c01c8015593797807239c055 Verifying attestations