MoleSwap API Documentation

curl "https://moleswap-eight.vercel.app/api/v1/quote?tokenIn=0x0000000000000000000000000000000000000000&tokenOut=0x2971824Db68229D087931155C2b8bB820B275809&amountIn=1000000000000000000"

curl -X POST "https://moleswap-eight.vercel.app/api/v1/tx/swap" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenIn": "0x0000000000000000000000000000000000000000",
    "tokenOut": "0x2971824Db68229D087931155C2b8bB820B275809",
    "amountIn": "1000000000000000000",
    "recipient": "0xYOUR_WALLET_ADDRESS",
    "slippageBps": 50
  }'

X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1711234627

{
  "success": true,
  "data": { ... },
  "timestamp": 1711234567890
}

# All tokens
curl "https://moleswap-eight.vercel.app/api/v1/tokens"

# Filter by source chain
curl "https://moleswap-eight.vercel.app/api/v1/tokens?chain=Solana"

# Search by symbol
curl "https://moleswap-eight.vercel.app/api/v1/tokens?search=USDC"

curl "https://moleswap-eight.vercel.app/api/v1/pools"

# pETH/WPC pool
curl "https://moleswap-eight.vercel.app/api/v1/pool/0x012d5C099f8AE00009f40824317a18c3A342f622"

# Direct swap: 1 PC → pETH
curl "https://moleswap-eight.vercel.app/api/v1/quote?tokenIn=0x0000000000000000000000000000000000000000&tokenOut=0x2971824Db68229D087931155C2b8bB820B275809&amountIn=1000000000000000000"

# Multi-hop: 0.1 pETH → USDC.eth (routes through WPC automatically)
curl "https://moleswap-eight.vercel.app/api/v1/quote?tokenIn=0x2971824Db68229D087931155C2b8bB820B275809&tokenOut=0x387b9C8Db60E74999aAAC5A2b7825b400F12d68E&amountIn=100000000000000000"

import { ethers } from "ethers";

const MOLESWAP_API = "https://moleswap-eight.vercel.app/api/v1";
const YOUR_TOKEN = "0xYOUR_DEPLOYED_TOKEN_ADDRESS";
const WPC = "0xE17DD2E0509f99E9ee9469Cf6634048Ec5a3ADe9";

// 1. Build create-pool transaction
const res = await fetch(`${MOLESWAP_API}/tx/create-pool`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    tokenA: YOUR_TOKEN,
    tokenB: WPC,
    fee: 500,                               // 0.05% fee tier
    initialPrice: 0.001,                    // 1 token = 0.001 WPC
    amount0Desired: "1000000000000000000000", // 1000 tokens
    amount1Desired: "1000000000000000000",    // 1 WPC
    recipient: wallet.address,
  })
});
const { data } = await res.json();
console.log(data.description); // "Create new pool and seed liquidity"

// 2. Execute each transaction sequentially
const provider = new ethers.JsonRpcProvider("https://evm.donut.rpc.push.org/");
const signer = new ethers.Wallet("YOUR_PRIVATE_KEY", provider);

for (const tx of data.transactions) {
  console.log("→", tx.description);
  const sent = await signer.sendTransaction({
    to: tx.to,
    value: tx.value,
    data: tx.data,
  });
  await sent.wait();
  console.log("  ✅ Confirmed:", sent.hash);
}

// 3. Verify — your token is now quotable!
const quoteRes = await fetch(
  `${MOLESWAP_API}/quote?tokenIn=${YOUR_TOKEN}&tokenOut=${WPC}&amountIn=1000000000000000000`
);
const quote = await quoteRes.json();
console.log("Quote:", quote.data);

npm install @moleswap/sdk

import { MoleSwap } from "@moleswap/sdk";

// Initialize (defaults to production URL)
const mole = new MoleSwap();

// Or with custom URL
const mole = new MoleSwap("https://your-deployment.vercel.app");

// ═══ READ DATA ═══

const { tokens } = await mole.getTokens();
const { pools } = await mole.getPools();
const pool = await mole.getPool("0x012d5C...");

// ═══ GET QUOTES ═══

const quote = await mole.getQuote({
  tokenIn: "0x0000000000000000000000000000000000000000",
  tokenOut: "0x2971824Db68229D087931155C2b8bB820B275809",
  amountIn: "1000000000000000000",
});
// quote.type = "direct" | "multi_hop" | "wrap_unwrap"

// ═══ BUILD TRANSACTIONS ═══

const swap = await mole.buildSwapTx({
  tokenIn: "0x000...000",
  tokenOut: "0x297...809",
  amountIn: "1000000000000000000",
  recipient: "0xYOUR_WALLET",
});
// swap.transactions = [{ to, value, data, description }]

const pool = await mole.buildCreatePoolTx({
  tokenA: "0xYOUR_TOKEN",
  tokenB: "0xE17DD2...DE9",  // WPC
  fee: 500,
  initialPrice: 0.001,
  amount0Desired: "1000000000000000000000",
  amount1Desired: "1000000000000000000",
  recipient: "0xYOUR_WALLET",
});

// ═══ HELPERS ═══

mole.getExplorerUrl("0xTX_HASH");
// → "https://donut.push.network/tx/0xTX_HASH"

{
  "chainId": 42101,
  "chainName": "PushChain Donut Testnet",
  "rpcUrl": "https://evm.donut.rpc.push.org/",
  "explorer": "https://donut.push.network",
  "nativeCurrency": {
    "name": "Push Chain",
    "symbol": "PC",
    "decimals": 18
  }
}