# Stockly

> Reward your users with fractional stock. The Stockly Partner API.

## Docs

- [List giftable stocks](https://docs.stockly.dev/api-reference/catalog/list-giftable-stocks.md): The catalog of stocks you can give. Only assets with enough on-chain liquidity to fill near fair value are listed. Use `assetSymbol` from here when giving stock.
- [Get a user's portfolio](https://docs.stockly.dev/api-reference/portfolio/get-a-users-portfolio.md): The user's live stock portfolio — current holdings valued at market prices (computed from their on-chain wallet balances). `change` is the return versus cost basis (total USD given for the stock they hold), not a market-window move. Holdings are aggregated by stock symbol. `change` is null when ther…
- [Get a stock award](https://docs.stockly.dev/api-reference/stock-awards/get-a-stock-award.md): Fetches one stock award, including its status and the on-chain transaction once executed. Poll this to track an award from `recorded` to `executed`.
- [Give stock](https://docs.stockly.dev/api-reference/stock-awards/give-stock.md): Gives a user stock by recording a stock award. The award is created with status `recorded`; Stockly then executes the on-chain purchase and delivers the stock to the user's wallet. `idempotencyKey` makes this safe to retry: replaying the same request returns the original award with `idempotentReplay…
- [List stock awards](https://docs.stockly.dev/api-reference/stock-awards/list-stock-awards.md): Lists stock awards (newest first). Optionally filter by user or status.
- [Create a user](https://docs.stockly.dev/api-reference/users/create-a-user.md): Creates a Stockly user and provisions a Solana wallet for them via Privy. At least one of `email` or `externalId` must be provided. Both are unique within your app. All-or-nothing: if wallet provisioning fails, the user is not created.
- [Get a user](https://docs.stockly.dev/api-reference/users/get-a-user.md): Fetches one user and their wallet.
- [List users](https://docs.stockly.dev/api-reference/users/list-users.md): Lists your users (newest first), each with their wallet.
- [Authentication](https://docs.stockly.dev/authentication.md): How to authenticate requests to the Stockly API.
- [Errors](https://docs.stockly.dev/errors.md): Error format and status codes.
- [Idempotency](https://docs.stockly.dev/idempotency.md): Safely retry reward requests without creating duplicates.
- [Introduction](https://docs.stockly.dev/introduction.md): Reward your users with fractional stock, in a few API calls.
- [Quickstart](https://docs.stockly.dev/quickstart.md): Create a user and record your first reward.

## OpenAPI Specs

- [openapi](https://docs.stockly.dev/openapi.json)