bitburner-src/markdown/bitburner.tix.buy.md
Olivier Gagnon feb0430aff work on doc
2021-10-30 15:46:34 -04:00

1.1 KiB

Home > bitburner > TIX > buy

TIX.buy() method

Attempts to purchase shares of a stock using a Market Order.

If the player does not have enough money to purchase the specified number of shares, then no shares will be purchased. Remember that every transaction on the stock exchange costs a certain commission fee.

If this function successfully purchases the shares, it will return the stock price at which each share was purchased. Otherwise, it will return 0.

Signature:

buy(sym: StockSymbol, shares: number): number;

Parameters

Parameter Type Description
sym StockSymbol Stock symbol.
shares number Number of shares to purchased. Must be positive. Will be rounded to nearest integer.

Returns:

number

The stock price at which each share was purchased, otherwise 0 if the shares weren't purchased.

Remarks

RAM cost: 2.5 GB