$ ponshub --help

PonsHub API Reference

PonsHub is a terminal-first interface for deploying ERC-20 tokens on Robinhood Chain via the Pons protocol ↗. Under the hood, PonsHub calls the official Pons v4 deploy API and wraps it with a clean terminal UI, real-time preview, and holder analytics.

Base URL: https://www.ponsfamily.com/api — PonsHub proxies to this endpoint. You can also call the Pons API directly with your API key.

Pons tokens are deployed as ERC-20 contracts with automatic Uniswap V3 liquidity pairing (WETH or USDC). Creator fees are built in — you earn a percentage of all trading fees generated by your token's pool.

Authentication

All deploy requests require an API key issued by Pons (per-partner). For free deploys via PonsHub's UI, authentication is handled via wallet connect. For direct API calls, include your key as a header:

http

x-api-key: YOUR_API_KEY

Note: To get a partner API key, apply at ponsfamily.com ↗. Free users can deploy via PonsHub's browser UI without an API key.

Quickstart

Deploy your first token in under 60 seconds using fetch:

javascript

// Deploy a token via Pons API v4
const response = await fetch('https://www.ponsfamily.com/api/tokens/deploy/v4', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    name: 'MyToken',
    symbol: 'MYTKN',
    image: 'https://your-image-url.com/logo.png', // optional
    requestorAddress: '0xYourWalletAddress',
    // optional extensions:
    airdrop: {
      recipients: [{ address: '0xabc...', amount: '1000000' }]
    }
  })
});

const token = await response.json();
console.log('Deployed at:', token.contractAddress);

Or with curl:

bash

curl -X POST https://www.ponsfamily.com/api/tokens/deploy/v4 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "MyToken",
    "symbol": "MYTKN",
    "requestorAddress": "0xYourWalletAddress"
  }'

POST /tokens/deploy/v4

Deploy a new ERC-20 token on Robinhood Chain via the Pons v4 factory contract. This is the primary endpoint.

POST https://www.ponsfamily.com/api/tokens/deploy/v4

Parameter	Type	Required	Description
name	string	required	Full token name (e.g. "My Token"). Max 32 chars.
symbol	string	required	Token ticker symbol, uppercase (e.g. "MYTKN"). Max 12 chars.
requestorAddress	string	required	EVM wallet address of the token creator. Will receive creator fees.
image	string (url)	optional	Public URL to the token's logo image (PNG/JPG, min 200×200px).
description	string	optional	Short description of the token. Max 200 chars.
socialId	string	optional	Social platform user ID of the creator. Enables social attribution.
airdrop	object	optional	Airdrop extension config. See Airdrop guide.
vault	object	optional	Vault/vesting config. See Vault guide.

Response

json

{
  "contractAddress": "0x7f3a...9b21",
  "name": "MyToken",
  "symbol": "MYTKN",
  "deployer": "0xYourWalletAddress",
  "chain": "Robinhood Chain",
  "txHash": "0xabc...def",
  "poolAddress": "0x111...222",
  "createdAt": "2026-05-24T16:00:00Z"
}

GET /tokens/:contractAddress

Fetch metadata and live market data for a deployed Pons token.

GET https://www.ponsfamily.com/api/tokens/:contractAddress

bash

curl https://www.ponsfamily.com/api/tokens/0x7f3a...9b21 \
  -H "x-api-key: YOUR_API_KEY"

Social Integration

Pass your social platform user ID (socialId) to attribute the deploy to your account. This unlocks social discovery and links the token to your profile.

javascript

// Get your social ID from your platform profile
const mySocialId = 'user_12345';

const res = await fetch('https://www.ponsfamily.com/api/tokens/deploy/v4', {
  method: 'POST',
  headers: { 'x-api-key': 'KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'SocialToken',
    symbol: 'STKN',
    requestorAddress: '0xYours',
    socialId: mySocialId,   // ← your social platform ID
  })
});

Tip: You can find your social ID from your platform profile settings or via the platform's developer API.

Vault & Vesting

Lock a portion of the token supply with a time-based vesting schedule using the vault extension.

javascript

{
  "name": "MyToken",
  "symbol": "MYTKN",
  "requestorAddress": "0xYours",
  "vault": {
    "percentage": 15,         // % of supply to lock
    "durationSeconds": 31536000 // 12 months
  }
}

Airdrop Extension

Distribute tokens to specific wallets at deploy time using the airdrop extension.

javascript

{
  "name": "MyToken",
  "symbol": "MYTKN",
  "requestorAddress": "0xYours",
  "airdrop": {
    "recipients": [
      { "address": "0xAlice...", "amount": "1000000" },
      { "address": "0xBob...",   "amount": "500000"  }
    ]
  }
}

Error Codes

Code	Meaning	Fix
400	Bad Request	Missing or invalid parameters. Check `name`, `symbol`, `requestorAddress`.
401	Unauthorized	Missing or invalid `x-api-key`.
429	Rate Limited	Too many requests. Reduce frequency or upgrade to Holder tier.
500	Server Error	Pons network issue. Retry with exponential backoff.