# Coinstash API

> The Coinstash GraphQL API gives you programmatic access to the platform — market data, quotes, your accounts and balances, orders, deposits and withdrawals.

All operations are GraphQL, sent as `POST https://graph.coinstash.com.au/graphql`. Most need a Bearer token from the
API Keys section of https://coinstash.com.au/dashboard/account-settings; coin, chain and bundle
catalogue operations are public. Each link below is a self-contained Markdown page with the
operation's arguments, a working example query, and the types it returns.

## Coin and market data

- [listCoins](https://docs.coinstash.com.au/md/listCoins.md): Lists coins with live market data (price, market cap, 24h/7d/30d change, and volume) in the target currency (AUD).
- [getCoin](https://docs.coinstash.com.au/md/getCoin.md): Retrieves a single coin's full profile by its unique identifier.
- [getCoinBySymbol](https://docs.coinstash.com.au/md/getCoinBySymbol.md): Retrieves a single coin's full profile by its trading symbol (for example, BTC).
- [listChains](https://docs.coinstash.com.au/md/listChains.md): Lists the blockchains and networks Coinstash supports, each with its native fee token, preferred stablecoin, block explorer link, and typical withdrawal time.
- [getChain](https://docs.coinstash.com.au/md/getChain.md): Retrieves the details of a single supported blockchain by its identifier.
- [getLast](https://docs.coinstash.com.au/md/getLast.md): Get the latest quote

## Bundles

- [listBundles](https://docs.coinstash.com.au/md/listBundles.md): Lists bundles, with optional filtering by coin symbol, category, or keyword search.
- [listCategories](https://docs.coinstash.com.au/md/listCategories.md): Lists the distinct categories across all tradable coins, for use as filter values on the coin listing.
- [getBundle](https://docs.coinstash.com.au/md/getBundle.md): Retrieves a single bundle by its id, including its coins, allocations, image, and the minimum amount needed to buy it.
- [getBundleBySlug](https://docs.coinstash.com.au/md/getBundleBySlug.md): Retrieves a single bundle by its URL-friendly slug, returning the same details as fetching it by id.
- [buyBundle](https://docs.coinstash.com.au/md/buyBundle.md): Buys a curated bundle of coins in a single order, splitting the amount you spend across each coin in the bundle according to its target allocation.

## Accounts and transactions

- [getUserAccounts](https://docs.coinstash.com.au/md/getUserAccounts.md): Lists all accounts belonging to a user, such as their trading and savings accounts, each with its profile.
- [getAccountInfo](https://docs.coinstash.com.au/md/getAccountInfo.md): Returns the profile for a single account: its type, verification tier, loyalty membership tier, and whether it has ever traded or deposited.
- [accountBalances](https://docs.coinstash.com.au/md/accountBalances.md): Returns the balances currently held in an account, broken down by coin and by fiat currency, including any reward balances.
- [accountTransactions](https://docs.coinstash.com.au/md/accountTransactions.md): Searches an account's individual transactions — trades, deposits, withdrawals, transfers and rewards — with paging, sorting and optional filters by type, category, coin and date range.
- [accountOrders](https://docs.coinstash.com.au/md/accountOrders.md): Searches an account's orders, where each order groups its underlying transactions, with paging, sorting and optional filters by type, category, coin, status and date range.
- [getAccountOrder](https://docs.coinstash.com.au/md/getAccountOrder.md): Returns a single order together with all the transactions that make it up.
- [getActivity](https://docs.coinstash.com.au/md/getActivity.md): Returns the full details of a single account activity by its ID.

## Trading

- [trade](https://docs.coinstash.com.au/md/trade.md): Executes a buy or sell using a quote you obtained from get-quote.
- [getTradeQuote](https://docs.coinstash.com.au/md/getTradeQuote.md): Returns a price quote for buying or selling a single coin, including the amount you would receive, the fee and any rewards earned.
- [getSwapQuote](https://docs.coinstash.com.au/md/getSwapQuote.md): Returns a price quote for swapping one coin directly into another, including the amount of the target coin you would receive, the combined fee and when the quote expires.
- [swapRFQ](https://docs.coinstash.com.au/md/swapRFQ.md): Executes a coin-to-coin swap using a quote you obtained from get-swap-quote.

## Limit orders

- [createLimitOrder](https://docs.coinstash.com.au/md/createLimitOrder.md): Places a new limit order on a trading account: buy or sell a coin automatically once its price reaches a level you set, or create a price alert that only notifies you.
- [updateLimitOrder](https://docs.coinstash.com.au/md/updateLimitOrder.md): Changes the trigger price and/or expiry of a pending limit order on the account.
- [cancelLimitOrder](https://docs.coinstash.com.au/md/cancelLimitOrder.md): Cancels a pending limit order or price alert on the account.
- [getLimitOrder](https://docs.coinstash.com.au/md/getLimitOrder.md): Returns the full details of a single limit order or price alert on the account by its order ID.
- [searchLimitOrders](https://docs.coinstash.com.au/md/searchLimitOrders.md): Returns a paginated list of the account's limit orders and price alerts, newest first.

## DeFi trading

- [estimateDefiTrade](https://docs.coinstash.com.au/md/estimateDefiTrade.md): Quotes a buy or sell of a coin against the customer's local currency at the best available price.
- [executeDefiTrade](https://docs.coinstash.com.au/md/executeDefiTrade.md): Completes a DeFi trade once the coins you sent have arrived on-chain, converting that incoming transfer into a settled buy or sell order on your account.
- [getDefiOrder](https://docs.coinstash.com.au/md/getDefiOrder.md): Get the status and details of one of your DeFi orders by its identifier.

## Deposits and withdrawals

- [getAssetDepositAddress](https://docs.coinstash.com.au/md/getAssetDepositAddress.md): Returns the customer's deposit address for an asset so they can fund their Coinstash account.
- [listAssetAddresses](https://docs.coinstash.com.au/md/listAssetAddresses.md): Lists the withdrawal addresses saved in the customer's address book, one page at a time.
- [createAssetAddress](https://docs.coinstash.com.au/md/createAssetAddress.md): Saves a crypto address to the customer's address book so you can send withdrawals to it later.
- [deleteAssetAddress](https://docs.coinstash.com.au/md/deleteAssetAddress.md): Permanently removes a saved withdrawal address from the customer's address book.
- [withdrawAsset](https://docs.coinstash.com.au/md/withdrawAsset.md): Withdraws a crypto asset from a trading account to an external wallet address.
- [getFiatDepositAddress](https://docs.coinstash.com.au/md/getFiatDepositAddress.md): Returns the customer's personal Australian bank-transfer details (BSB, account number and PayID) for adding funds to their Coinstash balance.
- [listFiatAddresses](https://docs.coinstash.com.au/md/listFiatAddresses.md): Returns the customer's saved bank-account withdrawal destinations, sorted by label.
- [withdrawFiat](https://docs.coinstash.com.au/md/withdrawFiat.md): Withdraws fiat (AUD) from a trading account to a nominated bank account.

## Portfolio and statements

- [getPortfolio](https://docs.coinstash.com.au/md/getPortfolio.md): Get a summary of your reward balances, totalled in AUD.
- [getPortfolioBalances](https://docs.coinstash.com.au/md/getPortfolioBalances.md): Get your current holdings across all accounts, broken down by coin and by fiat currency.
- [getPortfolioChart](https://docs.coinstash.com.au/md/getPortfolioChart.md): Get your total portfolio value over time as a series of daily data points, ready to plot on a chart.
- [searchStatement](https://docs.coinstash.com.au/md/searchStatement.md): Returns a paginated list of an account's daily portfolio-value statements, ordered oldest first.

## Reports

- [createReport](https://docs.coinstash.com.au/md/createReport.md): Generates a new report (for example a transaction history or end-of-financial-year tax report) for your account.
- [getReport](https://docs.coinstash.com.au/md/getReport.md): Downloads a single previously generated report as a file, identified by its report id.
- [listReports](https://docs.coinstash.com.au/md/listReports.md): Lists the reports that have been generated for your account, with optional filtering by report type and paging.
- [getReportsArchive](https://docs.coinstash.com.au/md/getReportsArchive.md): Downloads all of your reports for a given financial year as a single archive file.

## Profile

- [userProfile](https://docs.coinstash.com.au/md/userProfile.md): Returns the profile of the authenticated user — identity, contact details, verification status, membership tier, and linked sign-in providers.

## Optional

- [Full reference in one file](https://docs.coinstash.com.au/llms-full.txt): every operation and type above, in a single Markdown document