> For the complete documentation index, see [llms.txt](https://stradr.gitbook.io/untitled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stradr.gitbook.io/untitled/order-endpoints/post-buy-orders.md).

# \[POST] Buy Orders

Buying shares of a stock using the Stradr API

Shares of a stock can be purchased by posting to the `/buy` endpoint

| Parameter | Description                                                               | Accepted arguments                                                                                                                                 |
| --------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ticker    | The ticker of the asset being purchased                                   | Any public ticker on most United States stock exchanges.                                                                                           |
| Type      | Shares or dollars used in purchase (ie. 10 shares of AAPL or $10 of AAPL) | "shares", "dollars"                                                                                                                                |
| Time      | Time to execute the order                                                 | "now", "marketclose", "marketopen"                                                                                                                 |
| Number    | Number of shares or dollar amount of asset being purchased                | Any finite number 0.0001 to 1,000,000,000.  Note that if the type is specified as dollars this number cannot contain more than two decimal places. |

#### Base request:

```http
POST https://stradr.com/api/buy?key=YOUR_KEY_HERE&time=now&type=shares&number=5
```