pinion-trade

Trade

Returns an unsigned token swap transaction from the 1inch aggregator on Base. If the source token needs approval, an approve transaction is included.

Endpoint

POST https://pinionos.com/skill/trade

Price: $0.01 USDC per call (x402 on Base)

Request Body

{
  "src": "USDC",
  "dst": "ETH",
  "amount": "10",
  "from": "0x...",
  "slippage": 1
}

Field	Type	Required	Description
src	string	yes	Source token symbol (ETH, USDC, WETH, DAI, CBETH)
dst	string	yes	Destination token symbol
amount	string	yes	Amount to swap (human-readable)
from	string	yes	Sender address (0x, 40 hex chars)
slippage	number	no	Slippage tolerance in percent (default: 1)

Supported Tokens

ETH, USDC, WETH, DAI, CBETH

Example Request

curl -X POST https://pinionos.com/skill/trade \
  -H "Content-Type: application/json" \
  -d '{"src":"USDC","dst":"ETH","amount":"10","from":"0x101C..."}'

The first request returns HTTP 402 with payment requirements. Sign a USDC TransferWithAuthorization (EIP-3009) and retry with the X-PAYMENT header.

Example Response (with approval needed)

{
  "approve": {
    "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "data": "0x095ea7b3...",
    "value": "0x0",
    "chainId": 8453
  },
  "swap": {
    "to": "0x111111125421ca6dc452d289314280a0f8842a65",
    "data": "0x...",
    "value": "0x0",
    "chainId": 8453
  },
  "srcToken": "USDC",
  "dstToken": "ETH",
  "amount": "10",
  "network": "base",
  "router": "0x111111125421ca6dc452d289314280a0f8842a65",
  "note": "Sign and broadcast the approve tx first, wait for confirmation, then sign and broadcast the swap tx.",
  "timestamp": "2026-02-16T12:00:00.000Z"
}

When to Use

• Swap tokens on Base (e.g. USDC to ETH or ETH to USDC).
• Rebalance an agent's portfolio.
• Convert tokens before making a payment.

Flow

1. Call this skill to get the unsigned tx(s).
2. If approve is present, sign and broadcast the approve tx first, then wait for confirmation.
3. Sign and broadcast the swap tx.