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

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.0
File	Size	Uploaded
tribulnation_catalogue-0.3.0.tar.gz	23.0 kB	Sep 2, 2026	Details

Built distribution (wheel)

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

Total release size: 56.8 kB

Release files / tribulnation_catalogue-0.3.0.tar.gz

Download URL	tribulnation_catalogue-0.3.0.tar.gz
Size	23.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`c5fb154751d8c62a2e876bc1e2b2edb188a5823208930217051a8cbc08a94cf5`
BLAKE2b-256 checksum How to use checksums	`305caf2a62657892866e752b99becbe4eecfedef01a12435ffa058dc1135cc28`
Upload date	Sep 2, 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/13fe9d612eeddcdd02efed50bff42fd193e83856

Workflow

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

Artifact

Subject: tribulnation_catalogue-0.3.0.tar.gz
SHA-256 checksum: c5fb154751d8c62a2e876bc1e2b2edb188a5823208930217051a8cbc08a94cf5 Verifying attestations

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

Download URL	tribulnation_catalogue-0.3.0-py3-none-any.whl
Size	33.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`28555af76238492f1f9535489ddead80469f4e3e9de43e415d67f070518f1914`
BLAKE2b-256 checksum How to use checksums	`9521fb6d3ec15e2d026082745a1b3965335dfcab2f38faad3d67c4f5b801a1a6`
Upload date	Sep 2, 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/13fe9d612eeddcdd02efed50bff42fd193e83856

Workflow

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

Artifact

Subject: tribulnation_catalogue-0.3.0-py3-none-any.whl
SHA-256 checksum: 28555af76238492f1f9535489ddead80469f4e3e9de43e415d67f070518f1914 Verifying attestations