Galactic

On-chain figures for the USD.AI and GAIB compute vaults. Call this for tokens outstanding, vault share price, and the trailing 90-day figure. trailing_90d_apy_percent annualizes the change in vault share price over the trailing window. It is not an issuer-quoted yield. loan_count and loan_balance_usd (US dollars) are present only when the loan book is read on-chain. JSON: {"as_of", "vaults": [{id, name, tokens, share_price_symbol, tokens_outstanding_usd, share_price, trailing_90d_apy_percent, read_at, loan_count, loan_balance_usd}]}. Unknown id: {"error": "not_found", "query", "vaults": [ids]}.

{
  "type": "object",
  "properties": {
    "asset": {
      "default": "",
      "type": "string",
      "description": "Vault id, usdai or gaib. Empty returns both."
    },
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One published asset, with per-chain supply and an optional daily price history. Call this after list_assets, or when the id is already known. Pass the id from an ambiguous result. Do not guess among assets that share a display ticker. JSON is the asset card plus by_chain (chain, supply, market_cap_usd, holders where published) and history ([{date, price_usd}], newest days only, only when the price is published). Unknown id: {"error": "not_found", "query"}. Shared ticker: {"error": "ambiguous", "query", "matches": [{id, ticker, display_ticker, name, chains}]}. An announced id returns the listing with status upcoming and no figures. Units match list_assets. Price history values are US dollars per token.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Asset id (slug), registry ticker, or display ticker. A shared display ticker returns an ambiguous error and the matching ids."
    },
    "history_days": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 30,
      "description": "Daily published prices to include, from 0 to 30. 0 omits history. History is included only when the price itself is published."
    },
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Latest GPU rental price index, in US dollars per GPU-hour. Call this for the current median rental price of a GPU model, or for prices by GPU memory. Omit model for every published model plus the 16, 64, 256, and 512 GB tiers. Pass one model name for that model only. On-demand is list price. Spot combines spot prices, interruptible prices, and marketplace asking prices. Each class has median_usd_per_gpu_hour, p25_usd_per_gpu_hour, p75_usd_per_gpu_hour, providers, and offers. A model is present only when at least two providers have recent offers. Memory-tier classes use median_usd_per_hour and median_usd_per_gb_hour with p25_usd_per_gb_hour and p75_usd_per_gb_hour. Unknown model: {"error": "not_found", "query", "models": [names]}.

{
  "type": "object",
  "properties": {
    "model": {
      "default": "",
      "type": "string",
      "description": "GPU model name as published, for example H100 SXM. Empty returns every model and the memory tiers."
    },
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List published tokenized assets. Call this to find an asset by ticker, name, category, chain, or issuer before get_asset. Live assets are the galactic.inc screener universe. Announced listings have a launch date and no supply, price, or holders. JSON shape: {"matched", "offset", "limit", "assets": [cards], "upcoming": [cards]}. A card includes id, ticker, display_ticker, name, category, category_label, chains, chain_ids, and status. Figures appear only when their check passed: supply (token supply), price_usd and market_cap_usd (US dollars), holders (address count), top10_share (fraction of supply from 0 to 1), change_1d_percent, change_7d_percent, change_30d_percent, supply_change_30d_percent, volume_30d_usd (US dollars), transfers_30d. Price and market cap require an on-chain price check that passed. Holders require balances that reconcile. Issuer is omitted when the issuer did not resolve. Omitted fields are unpublished, not zero. as_of is the asset's data time in UTC.

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "type": "string",
      "description": "Case-insensitive substring of ticker, display ticker, name, issuer, or id. Empty lists the universe."
    },
    "category": {
      "default": "",
      "type": "string",
      "description": "Category slug or English label, such as gold or Treasuries. Empty means every category. Slugs: gold, treasuries, money-market, private-credit, stocks, commodities, funds, real-estate, deposit-token."
    },
    "chain": {
      "default": "",
      "type": "string",
      "description": "Chain id (ethereum, solana, robinhood, liquid, zksync, and the other published chain ids) or the chain display name. Empty means every chain."
    },
    "issuer": {
      "default": "",
      "type": "string",
      "description": "Case-insensitive substring of the published issuer name."
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Page size from 1 to 200."
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Matches to skip."
    },
    "include_upcoming": {
      "default": true,
      "type": "boolean",
      "description": "When true, announced listings with no on-chain figures are included after the live page."
    },
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Category and chain totals for the published asset universe. Call this for asset counts, pricing coverage, and holder totals. The aggregate market cap is published only when every listed asset has a published on-chain price. Until then market_cap_usd is null, market_cap_withheld is true, every by_category and by_chain row leaves out market_cap_usd, and coverage says how many listed assets are priced. Per-asset market caps from list_assets and get_asset are not affected. When every listed asset is priced, market_cap_usd sums them and each row carries its own market_cap_usd. holders sums only assets with a published holder count. holder_assets is how many assets contributed, so a missing holder count is not treated as zero. Per-chain holder counts include a chain only when that chain published holders. JSON: {"listed_assets", "priced_assets", "market_cap_usd", "market_cap_withheld", "coverage", "holders", "holder_assets", "by_category": [{category, category_label, assets, priced_assets, market_cap_usd, holders, holder_assets}], "by_chain": [{chain_id, chain, assets, priced_assets, market_cap_usd, holders, holder_assets}], "ethereum_block", "ethereum_block_time", "note"}. An asset on more than one chain is counted in each of those chains. holders is omitted on a row that has no published holder counts. Market cap is US dollars. Each asset keeps its own as_of; chain-native assets can differ from the Ethereum block time.

{
  "type": "object",
  "properties": {
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search approved galactic.inc newsroom items. Call this for recent headlines about an asset, an issuer, or a topic. Items that are not approved are omitted. The response has no source URL. JSON: {"matched", "items": [{id, date, category, headline, lede, assets}]}. assets is a list of tickers. date is YYYY-MM-DD. limit defaults to 8.

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "type": "string",
      "description": "Case-insensitive substring of headline, lede, category, or asset ticker. Empty returns the latest approved items."
    },
    "limit": {
      "default": 8,
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Maximum items to return, from 1 to 30."
    },
    "response_format": {
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "description": "markdown (default) is a compact reading form. json is the object described below, with source numbers and omitted fields left out."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}