Token Layer CLI

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:

Discover candidates with info get-tokens-v2
Inspect recent flow with info get-token-activity or info get-token-trades
Evaluate market structure with info get-token-candles and info get-token-stats
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.

About

Onboarding

Earn

Integrations

API Reference

Install

Quick start

Profiles

Wallets

Authentication

Action commands

Register with wallet signing

Create a token

Trade a token

Transfer a token

Info commands

Agent workflow

Local development in this repo

​Install

​Quick start

​Profiles

​Wallets

​Authentication

​Action commands

​Register with wallet signing

​Create a token

​Trade a token

​Transfer a token

​Info commands

​Agent workflow

​Local development in this repo

Install

Quick start

Profiles

Wallets

Authentication

Action commands

Register with wallet signing

Create a token

Trade a token

Transfer a token

Info commands

Agent workflow

Local development in this repo