Avantis

Base-native perpetuals through Thirdfy catalog actions. Managed-wallet USDC, Thirdfy-minted delegate, and relayer orders on Base.

Category: Trading

Catalog providers: avantis (perps and onboarding), avantis-vault (vault discovery)

Avantis perpetuals run on Base 8453. Thirdfy lists markets, mints a stored delegate, and places or closes positions after confirmation. The trader is the managed agent_wallet. Relayer is the default execution path. Builder-fee collection stays unwired until Avantis supplies a fee-enabled template.

Pass chainId 8453 on writes. Other chain IDs fail closed.

Networks

Chain	chainId	Explorer	Collateral
Base	8453	basescan.org	USDC

Action coverage

Action	Base 8453
`get_avantis_markets`, `get_avantis_pair`, `get_avantis_price`, `get_avantis_spread`	Live
`get_avantis_funding_status`, `get_avantis_setup_status`, `get_avantis_delegation_status`	Live
`prepare_avantis_onboarding`	Live (dry-run)
`complete_avantis_onboarding`	Live
`place_avantis_perps_order`	Live
`close_avantis_position`, `cancel_avantis_perps_order`	Live
`approve_avantis_builder_fee`	Unavailable until a fee-enabled template is wired
Vault deposit, redeem, claim	Deferred. Discovery reads live under `avantis-vault`

place_avantis_perps_order uses side long or short. That is not Hyperliquid isBuy.

Credential model

Path	Authority
Hosted agents	Default `agent_wallet` on Base 8453
Delegate	Thirdfy mints and stores an encrypted Avantis delegate during `complete_avantis_onboarding`. Callers authenticate with Thirdfy (email OTP or agent API key).
Funding	Base USDC in the managed execution wallet
Venue secret	None for callers

Discovery

curl "https://api.thirdfy.com/api/v1/agent/actions/catalog"
thirdfy-agent actions --provider avantis --json

Surface	Example
MCP	`getProviderActions { provider: "avantis" }`
CLI	`thirdfy-agent actions --provider avantis --json`
REST	`GET https://api.thirdfy.com/api/v1/agent/actions/catalog`

Reads

thirdfy-agent run --action get_avantis_markets --provider avantis --run-mode agent_wallet --chain-id 8453 --json
thirdfy-agent run --action get_avantis_funding_status --provider avantis --run-mode agent_wallet --chain-id 8453 --json
thirdfy-agent run --action get_avantis_setup_status --provider avantis --run-mode agent_wallet --chain-id 8453 --json

For agent_wallet setup and status reads, the CLI fills missing traderAddress from that wallet.

Onboarding

thirdfy-agent run --action prepare_avantis_onboarding --provider avantis --run-mode agent_wallet --chain-id 8453 --json
thirdfy-agent run --action complete_avantis_onboarding --provider avantis --run-mode agent_wallet --chain-id 8453 --json

complete_avantis_onboarding mints the stored delegate when missing, then the trader signs DelegateReq and USDC approve. Later orders are delegate-signed.

Place and close

thirdfy-agent run --action place_avantis_perps_order --params '{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}' --provider avantis --run-mode agent_wallet --chain-id 8453 --json
thirdfy-agent run --action close_avantis_position --params '{"pairIndex":0,"tradeIndex":0}' --provider avantis --run-mode agent_wallet --chain-id 8453 --json

Confirm before any onboarding or trade write.

Execution lanes

`runMode`	Use
`agent_wallet`	Solo agent-owned wallet for onboarding and perps
`thirdfy` / `hybrid`	Delegated user capital with an active binding

MetaMask/Gator delegation protects EVM calldata paths. Avantis order signing uses the stored delegate after onboarding.

MCP sequence (summary)

getProviderActions { provider: "avantis" }
get_avantis_funding_status and market reads
complete_avantis_onboarding on Base when setup is incomplete. prepare_avantis_onboarding is the dry-run preview.
get_avantis_setup_status before live writes
place_avantis_perps_order, then close_avantis_position to flatten

See Thirdfy MCP for the full recommended sequence.

Readiness checklist

Set chainId to 8453. Other chain IDs fail closed.
Fund Base USDC in the execution wallet. Onboarding and orders wait until that balance is available.
Complete onboarding so the stored delegate exists and on-chain delegation is enabled.
Re-run get_avantis_setup_status before the first live order.
Skip approve_avantis_builder_fee until setup status shows a wired template.
Confirm before any onboarding or trade write.

Console Command

Ask in Command to list Avantis markets, complete Base onboarding, or place and close a perps position. The operator uses the trading tool pack, sets Base, and confirms before a write.

basedbid

basedbid launchpad through Thirdfy catalog actions. Token discovery plus live LBP, flash create, buy, and sell on Base, Ethereum, and Robinhood Chain.

Venue matrix

Category, catalog provider keys, chains, and documentation links for Thirdfy integrations.