Skip to content

Credits Management

The credits command group allows you to view and manage your Aleph Cloud credits, which can be used to pay for compute resources on the network.

Overall Usage

bash
aleph credits [OPTIONS] COMMAND [ARGS]...

Options

OptionTypeDescription
--helpShow this message and exit

Key Commands

CommandDescription
showDisplay the number of credits for a specific address
historyDisplay the credit transaction history for an address

Show Credits

Display the number of credits for a specific address.

Usage

bash
aleph credits show [OPTIONS] [ADDRESS]

Arguments

ArgumentTypeDescription
ADDRESSTEXTAddress of the wallet you want to check. If not provided, uses your current account

Options

OptionTypeDescription
--private-keyTEXTYour private key. Cannot be used with --private-key-file
--private-key-filePATHPath to your private key file [default: /home/$USER/.aleph-im/private-keys/ethereum.key]
--chain[ARB, AVAX, BASE, BLAST, BOB, BSC, CSDK, CYBER, DOT, ETH, FRAX, INK, LINEA, LISK, METIS, MODE, NEO, NULS, NULS2, OP, POL, SOL, TEZOS, WLD, ZORA]Chain for the address
--json / --no-jsonDisplay output as JSON [default: no-json]
--debug / --no-debugEnable debug logging [default: no-debug]
--helpShow this message and exit
bash
# Show credits for your current account
aleph credits show

# Show credits for a specific address
aleph credits show 0x1234567890abcdef...

# Show credits as JSON output
aleph credits show --json

# Show credits for a specific address with JSON output
aleph credits show 0x1234567890abcdef... --json

Credits History

Display the credit transaction history for an address.

Usage

bash
aleph credits history [OPTIONS] [ADDRESS]

Arguments

ArgumentTypeDescription
ADDRESSTEXTAddress of the wallet you want to check. If not provided, uses your current account

Options

OptionTypeDescription
--private-keyTEXTYour private key. Cannot be used with --private-key-file
--private-key-filePATHPath to your private key file [default: /home/$USER/.aleph-im/private-keys/ethereum.key]
--chain[ARB, AVAX, BASE, BLAST, BOB, BSC, CSDK, CYBER, DOT, ETH, FRAX, INK, LINEA, LISK, METIS, MODE, NEO, NULS, NULS2, OP, POL, SOL, TEZOS, WLD, ZORA]Chain for the address
--page-sizeINTEGERNumber of elements per page [default: 100]
--pageINTEGERCurrent page number [default: 1]
--json / --no-jsonDisplay output as JSON [default: no-json]
--debug / --no-debugEnable debug logging [default: no-debug]
--helpShow this message and exit
bash
# Show credit history for your current account
aleph credits history

# Show credit history for a specific address
aleph credits history 0x1234567890abcdef...

# Show credit history with pagination
aleph credits history --page-size 50 --page 2

# Show credit history as JSON
aleph credits history --json
  • Account Balance - View your ALEPH token balance alongside credits
  • Pricing - View pricing information for services payable with credits