# Nxos

> Nxos API documentation — programmatic access to fiat and crypto accounts, quotes, beneficiaries, and payouts.

## Docs

- [Get account](https://docs.nxos.io/api-reference/accounts/get.md): Retrieve a single account by ID, including its current balances and attached funding methods. Balances are fetched from the ledger in real time.
- [List accounts](https://docs.nxos.io/api-reference/accounts/list.md): List all active accounts belonging to your organization, including their attached funding methods. Results are ordered by creation date, newest first.
- [Archive beneficiary](https://docs.nxos.io/api-reference/beneficiaries/archive.md): Archive (soft-delete) a beneficiary. The record is preserved for audit purposes.
- [Create bank beneficiary](https://docs.nxos.io/api-reference/beneficiaries/create-bank.md): Create a bank beneficiary for an account.
- [Create crypto beneficiary](https://docs.nxos.io/api-reference/beneficiaries/create-crypto.md): Create a crypto beneficiary for an account.
- [Get beneficiary](https://docs.nxos.io/api-reference/beneficiaries/get.md): Retrieve a beneficiary by its identifier. The beneficiary type is resolved automatically.
- [List beneficiaries](https://docs.nxos.io/api-reference/beneficiaries/list.md): List beneficiaries for an account, optionally filtered by type. Returns crypto and bank beneficiaries in a single flat list.
- [Update beneficiary](https://docs.nxos.io/api-reference/beneficiaries/update.md): Update a beneficiary's details.
- [Execute crypto payout](https://docs.nxos.io/api-reference/crypto-payouts/execute.md): Execute a crypto payout from an account to a crypto beneficiary. Funds are debited immediately and the on-chain transaction is broadcast synchronously — the response carries the tx hash. Chain confirmation is asynchronous: the returned `status` is `LOCKED`; clients should poll `GET /v1/transactions/…
- [Initiate fiat payout](https://docs.nxos.io/api-reference/fiat-payouts/initiate.md): Initiate a fiat payout from an account to a bank beneficiary. Funds are debited and locked immediately. The transaction enters LOCKED status and awaits provider execution.
- [Get a funding method](https://docs.nxos.io/api-reference/funding-methods/get.md): Retrieve a single funding method by ID.
- [List funding methods](https://docs.nxos.io/api-reference/funding-methods/list.md): List funding methods for an account, with full deposit details (crypto address + wire instructions) for each.
- [API reference](https://docs.nxos.io/api-reference/introduction.md): Complete reference for all Nxos API endpoints.
- [Create quote](https://docs.nxos.io/api-reference/quotes/create.md): Create an exchange quote between two assets. Specify either `fromAmount` (how much to sell) or `toAmount` (how much to receive), not both. Quotes expire after 5 minutes.
- [Execute quote](https://docs.nxos.io/api-reference/quotes/execute.md): Execute a pending quote. The quote must not be expired or already executed. On success, the trade is completed atomically and the balances are updated.
- [Get quote](https://docs.nxos.io/api-reference/quotes/get.md): Retrieve a quote by its identifier.
- [Get a transaction](https://docs.nxos.io/api-reference/transactions/get.md): Retrieve a single transaction by ID. Returns 404 if the transaction doesn't exist or isn't on one of your accounts.
- [List transactions](https://docs.nxos.io/api-reference/transactions/list.md): List transactions across one or more of your accounts.
- [Accounts](https://docs.nxos.io/concepts/accounts.md): Accounts hold balances and serve as the source for all transactions.
- [Assets and amounts](https://docs.nxos.io/concepts/assets-and-amounts.md): How the API represents currencies, amounts, and precision.
- [Authentication](https://docs.nxos.io/concepts/authentication.md): API key management and request authentication.
- [Beneficiaries](https://docs.nxos.io/concepts/beneficiaries.md): Recipients for payouts — crypto wallets and bank accounts.
- [Conventions](https://docs.nxos.io/concepts/conventions.md): Amounts, pagination, timestamps, and other API-wide patterns.
- [Errors](https://docs.nxos.io/concepts/errors.md): Error response format and error codes.
- [Idempotency and rate limits](https://docs.nxos.io/concepts/idempotency-and-rate-limits.md): Safe retries with the Idempotency-Key header, and the per-organization request quota.
- [Offramp: crypto to fiat](https://docs.nxos.io/guides/offramp.md): Receive crypto, convert to fiat currency, and pay out to a bank account.
- [Onramp: fiat to crypto](https://docs.nxos.io/guides/onramp.md): Accept fiat currency, convert to a stablecoin, and send it on-chain.
- [Nxos API documentation](https://docs.nxos.io/index.md): Programmatic access to accounts, quotes, trades, and payouts.

## OpenAPI Specs

- [openapi](https://docs.nxos.io/openapi.yaml)