Skip to main content
POST
/
Account
/
create
Create Account
curl --request POST \
  --url https://api.altude.so/api/Account/create \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "signedTransaction": "<string>"
}
'
{
  "status": "Queued",
  "message": "Account creation transaction queued successfully.",
  "signature": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d"
}
Create a new Solana account 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 create the account

​
Build signedTransaction (minimum)

Use this right before calling POST /Account/create.
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 {
  AuthorityType,
  TOKEN_PROGRAM_ID,
  createAssociatedTokenAccountInstruction,
  createSetAuthorityInstruction,
  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 tx = new Transaction();
tx.feePayer = feePayer;
tx.add(createAssociatedTokenAccountInstruction(feePayer, ata, owner, mint));
tx.add(
  createSetAuthorityInstruction(
    ata,
    owner,
    AuthorityType.CloseAccount,
    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/create', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': apiKey
  },
  body: JSON.stringify({ signedTransaction })
});

​
Response

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