pgTerminal Documentation

Overview

pgTerminal is a professional, non-custodial trading terminal built natively for PulseChain. It provides real-time charts, token discovery, one-click trading, cross-chain bridging, and stablecoin swapping — all in a single interface.

Authentication

pgTerminal supports two login methods. Both are fully non-custodial — the terminal never holds your private keys.

Option 1: Connect Wallet (MetaMask / WalletConnect)

The fastest way to get started. Connect any Ethereum-compatible wallet to pgTerminal:

1. Click "Sign In"Tap the Sign In button in the top-right corner.
2. Choose your walletSelect MetaMask, Rabby, or any WalletConnect-compatible wallet (Trust Wallet, Internet Money, etc.).
3. Sign a messageSign a non-transactional message to prove wallet ownership. No gas required.
4. Start tradingYou're connected. All trades are signed directly in your wallet — pgTerminal never has access to your keys.

Option 2: Telegram Login (pgTradingBot users)

If you already use @PulseGuy_Bot, you can log in with your Telegram account and trade directly without MetaMask:

1. Open the botGo to @PulseGuy_Bot on Telegram and type /terminal.
2. Tap "Open pgTerminal"The bot generates a secure, time-limited login link.
3. Auto-loginThe terminal opens and you're automatically authenticated. Your bot wallet is used for all trades.

Trading

pgTerminal provides a full trading interface for any PulseChain token with DEX liquidity.

Buying a Token

1. Find the tokenSearch by name, symbol, or paste the contract address. Browse Top Volume, Trending, Gainers, and more.
2. Open the token pageClick any token to open the live chart and trading panel.
3. Enter your amountUse the preset buttons (1M, 5M, 10M PLS) or enter a custom amount.
4. Click BuyConfirm in your wallet. The trade routes through PulseX for best execution.

Selling a Token

Switch to the Sell tab to sell your position. Enter a percentage (25%, 50%, 100%) or a specific token amount. The terminal automatically fetches your current balance.

Slippage & Gas

Default slippage is 2%. You can adjust this in the trade panel. Gas pricing is automatically optimized for PulseChain — no manual configuration needed.

Supported DEXes

• PulseX V1 & V2 — Primary routing for all token pairs
• 9MM V2 — Alternative routing for better prices on some pairs
• pump.tires — Native bonding curve support for pump.tires tokens

Bridge

The Bridge feature lets you move stablecoins from other chains directly to your PulseChain wallet. Powered by LibertySwap.

Supported Chains

• Ethereum (ETH)
• BNB Chain (BSC)
• Base
• Polygon
• Arbitrum

Supported Assets

USDC, USDT, and DAI on all supported chains. Minimum bridge amount: $10. Maximum: $25,000 per transaction.

How to Bridge

1. Click "Bridge"Open the Bridge modal from the top navigation bar.
2. Select source chain & tokenChoose which chain and stablecoin you're bridging from.
3. Enter amountThe quote updates automatically showing estimated output on PulseChain.
4. Confirm transactionApprove and sign the transaction in your source-chain wallet. Funds arrive on PulseChain within minutes.

Telegram Users

TG login users can bridge server-side using their bot wallet — no MetaMask required. The bridge executes using your bot wallet's funds on the source chain.

Stable Swap

After bridging, use Stable Swap to convert your stablecoins to PLS or any other PulseChain token in one click.

Supported Input Tokens

• USDC — Bridged USD Coin (0x15d38573...)
• eDAI — Bridged DAI (0xefd766cc...)
• USDT — Bridged Tether (0x0cb6f5a3...)
• PLS — Native PulseChain

Supported Output Tokens

By default, you can swap to PULSEGUY or PLS. Paste any PulseChain contract address in the search box to swap to any other token.

How to Swap

1. Click "Stable Swap"Open the Stable Swap modal from the top navigation bar, or click a stablecoin in your portfolio.
2. Select tokens & amountChoose your input and output tokens. The quote auto-updates with live PulseX pricing.
3. Adjust slippageDefault is 2%. Options: 0.5%, 1%, 2%, 5%.
4. Confirm swapSign the transaction(s) in your wallet. Status updates from Submitted → Confirmed.

Stable Swap Fees

Portfolio

The Portfolio view gives you a real-time overview of all your PulseChain holdings.

What's Shown

• Total portfolio value in USD
• PLS balance
• All token positions with current value, 24h change, and P&L
• USDC/eDAI/USDT balances shown separately (bridged stablecoins)

Clicking a Token

Clicking any token in your portfolio opens the trading panel for that token. Clicking a stablecoin (USDC, eDAI, USDT) opens the Stable Swap directly with that token pre-selected as the input.

Hiding Tokens

Click the ✕ next to any token to hide it from your portfolio view. Hidden tokens can be restored from the Settings menu.

P&L Tracking

The terminal tracks your buy and sell history to calculate unrealised P&L for each position. P&L is shown as PLS profit/loss and percentage return.

Charts & Discovery

Token Discovery

Browse PulseChain token markets across multiple views:

• Top Volume — Highest 24h trading volume
• pgTrending — Tokens trending in the pgECO community
• New Pairs — Recently launched tokens
• Gainers / Losers — Top 24h price movers
• Watchlist — Your starred tokens
• Leaderboard — Top traders by volume
• DEX Screener — Integrated DexScreener view
• pump.tires — Native pump.tires bonding curve tokens

Charts

Token charts are powered by GeckoTerminal, providing live OHLCV candles with multiple timeframes. Charts load instantly on any device.

Token Information

Each token page shows: live price, market cap, liquidity, 1h/24h volume, recent trades feed, holder count, and social links.

Fee Structure

pgTerminal charges a 1% fee on all trades and swaps. Fees are automatically split on-chain at the time of execution.

Fee Breakdown

DEX Fees

In addition to the pgTerminal fee, standard DEX swap fees apply (typically 0.3% on PulseX). These are included in the quoted output amount.

Referral System

Earn 0.25% of every trade made by users you refer to pgTerminal.

Your Referral Link

Your referral link format:

Share this link. When someone visits pgTerminal through your link, their wallet is linked to yours. You earn 0.25% of every trade they make — paid out automatically on each transaction.

How Payouts Work

• Referral fees are paid in the same token used for the trade
• Payment happens automatically on-chain at trade execution — no claiming required
• Fees are sent directly to your wallet address
• Referrals are persistent — once a user links your address, you earn on all their future trades

pgTradingBot Referrals

If a user was referred to you through @PulseGuy_Bot, that referral relationship automatically carries over to pgTerminal. Both the bot and terminal use the same referral system.

Security Model

pgTerminal is built with security as a priority. Here's exactly how your assets are protected.

Non-Custodial by Design

pgTerminal never stores, transmits, or has access to your private keys when using MetaMask or WalletConnect. All transaction signing happens locally in your wallet — the terminal only builds and submits the transaction request.

Telegram Login Security

For Telegram login users, wallets are encrypted using AES-256-GCM with keys derived from a combination of your Telegram ID and a server-side master secret. Your private key is:

• Never stored in plaintext
• Never logged or transmitted
• Decrypted only at the moment of trade execution
• Immediately discarded from memory after use

Session Security

• Authentication sessions use signed JWT tokens (15-minute access + 7-day refresh)
• Optional Trade PIN — require a 4-digit PIN before every trade
• All API endpoints use rate limiting to prevent abuse
• HTTPS-only with modern TLS (1.2/1.3)
• Security headers: CSP, X-Frame-Options, X-Content-Type-Options

Smart Contract Security

Trades route through the pgTerminal TradeRouter contract (0x4Fe2385983C0022594Ef356eF1A3aA74e1B81929), which has been audited and handles fee distribution on-chain. Token approvals are requested with MaxUint256 allowances to minimize the number of approval transactions required.

Open Source

pgTerminal's code is available on GitHub for community review.

FAQ

Is pgTerminal free to use?

pgTerminal is free to access. A 1% trading fee applies on swaps, split between the protocol, referrers, and a PULSEGUY buy/burn.

Which chains are supported?

pgTerminal is built natively for PulseChain. The Bridge feature supports ETH, BSC, Base, Polygon, and Arbitrum as source chains for stablecoins.

Do I need a pgTradingBot account?

No. You can connect any MetaMask or WalletConnect wallet directly. A pgTradingBot account is optional — it enables server-side trading without MetaMask.

What happens if a transaction fails?

If a transaction reverts on-chain, no assets are lost. Gas fees for the failed transaction may apply. The terminal will show an error message with a link to check the transaction on PulseScan.

How do I report an issue?

Join the support channel: @justapulseguy on Telegram.

Is the terminal available on mobile?

Yes. pgTerminal is fully responsive and optimized for mobile browsers. WalletConnect supports mobile wallets including Trust Wallet and Internet Money Wallet.

What is PULSEGUY?

PULSEGUY (0x67922d590ba6c784f468b6b562d201113a8fbd2d) is the native token of the pgECO ecosystem. 0.25% of every terminal trade is used to buy and permanently burn PULSEGUY on-chain.