Skip to main content
The Token Layer CLI provides a deterministic command surface for agents, scripts, and operators that need Token Layer actions and info reads without writing custom client code first.

​
Install

From this monorepo: 
cd packages/token-layer-cli
cargo install --path .
This installs both tokenlayer and token-layer.

​
Quick start

Initialize a profile: 
tokenlayer init
Or create a local wallet profile without the interactive wizard: 
tokenlayer init --quick-wallet --name default

​
Profiles

Profiles let one machine manage multiple auth contexts for different agents or operators. 
tokenlayer profile list
tokenlayer profile use --name default
tokenlayer --profile default info me
Profile storage:
  • ~/.token-layer-cli/profiles.json
  • $TL_CLI_HOME/profiles.json

​
Wallets

The CLI can generate and store local Ethereum and Solana wallets. 
tokenlayer wallet add --chain ethereum --name bot-1-eth
tokenlayer wallet add --chain solana --name bot-1-sol
tokenlayer wallet list
Wallet storage:
  • ~/.token-layer-cli/wallets.json
  • $TL_CLI_HOME/wallets.json
These files include private keys. Treat them as secrets.

​
Authentication

Three main auth paths are supported:
  • profile-based auth from tokenlayer init
  • direct flags such as --jwt, --api-key, and --token
  • environment variables such as TL_JWT, TL_API_KEY, and TL_PROFILE
You can also select the API environment with:
  • --source mainnet
  • --source testnet

​
Action commands

​
Register with wallet signing

tokenlayer action register \
  --wallet-name default-eth \
  --signature-chain-id 0x1

​
Create a token

tokenlayer action create-token \
  --name "Agent Token" \
  --symbol AGNT \
  --description "Autonomous launch" \
  --image "https://example.com/logo.png" \
  --chain-slug base

​
Trade a token

tokenlayer action trade-token \
  --token-id <TOKEN_UUID> \
  --chain-slug base \
  --direction buy \
  --buy-amount-usd 1

​
Transfer a token

tokenlayer action transfer-token \
  --token-id <TOKEN_UUID> \
  --recipient-address 0x000000000000000000000000000000000000dEaD \
  --amount 0.1 \
  --from-chain-slug base \
  --to-chain-slug base

​
Info commands

tokenlayer info get-tokens-v2 --order-by volume_24h --limit 20
tokenlayer info get-token-activity --token-id <TOKEN_ID_OR_ADDRESS> --limit 20
tokenlayer info get-token-candles --token-id <TOKEN_ID_OR_ADDRESS> --candle-interval 1h --limit 200
tokenlayer info get-token-stats --token-id <TOKEN_ID_OR_ADDRESS>
tokenlayer info me

​
Agent workflow

For autonomous systems, the common loop is:
  1. Discover candidates with info get-tokens-v2
  2. Inspect recent flow with info get-token-activity or info get-token-trades
  3. Evaluate market structure with info get-token-candles and info get-token-stats
  4. Execute with action trade-token or action transfer-token

​
Local development in this repo

cd packages/token-layer-cli
cargo run -- --help
The package source lives in packages/token-layer-cli, and the CLI targets the same Token Layer HTTP API documented in this site.