bitburner-src/markdown/bitburner.tix.buy.md

<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [TIX](./bitburner.tix.md) &gt; [buy](./bitburner.tix.buy.md)

## 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.

<b>Signature:</b>

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

## Parameters

|  Parameter | Type | Description |
|  --- | --- | --- |
|  sym | [StockSymbol](./bitburner.stocksymbol.md) | Stock symbol. |
|  shares | number | Number of shares to purchased. Must be positive. Will be rounded to nearest integer. |

<b>Returns:</b>

number

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

## Remarks

RAM cost: 2.5 GB