How do I install the Pinion Trade skill?

Run npx skillmds@latest add tomevault-io/pinion-trade in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pinion Trade safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pinion Trade?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pinion Trade free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pinion Trade?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pinion Trade by tomevault-io — Agent Skill

Name: Pinion Trade
Author: tomevault-io

File contents

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

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: pinion-tradedescription: Get an unsigned swap transaction via 1inch aggregator on Base. Includes approval tx if needed. Costs $0.01 USDC via x402. Use when this capability is needed.---# TradeReturns 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```json{ "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 TokensETH, USDC, WETH, DAI, CBETH## Example Request```bashcurl -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)```json{ "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.## Flow1. 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.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/chu2bard) — claim your Tome and manage your conversions.

Frequently asked questions

Pinion Trade