# Market info (/scripting-v2/sources/info)



The `info` source requires Market Lab **0.1.134** or later.

Use a literal selector such as `btc@info@bulkf` or `btc@info@hyperliquidf` to start a feed when the job launches. For Ascend and Montra, use the market from a launch event with `ctx.subscribe`. An existing token can also use a literal selector such as `<token-address>@info@ascend`.

```python
SOURCE = "btc@info@bulkf"
script = {"name": "btc-info", "version": "2"}


def on_data(ctx, history):
    info = history.source(SOURCE, 0)
    if info is not None:
        return {"metrics": {
            "mark": info["mark_price"],
            "funding": info["funding_rate"],
        }}
```

The first update contains the latest indexed record when one is available. Each subsequent update enters history and calls `on_data`. An empty feed returns `None` from `history.source(feed, 0)`. Check `updated_at` before relying on a retained record. Info feeds are live only.

## Perpetuals [#perpetuals]

| Fields                                      | Meaning                                                      |
| ------------------------------------------- | ------------------------------------------------------------ |
| `kind`, `exchange`, `market`                | `kind` is `"perp"`.                                          |
| `base_symbol`, `quote_symbol`               | Units used by price, volume and open interest.               |
| `updated_at`, `last_price_at`               | Stats and last-price observation times in Unix milliseconds. |
| `last_price`, `index_price`, `mark_price`   | Distinct price observations in quote units per base unit.    |
| `open_interest_base`, `open_interest_quote` | Base size and its value at the mark.                         |
| `funding_rate`, `funding_interval_sec`      | Decimal rate for the stated period.                          |
| `volume_24h_base`, `volume_24h_quote`       | Rolling 24-hour volumes in the stated units.                 |

## Launchpad tokens [#launchpad-tokens]

| Fields                                   | Meaning                                                                       |
| ---------------------------------------- | ----------------------------------------------------------------------------- |
| `kind`, `exchange`, `market`, `symbol`   | `kind` is `"token"`. Use `market` as the identifier.                          |
| `quote`, `quote_symbol`                  | Quote asset address and symbol.                                               |
| `created_at`, `updated_at`               | Launch and stats times in Unix milliseconds.                                  |
| `price`                                  | Pool price in quote units per token. Use the trades feed for executed prices. |
| `market_cap_quote`, `market_cap_usd`     | Supply valuation in quote or USD units.                                       |
| `liquidity_quote`                        | Indexed pool value in quote units.                                            |
| `volume_24h_quote`, `volume_24h_usd`     | Rolling 24-hour volume in quote or USD units.                                 |
| `holders`                                | Indexed holder count.                                                         |
| `dev_bought`, `dev_sold`, `dev_holdings` | Launch buy, observed creator sale, and creator balance in base-token units.   |

Unavailable statistics are `None`. Ascend can report creator sales and holdings when its launch tracking covers them. Montra supplies holders and launch-buy data through its catalog where available. Creator sales and holdings may remain unknown. Prices and quote-denominated fields can be in HYPE, WHYPE, or another quote asset. Check `quote_symbol` before comparing markets.

## Subscribe during a run [#subscribe-during-a-run]

`ctx.subscribe` returns a feed handle immediately. Pass it to `history.source` to read retained records. The same handle identifies future `on_data` updates.

```python
LAUNCHES = "launches@montra"
script = {"name": "watch-launch-info", "version": "2"}
feed = None


def on_data(ctx, history):
    global feed
    if ctx.source == LAUNCHES:
        launch = history.source(LAUNCHES, 0)
        if launch is None:
            return
        if feed is not None:
            ctx.unsubscribe(feed)
        feed = ctx.subscribe({
            "exchange": launch["exchange"],
            "market": launch["market"],
            "stream": "info",
        })
        return

    if ctx.source == feed:
        info = history.source(feed, 0)
        if info is not None:
            return {"metrics": {
                "event": "market_info",
                "exchange": info["exchange"],
                "market": info["market"],
                "symbol": info["symbol"],
                "quote": info["quote_symbol"],
                "holders": info["holders"],
                "dev_bought": info["dev_bought"],
                "dev_sold": info["dev_sold"],
                "market_cap_quote": info["market_cap_quote"],
                "market_cap_usd": info["market_cap_usd"],
                "liquidity_quote": info["liquidity_quote"],
            }}
```

The script logs these `metrics` for `ser`, using the same `market` from its launch. In this output, `quote` is the display symbol copied from the info record's `quote_symbol`. Each unavailable value is `None` in Python and `null` in JSON. [See the original launch record](/scripting-v2/sources/launches).

```json
{
  "event": "market_info",
  "exchange": "montra",
  "symbol": "ser",
  "market": "99901:0xa3c935b0fdc1ff9453a2a0814e7d9fa7d05d1348",
  "quote": "HYPE",
  "holders": null,
  "dev_bought": null,
  "dev_sold": null,
  "market_cap_quote": null,
  "market_cap_usd": null,
  "liquidity_quote": null
}
```

Use `stream: "trades"` for new executions or `stream: "candles"` with a `timeframe` in seconds. Dynamic trades and candles support indexed BULK and Hyperliquid perps, Ascend and Montra token addresses, and Nest pool addresses. Dynamic candles aggregate new trades from when the feed connects. Keep a literal source for the job's first event. Each job can open up to 16 dynamic feeds. An identical subscription returns the same handle. Unsubscribe when finished to release the slot and discard that feed's history. Startup feeds stay active. Dynamic subscriptions grant read access only.
