---
title: "List Solana Nonce Accounts"
method: GET
path: "/api/v1/vaults/{id}/solana-nonce-accounts"
tags: ["Vaults"]
---

# List Solana Nonce Accounts

`GET /api/v1/vaults/{id}/solana-nonce-accounts`

## Request

- Base URL: `https://api.fordefi.com`
- URL: `https://api.fordefi.com/api/v1/vaults/{id}/solana-nonce-accounts`
- Auth: HTTP bearer

List a vault's Solana durable-nonce accounts with the pool counts by state.

A reserved account carries the id of the transaction holding it and the nonce value that transaction was
built against.

## Path parameters

- `id` string, uuid, required: ID of the vault.

## Query parameters

- `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required

## Response `200`

Successful Response

- ListSolanaNonceAccountsResponse
  - `counts` SolanaNonceAccountCounts, required
    - `creating` integer, required: Nonce accounts whose creation transaction is still pending.
    - `free` integer, required: Nonce accounts available for the next durable-nonce transaction.
    - `reserved` integer, required: Nonce accounts currently held by a transaction.
    - `retired` integer, required: Nonce accounts that are no longer usable.
  - `nonce_accounts` SolanaNonceAccount[], required: The nonce accounts, oldest first; accounts created together are ordered by id.
    - `id` string, uuid, required: The ID of the nonce account.
    - `created_at` string, date-time, required: When the nonce account was added to the pool.
    - `modified_at` string, date-time, required: When the nonce account last changed state.
    - `vault_id` string, uuid, required: The vault that owns the nonce account.
    - `chain` SolanaChain, required
      - `chain_type` 'solana', required: The type of the chain.
      - `unique_id` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required
    - `address` string, required: The on-chain address of the nonce account.
    - `state` 'creating' | 'free' | 'reserved' | 'retired', required
    - `created_by_transaction_id` string, uuid, required: The transaction that created the nonce account.
    - `reserved_by_transaction_id` string, uuid: The transaction currently holding the nonce account, when it is reserved.
    - `reserved_value` string: The nonce value the holding transaction was built against, when it is reserved.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized User
- `403`: Forbidden User
- `404`: Not Found
- `408`: Request Timeout
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Unexpected Error

## Changes

- **2026-10-21** `79801878de89`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fordefi/apis/fordefi-api/changes/api/v1/vaults/:id/solana-nonce-accounts/get.md)

---

[API](https://skmtc.dev/fordefi/apis/fordefi-api.md) - [All operations](https://skmtc.dev/fordefi/apis/fordefi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fordefi/apis/fordefi-api/revisions/6072439d9e20?raw)