Skip to main content
POST
/
Account
/
close
Close Account
curl --request POST \
  --url https://api.altude.so/api/Account/close \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "signedTransaction": "<string>"
}
'
{
  "status": "Queued",
  "message": "Account close transaction queued successfully.",
  "signature": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d"
}

Documentation Index

Fetch the complete documentation index at: https://docs.altude.so/llms.txt

Use this file to discover all available pages before exploring further.

Close an Associated Token Account (ATA) by submitting a signed transaction.

​
headers

​
X-API-Key
string
required
The API key created from Altude

​
Request Body

​
signedTransaction
string
required
The base64-encoded signed transaction to close the ATA

​
Build signedTransaction (minimum)

Use this right before calling POST /Account/close.
Demo flow only. Never put fee payer private keys in frontend/client code. Keep signer keys on a trusted server-side signer.
import { Connection, Keypair, PublicKey, Transaction } from '@solana/web3.js';
import {
  TOKEN_PROGRAM_ID,
  createCloseAccountInstruction,
  getAccount,
  getAssociatedTokenAddress
} from '@solana/spl-token';

const apiKey = 'your-api-key';
const owner = new PublicKey('OWNER_PUBLIC_KEY');
const mint = new PublicKey('MINT_PUBLIC_KEY');
const feePayerSecret = [/* Solana secret key: array of 64 numbers (0-255) */];

function toBase64(bytes: Uint8Array) {
  let binary = '';
  const chunkSize = 0x8000;
  for (let i = 0; i < bytes.length; i += chunkSize) {
    binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
  }
  return btoa(binary);
}

const cfg = await fetch('https://api.altude.so/api/Transaction/config', {
  headers: { 'X-API-Key': apiKey }
}).then((r) => r.json());

const connection = new Connection(cfg.RpcUrl, 'confirmed');
const feePayer = new PublicKey(cfg.FeePayer);
const ata = await getAssociatedTokenAddress(mint, owner);
const ataAccount = await getAccount(connection, ata);

if (!ataAccount.closeAuthority?.equals(feePayer)) {
  throw new Error('Close authority must match configured fee payer');
}

const tx = new Transaction();
tx.feePayer = feePayer;
tx.add(createCloseAccountInstruction(ata, feePayer, feePayer, [], TOKEN_PROGRAM_ID));
tx.recentBlockhash = (await connection.getLatestBlockhash('finalized')).blockhash;
tx.partialSign(Keypair.fromSecretKey(Uint8Array.from(feePayerSecret)));

const signedTransaction = toBase64(
  tx.serialize({ requireAllSignatures: false })
);

await fetch('https://api.altude.so/api/Account/close', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': apiKey
  },
  body: JSON.stringify({ signedTransaction })
});

​
Response

​
status
string
The current state of the account close request
​
message
string
A message describing the result of queuing the account close transaction
​
signature
string
The transaction signature
{
  "status": "Queued",
  "message": "Account close transaction queued successfully.",
  "signature": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d"
}