aster-api-account-v3

Manage and query Aster Futures account balances, positions, and transfers via signed API v3 requests.

3|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill aster-api-account-v3-pieverse-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aster-api-account-v3
Source: https://github.com/Pieverse-Eng/purrfect-skills/tree/main/aster/vendor/futures-account
Command: npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill aster-api-account-v3-pieverse-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a clear, authenticated interface to query and manage Aster Futures account state so developers and traders can read balances, inspect positions, adjust leverage/margin, and move funds between futures and spot without manual API lookup.

Core Features & Use Cases

  • Account and Balances: Retrieve consolidated account and per-asset balances, availableBalance, and maxWithdrawAmount for wallet and cross-margin calculations.
  • Positions & Risk: Fetch positionRisk and positions data to monitor entryPrice, leverage, isolated status, unrealized PnL, and liquidationPrice for hedged or one-way modes.
  • Leverage, Margin & Transfers: Change leverage and marginType, adjust isolated position margin, and execute futures↔spot transfers with clientTranId support and timeline queries.
  • Use Case: A trading bot or portfolio tool can poll balances and position risk, change leverage for a symbol, and move funds between spot and futures in response to risk conditions.

Quick Start

Retrieve the account balances, open positions for symbol BTCUSDT, and current leverage settings using the aster-api-account-v3 endpoints with a signed API request.

Frequently Asked Questions about aster-api-account-v3

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Aster futures account balances and available margin?

To retrieve Aster futures account balances, send a signed API request to query consolidated account data, per-asset balances, availableBalance, and maxWithdrawAmount for wallet and cross-margin calculations.

How do I query open positions and liquidation prices for BTCUSDT futures?

Query open positions and liquidation prices for BTCUSDT by sending a signed request with the symbol parameter to fetch positionRisk data, including entryPrice, leverage, isolated status, and unrealized PnL for hedged or one-way modes.

Can I transfer funds between Aster spot and futures accounts via API?

Yes, you can execute futures and spot transfers via API by sending signed requests with a clientTranId, and you can query the transfer timeline to verify the movement of funds between accounts.

How do I change leverage or margin type for an Aster futures position?

Change leverage or margin type for an Aster futures position by sending a signed API request to modify leverage settings, adjust isolated position margin, and update marginType configurations for a specific symbol.

Do I need API authentication to query Aster futures account data?

Yes, API authentication is required, and all requests must follow Aster Futures API v3 signing methods to securely interact with account balances, positions, and transfer endpoints.

What is the best way to build a trading bot that monitors Aster futures risk?

Build a trading bot to monitor Aster futures risk by polling positionRisk and account balances via signed API requests, then automatically adjusting leverage, margin, or executing spot-futures transfers based on risk conditions.