Tribulnation Labs
Terminal ↗

Coinbase Market

Advanced Trade spot and INTX perpetuals. Package: tribulnation-coinbase.

Account configuration

Coinbase is not a default account in MarketSDK. Configure it explicitly. Authenticated access is recommended, especially for tickers() over many markets:

from dotenv import load_dotenv
from tribulnation.sdk import MarketSDK, accounts

load_dotenv()  # COINBASE_API_KEY_NAME and COINBASE_PRIVATE_KEY

async with MarketSDK({'coinbase': accounts.Coinbase()}) as sdk:
    tickers = await sdk.tickers('coinbase:spot', markets=['BTC-USD', 'ETH-USD'])

accounts.Coinbase(public=True) is an explicit fallback when credentials are unavailable. When credentials resolve from configuration or the environment, the router still prefers authenticated access. With no credentials, it supports public market data on both exchanges. Authentication failures on a configured private account remain errors; they do not silently switch to public access. Account fees, balances and trading require credentials.

Ticker request cost

Authenticated tickers() uses the bulk best-bid/ask endpoint, in batches of up to 100 products. With public=True and no resolved credentials, the SDK reads one public order book per selected product. For 925 products, that means 10 authenticated quote requests versus 925 public quote requests, in addition to catalogue reads.

Prefer authenticated access for full-exchange sweeps. With public access, select the markets you need:

from tribulnation.sdk import MarketSDK, accounts

async with MarketSDK({'coinbase': accounts.Coinbase(public=True)}) as sdk:
    tickers = await sdk.tickers('coinbase:spot', markets=['BTC-USD', 'ETH-USD'])

Both paths combine catalogue last prices and 24-hour base volumes with native bid/ask prices and sizes. Empty book sides remain unknown (None), and failed requests propagate. Catalogue and quote reads are separate observations, not an atomic snapshot or a guarantee of equal freshness across endpoints.

Exchanges and discovery

  • spot uses Advanced Trade IDs such as BTC-USD.
  • intx uses perpetual IDs such as BTC-PERP-INTX; domestic dated futures are excluded.
  • Public discovery requests the full default catalogue and checks completion metadata and unique IDs. If Coinbase reports another page or an inconsistent response, discovery fails rather than presenting a partial catalogue. Small-page spot sweeps were observed to omit and duplicate products on both endpoint families.
  • Public rules do not fetch personal fee tiers. INTX index and funding state come from the public product details; funding-rate history uses the public International Exchange API. Private INTX portfolio reads need an INTX-scoped key.