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.2.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.2.0
File	Size	Uploaded
tribulnation_catalogue-0.2.0.tar.gz	22.8 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tribulnation-catalogue 0.2.0
File	Interpreter	ABI	Platform	Reset
tribulnation_catalogue-0.2.0-py3-none-any.whl 33.6 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 56.4 kB

Release files / tribulnation_catalogue-0.2.0.tar.gz

Download URL	tribulnation_catalogue-0.2.0.tar.gz
Size	22.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`259e8006f4a19355510acf48461aed71ba17b15a8c306506f60ea3f771d7ffea`
BLAKE2b-256 checksum How to use checksums	`62687c85e6af427309180c0e3aaaf570955ee2565ecc0f0b443fc9ce1ea3bfd2`
Upload date	Aug 31, 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/catalogue2
Publishing commit: github.com/tribulnation/catalogue2/tree/211ddc33d9ac7ecc94651d1bba597bb41beab21b

Workflow

Publishing configuration: github.com/tribulnation/catalogue2/blob/211ddc33d9ac7ecc94651d1bba597bb41beab21b/.github/workflows/release-python.yml
Publishing logs: github.com/tribulnation/catalogue2/actions/runs/33417654430/attempts/1

Artifact

Subject: tribulnation_catalogue-0.2.0.tar.gz
SHA-256 checksum: 259e8006f4a19355510acf48461aed71ba17b15a8c306506f60ea3f771d7ffea Verifying attestations

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

Download URL	tribulnation_catalogue-0.2.0-py3-none-any.whl
Size	33.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`48a6441a93f5fb3ff4e32ac32810020e6884c73e4a0b3aa018ed2ea710d32210`
BLAKE2b-256 checksum How to use checksums	`327993001f47d27e25fa8c3ebc2681275f861dcfb7cc541ee4112be2661be0f1`
Upload date	Aug 31, 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/catalogue2
Publishing commit: github.com/tribulnation/catalogue2/tree/211ddc33d9ac7ecc94651d1bba597bb41beab21b

Workflow

Publishing configuration: github.com/tribulnation/catalogue2/blob/211ddc33d9ac7ecc94651d1bba597bb41beab21b/.github/workflows/release-python.yml
Publishing logs: github.com/tribulnation/catalogue2/actions/runs/33417654430/attempts/1

Artifact

Subject: tribulnation_catalogue-0.2.0-py3-none-any.whl
SHA-256 checksum: 48a6441a93f5fb3ff4e32ac32810020e6884c73e4a0b3aa018ed2ea710d32210 Verifying attestations