@americafirst/cli

Command-line tool for the AmericaFirst token on the XRP Ledger. Check balances, verify reward eligibility, query holder stats, and get live DEX prices — all from your terminal.

Install

npx @americafirst/cli <command> [args]

No installation needed — npx runs it on demand.

Commands

balance <address>

Check AmericaFirst balance for an XRPL wallet.

npx @americafirst/cli balance rEhnqEuh2JTsbov3eebxmU6Q1WqKeCaK6G

Output:

{
  "address": "rEhnqEuh2JTsbov3eebxmU6Q1WqKeCaK6G",
  "activated": true,
  "has_trustline": true,
  "balance": 1450497918.565558,
  "balance_formatted": "1,450,497,918.565558",
  "currency": "AmericaFirst",
  "issuer": "r4GD2HMVKJWhfzvgHcUL6frneuUACAzqwo"
}

eligible <address>

Check if a wallet qualifies for community rewards (1 billion+ threshold).

npx @americafirst/cli eligible rEhnqEuh2JTsbov3eebxmU6Q1WqKeCaK6G

Output:

{
  "address": "rEhnqEuh2JTsbov3eebxmU6Q1WqKeCaK6G",
  "eligible": true,
  "balance": 1450497918.565558,
  "threshold": 1000000000,
  "needed": 0,
  "message": "✅ Eligible for community rewards!"
}

holders

Get total number of AmericaFirst holders (active trustlines).

npx @americafirst/cli holders

Output:

{
  "token": "AmericaFirst",
  "issuer": "r4GD2HMVKJWhfzvgHcUL6frneuUACAzqwo",
  "holders": 303,
  "holders_formatted": "303",
  "timestamp": "2026-04-09T20:08:14.384Z"
}

price

Get live DEX price in XRP and USD.

npx @americafirst/cli price

Output:

{
  "token": "AmericaFirst",
  "price_xrp": 0.00000124,
  "price_xrp_formatted": "0.0000012400",
  "price_usd": null,
  "price_usd_formatted": "N/A",
  "xrp_usd": null,
  "spread_samples": 6,
  "timestamp": "2026-04-09T20:07:49.501Z"
}

Token Info

• Ticker: $AmericaFirst
• Issuer: r4GD2HMVKJWhfzvgHcUL6frneuUACAzqwo
• Network: XRP Ledger (mainnet)
• Reward Threshold: 1,000,000,000 AmericaFirst
• RPC Endpoint: https://rpc.xrplclaw.com (zero rate limits)

Links

• Website: https://americafirstxrp.us
• Telegram: https://t.me/AmericaFirst_XRPL
• XRPScan: https://xrpscan.com/account/r4GD2HMVKJWhfzvgHcUL6frneuUACAzqwo

License

MIT