DeFi Intelligence

​

When to use

​

What you can build

• Autonomous DeFi agent — /think runs on a schedule (hourly, daily), if it says “buy” → /execute builds the swap → your agent signs and submits via session key. Fully automated, gasless.
• Portfolio advisor app — Show users a dashboard with AI recommendations. /think with their real balances + chosen risk level. They review the suggestion and approve manually.
• Risk-managed vault — A smart contract-backed strategy where /think enforces risk params (max drawdown, min stablecoins) before any rebalance.
• Telegram trading bot — User sends portfolio snapshot, bot calls /think, replies with the recommendation and a “execute” button that triggers /execute.
• Yield optimizer — /think includes DeFi yield data from DefiLlama. An agent can compare swap gains vs. yield APY and pick the better move.

​

POST /ai/think

curl -X POST https://api.chipipay.com/v1/ai/think \
  -H "Authorization: Bearer sk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "haiku",
    "portfolio": {
      "USDC": {"balance": 100, "usd": 100},
      "ETH": {"balance": 0.04, "usd": 88},
      "STRK": {"balance": 500, "usd": 17}
    },
    "riskScore": 7,
    "chain": "starknet"
  }'

​

Request body

​

Risk parameter overrides

​

How risk scoring works

​

POST /ai/execute

curl -X POST https://api.chipipay.com/v1/ai/execute \
  -H "Authorization: Bearer sk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "starknet",
    "action": "swap",
    "from": "USDC",
    "to": "ETH",
    "amountUsd": 10,
    "walletAddress": "0x0189e2ebb955fc19bf37bd8fc0400de24c123363e7955282bcfb99679a773e61",
    "slippage": 0.005
  }'

​

Request body

​

Putting it together: Think + Execute

1. Think — send portfolio + risk score, get a decision
2. If decision is buy or sell → Execute — get unsigned swap calldata
3. Sign the calls with your wallet or session key
4. Submit via Chipi’s gasless paymaster

// 1. Get AI decision
const decision = await fetch("https://api.chipipay.com/v1/ai/think", {
  method: "POST",
  headers: { "Authorization": "Bearer sk_prod_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    portfolio: { USDC: { balance: 100, usd: 100 }, ETH: { balance: 0.04, usd: 88 } },
    riskScore: 7,
  }),
}).then(r => r.json());

// 2. If actionable, build swap calldata
if (decision.decision.action !== "hold") {
  const swap = await fetch("https://api.chipipay.com/v1/ai/execute", {
    method: "POST",
    headers: { "Authorization": "Bearer sk_prod_YOUR_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({
      chain: "starknet",
      action: "swap",
      from: "USDC",
      to: "ETH",
      amountUsd: 10,
      walletAddress: "0x...",
    }),
  }).then(r => r.json());

  // 3. Sign swap.calls with your wallet and submit
  console.log("Calls to sign:", swap.calls);
}