Skip to main content
POST
/
v1
/
swap
/
sign
Sign a quote
curl --request POST \
  --url https://propamm.kipseli.win/v1/swap/sign \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokenIn": "0x4200000000000000000000000000000000000006",
  "tokenOut": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "fee": "3000",
  "userAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
'
{
  "verificationData": "0xabcdef...",
  "timestamp": 1741737600
}
Before executing a swap on-chain, call this endpoint to obtain verificationData and timestamp. Both values must be passed directly into the swap() function — if either is modified or expired, the transaction will revert.

​
Swap Execution Flow

​
Step 1 — Call this endpoint

curl -X POST https://propamm.kipseli.win/v1/swap/sign \
  -H "Content-Type: application/json" \
  -d '{
    "tokenIn":     "0x4200000000000000000000000000000000000006",
    "tokenOut":    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "fee":         "3000",
    "userAddress": "0x1111111111111111111111111111111111111111"
  }'
Response: 
{
  "verificationData": "0x...",
  "timestamp": 1735689600
}

​
Step 2 — Approve the Router

IERC20(tokenIn).approve(
    0x71C2Ed90CC288229Be59F26b8B3EEF3C07d7ab99,
    amountIn
);

​
Step 3 — Execute the swap on-chain

IPropAmm(0x71C2Ed90CC288229Be59F26b8B3EEF3C07d7ab99).swap(
    tokenIn,
    amountIn,
    tokenOut,
    minOutAmount,      // slippage protection — use quote() to calculate
    timestamp,         // from API response
    verificationData   // from API response
);
ParameterDescription
tokenInInput token address
amountInAmount of input token (in token decimals)
tokenOutOutput token address
minOutAmountMinimum acceptable output — set this to protect against slippage
timestampReturned by this API — pass through unchanged
verificationDataReturned by this API — pass through unchanged

​
Fee Parameter

The fee field uses 0.1 bps resolution:
ValueRate
10.1 bps (0.001%)
101 bps (0.01%)
303 bps (0.03%)
10010 bps (0.10%)
The fee is deducted from the output amount (amountOut) and settled monthly in a mutually agreed currency.

Body

application/json
​
tokenIn
string
required

EVM hex address of the input token (checksummed or lowercase)

Example:

"0x4200000000000000000000000000000000000006"

​
tokenOut
string
required

EVM hex address of the output token (checksummed or lowercase)

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
fee
string
required

Fee tier as a decimal string (e.g. "3000" = 0.3%)

Example:

"3000"

​
userAddress
string
required

EVM hex address of the user submitting the swap

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Response

Quote signed successfully

​
verificationData
string

ABI-encoded hex string (with 0x prefix) containing (fee, originRate, userAddress, signature). Pass this directly to the on-chain verification contract.

Example:

"0xabcdef..."

​
timestamp
integer<int64>

Unix timestamp (seconds) at which the signature was generated

Example:

1741737600