Conway Liquid Docs

Conway Liquid is a REST API and web interface for deploying ERC-20 tokens on Base via Liquid Protocol. Every token gets a Uniswap V4 pool with permanently locked liquidity. LP trading fees split 80% to your wallet and 20% to the platform — forever, automatically.

BASE URL
https://liquidconway.xyz
CHAIN
Base · ID 8453
PROTOCOL
Liquid Protocol · Uniswap V4
SUPPLY
100,000,000,000 (18 dec)
FEE SPLIT
80% creator / 20% platform
LIQUIDITY LOCK
Permanent · no unlock
Authentication

Conway Liquid uses wallet signature authentication. Sign a nonce-based message with your wallet to receive a one-time API key (cl_...). Each key is valid for one deploy.

⚠ API keys are not stored server-side. Save your key immediately after registration — it cannot be recovered.
1a — Request Challenge
GET/api/keys/challenge?wallet=0xYOUR_WALLET
curl "https://liquidconway.xyz/api/keys/challenge?wallet=0x..."# Response{ "success": true,"nonce": "abc123...","message": "Register for Conway Liquid API\nWallet: 0x...\nNonce: abc123...","expires_in": 300}
1b — Sign Message

Sign the exact message field using EIP-191 personal_sign. The nonce expires in 5 minutes.

# Using Foundry castcast wallet sign --private-key $PRIVATE_KEY "$MSG"# Returns: 0x hex signature
1c — Register & Get Key
POST/api/keys/register
FieldStatusDescription
walletrequiredYour 0x wallet address
noncerequiredNonce from challenge response
signaturerequired0x hex EIP-191 signature
nameoptionalLabel for your key (e.g. "my-agent")
curl -X POST https://liquidconway.xyz/api/keys/register \ -H "Content-Type: application/json" \ -d '{"wallet":"0x...","nonce":"abc123","signature":"0x..."}'# Response{ "success": true, "key": "cl_..." }
Deploy Token

Deploy an ERC-20 token on Base with a Uniswap V4 pool and permanently locked liquidity. Pass your API key in the x-api-key header.

POST/api/deployx-api-key: cl_...
FieldStatusDescription
namerequiredToken full name (e.g. "Conway Token")
symbolrequired1–12 alphanumeric chars (e.g. "CNWY")
clientWalletrequired0x address that receives 80% LP fees forever
hookTypeoptional"dynamic" (default) or "static" — see Hook Types
descriptionoptionalToken description text
imageoptionalImage URL (pinned to IPFS)
websiteoptionalProject website URL
twitteroptionalTwitter/X handle (e.g. @handle)
vaultPercentoptional0–90 — % supply locked with linear vesting
vaultDaysoptionalMin 7 days lock period (default: 7)
devBuyEthoptionalETH amount to swap for tokens at deploy
curl -X POST https://liquidconway.xyz/api/deploy \ -H "x-api-key: cl_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "My Token", "symbol": "MTK", "clientWallet": "0xYOUR_WALLET", "hookType": "dynamic", "description": "A sample token" }'# Success Response (201){ "success": true,"token": {"address": "0x...","txHash": "0x...","name": "My Token","symbol": "MTK","supply": "100000000000","hookType": "dynamic","clientWallet":"0x...","links": {"liquid": "https://app.liquidprotocol.org/tokens/0x...","basescan": "https://basescan.org/address/0x...","dexscreener": "https://dexscreener.com/base/0x...","uniswap": "https://app.uniswap.org/swap?outputCurrency=0x..."}}}}
Token Endpoints

Query deployed tokens by address or wallet.

List Tokens
GET/api/tokens
ParamStatusDescription
limitoptionalResults per page (default: 20)
offsetoptionalPagination offset (default: 0)
walletoptionalFilter by deployer wallet address
Get Token by Address
GET/api/tokens/0xTOKEN_ADDRESS
Platform Stats
GET/api/stats
# Response{ "success": true,"platform": "Conway Liquid","chain": "Base (8453)","protocol": "Liquid Protocol","tokenSupply": "100,000,000,000","feeSplit": "80% creator / 20% platform","liquidityLock": "Permanent","supportedHooks":["dynamic", "static"],"mevProtection": true,"skill": "https://liquidconway.xyz/api/skill","docs": "https://liquidconway.xyz/docs"}
Hook Types

All pools use Liquid Protocol Uniswap V4 hooks with MEV protection on every deploy. Choose your fee model at deploy time — cannot be changed afterward.

DYNAMIC FEE
Fees adapt to trading volatility. Higher activity = higher fee rate. Best choice for most tokens — maximizes fee income during high-volume periods.
STATIC FEE
Fixed LP fee rate regardless of activity. Predictable and transparent. Better for stable, utility, or long-term community tokens.
All deploys include MEV block delay + sniper auction protection to prevent front-running at launch.
Extensions
Vault — Team Lockup

Lock a percentage of token supply with linear vesting. Useful for team allocations, DAO reserves, or any lockup commitment.

FieldValueDescription
vaultPercent0–90% of 100B supply to lock
vaultDaysmin 7Lock duration in days. Linear vesting begins after this period.
Dev Buy

Optionally swap ETH for tokens in the same deploy transaction. Seeds the Uniswap V4 pool immediately and ensures the deployer holds tokens from block 0.

FieldTypeDescription
devBuyEthstringETH amount as string (e.g. "0.05"). Swapped via Uniswap V4 at deploy.
Error Codes
CodeMeaning
400Bad request — missing or invalid fields
401Missing x-api-key header
403Invalid or already-used API key. Register a new key per deploy.
422Validation error — check field formats and constraints
500Deploy failed — often insufficient ETH on deployer wallet
503Platform deployer not configured — contact support
Contract Addresses

All contracts are on Base (Chain ID 8453).