---
name: thirdfy-veranta
description: "Use Veranta through Thirdfy (17 reads, 21 writes): one MCP, CLI and API for every agent, with each write checked against the owner's policy before it signs."
---

# Veranta through Thirdfy

Trade perpetuals on Veranta, on Base: open, protect and close positions.

- Status: Live
- Chains: Base
- Can touch: 21 write actions from the agent's wallet, each checked against the owner's mandate before it signs.
- Directory: https://v2.thirdfy.com/protocols/veranta

## Connect

- MCP: `claude mcp add --transport http thirdfy https://mcp.thirdfy.com/mcp` (docs: https://docs.thirdfy.com/documentation/mcp)
- CLI: `npx @thirdfy/agent-cli@latest login` (add `--trade` to allow writes), then `npx @thirdfy/agent-cli@latest whoami`
- The owner allows Veranta for the agent: https://v2.thirdfy.com/integrations/veranta

## Actions

- `approve-veranta-builder-fee` (write): Approve the wired Veranta builder fee from the trader wallet.
- `cancel-veranta-perps-order` (write): Cancel an open Veranta limit order.
- `cancel-veranta-tp-sl` (write): Cancel Veranta TP/SL triggers for a position.
- `cancel-veranta-twap-order` (write): Stop a running Veranta TWAP by twapId and refund its unused collateral.
- `claim-veranta-referral-rebate` (write): Claim accrued Veranta referral rebates.
- `close-veranta-coin-position` (write): Close a Veranta position by coin exposure; omit coinExposure for a full close (batched-market).
- `close-veranta-position` (write): Close an open Veranta position via market close intent.
- `close-veranta-twap-order` (write): Close an open Veranta position in time-weighted slices.
- `complete-veranta-onboarding` (write): Mint the Thirdfy-held Veranta delegate if missing, then run the next onboarding write for the managed trader wallet.
- `deposit-veranta-vault` (write): Deposit USDC into the Veranta vault from the trader wallet; approves the tranche first when short.
- `increase-veranta-coin-position` (write): Increase an open Veranta position by coin exposure (batched-market).
- `place-veranta-coin-perps-order` (write): Open a Veranta market position sized in coin units (batched-market).
- `place-veranta-perps-order` (write): Open or increase a Veranta perps position on Base.
- `place-veranta-twap-order` (write): Open a Veranta position in time-weighted slices over runTimeSeconds (returns twapId).
- `redeem-veranta-vault` (write): Redeem Veranta vault shares for USDC now, up to maxRedeem.
- `register-veranta-referral-code` (write): Operator-only: register a new Veranta referral code.
- `request-veranta-vault-withdrawal` (write): Withdraw USDC from the Veranta vault now, up to maxWithdraw (no lock or queue).
- `revoke-veranta-builder-fee` (write): Revoke or zero the Veranta builder fee allowance.
- `set-veranta-referral-code` (write): Set the trader referral code on Veranta.
- `update-veranta-margin` (write): Add collateral to, or remove it from, an open Veranta position (updateMargin). Changes no size: adding lowers the effective leverage and moves the liquidation price away. Removal is refused on Upside (PnL) positions.
- `update-veranta-tp-sl` (write): Set Veranta full-position TP/SL, or with partialClosePercent arm partial triggers (triggerId replaces one stored trigger).
- `get-veranta-allowance` (read): Read USDC allowance from the trader to Veranta TradingStorage.
- `get-veranta-builder-fee-status` (read): Read Thirdfy Veranta builder fee template wiring.
- `get-veranta-delegation-status` (read): Read delegation status between the trader and Thirdfy delegate.
- `get-veranta-funding-status` (read): Read Base USDC balance and allowance readiness for the Veranta trader.
- `get-veranta-markets` (read): List Veranta perps markets on Base (8453).
- `get-veranta-onboarding-plan` (read): Plan delegate, USDC approval, and builder fee onboarding steps.
- `get-veranta-open-orders` (read): List open Veranta orders for the managed trader wallet.
- `get-veranta-pair` (read): Fetch one Veranta market by pairIndex or pair symbol.
- `get-veranta-positions` (read): List open Veranta positions for the managed trader wallet.
- `get-veranta-price` (read): Fetch Veranta mark prices.
- `get-veranta-referral-stats` (read): Read referral performance stats for the trader.
- `get-veranta-referral-status` (read): Read whether the trader has set an Veranta referral code.
- `get-veranta-setup-status` (read): Compose Veranta setup readiness for the managed agent_wallet trader.
- `get-veranta-spread` (read): Estimate Veranta spread via prod-api risk/v2/spread.
- `get-veranta-vault-info` (read): Read Veranta vault metadata (provider veranta-vault).
- `get-veranta-vault-position` (read): Read trader vault LP position (provider veranta-vault).
- `prepare-veranta-onboarding` (read): Dry-run Veranta onboarding.

## Rules

- Call these actions through Thirdfy, not with your own keys: Thirdfy builds each transaction and the owner's policy checks it before it signs.
- A write that the owner has not allowed, or that breaks a limit, is refused before signing and costs nothing.