polo-spot

name	polo-spot
description	Poloniex Spot trading using the Polo API. Authentication requires API key and secret key for private endpoints. Supports mainnet.
metadata	{"version":"1.0.0","author":"Poloniex"}
license	MIT

Polo Spot Skill

Spot trading on Poloniex using authenticated and public API endpoints. Return the result in JSON format.

Base URLs

• Public: https://api.poloniex.com
• Private: https://api.poloniex.com

Quick Reference

Complete API endpoints for Polo Spot. All endpoints are relative to the base URLs above.

Reference Data (Public)

Endpoint	Description	Required	Optional	Authentication
GET /markets	Get all symbols and trade limit info	None	symbol	No
GET /currencies	Get all supported currencies	None	currency, includeMultiChainCurrencies	No
GET /v2/currencies	Get all supported currencies (V2)	None	currency	No
GET /timestamp	Get current server time	None	None	No

Market Data (Public)

Endpoint	Description	Required	Optional	Authentication
GET /markets/price	Get latest trade price for all symbols	None	symbol	No
GET /markets/markPrice	Get latest mark price for all cross margin symbols	None	symbol	No
GET /markets/{symbol}/markPriceComponents	Get mark price components for a symbol	symbol (path)	None	No
GET /markets/{symbol}/orderBook	Get order book for a symbol	symbol (path)	scale, limit	No
GET /markets/{symbol}/candles	Get OHLC candle data	symbol (path), interval	limit, startTime, endTime	No
GET /markets/{symbol}/trades	Get recent trades for a symbol	symbol (path)	limit	No
GET /markets/ticker24h	Get 24h ticker for all symbols	None	symbol	No

Margin (Public)

Endpoint	Description	Required	Optional	Authentication
GET /markets/collateralInfo	Get collateral information for all currencies	None	currency	No
GET /markets/borrowRatesInfo	Get borrow rates for all tiers and currencies	None	None	No

Account (Private)

Endpoint	Description	Required	Optional	Authentication
GET /accounts	Get list of all accounts	None	None	Yes
GET /accounts/balances	Get all accounts with balances	None	id	Yes
GET /accounts/activity	Get account activity (airdrops, rebates, staking)	None	startTime, endTime, activityType, limit, from, direction, currency	Yes
POST /accounts/transfer	Transfer between accounts	currency(only support USDT), amount, fromAccount, toAccount	None	Yes
GET /accounts/transfer	Get transfer records	None	id	Yes
GET /feeinfo	Get fee rate for the account	None	None	Yes
GET /accounts/interest/history	Get interest collection records	None	limit, from, direction, startTime, endTime	Yes

Subaccount (Private)

Endpoint	Description	Required	Optional	Authentication
GET /subaccounts	Get all accounts within an Account Group	None	None	Yes
GET /subaccounts/balances	Get balances for all subaccounts	id	None	Yes
POST /subaccounts/transfer	Transfer between accounts in Account Group	currency, amount, fromAccountId, fromAccountType, toAccountId, toAccountType	None	Yes
GET /subaccounts/transfer	Get subaccount transfer records	None	id	Yes

Wallet (Private)

Endpoint	Description	Required	Optional	Authentication
GET /wallets/addresses	Get all deposit addresses	None	currency	Yes
GET /wallets/activity	Get deposit and withdrawal history	start, end	activityType	Yes
POST /wallets/address	Create a new deposit address for a currency	currency	None	Yes
POST /wallets/withdraw	Withdraw currency	currency, amount, address	paymentId, allowBorrow	Yes
POST /v2/wallets/withdraw	Withdraw currency (V2)	coin, network, amount, address	addressTag, allowBorrow	Yes

Margin (Private)

Endpoint	Description	Required	Optional	Authentication
GET /margin/accountMargin	Get account margin information	accountType	None	Yes
GET /margin/borrowStatus	Get borrow status of currencies	None	currency	Yes
GET /margin/maxSize	Get maximum buy/sell amount for a symbol	symbol	None	Yes

Orders (Private)

Endpoint	Description	Required	Optional	Authentication
POST /orders	Create an order	symbol, side	timeInForce, type, accountType, price, quantity, amount, clientOrderId, allowBorrow, stpMode, slippageTolerance	Yes
POST /orders/batch	Create multiple orders (max 20)	Array of order objects	None	Yes
PUT /orders/{id}	Cancel and replace an order	id (path)	clientOrderId, price, quantity, amount, type, timeInForce, allowBorrow, proceedOnFailure, slippageTolerance	Yes
GET /orders	Get list of active orders	None	symbol, side, from, direction, limit	Yes
GET /orders/{id}	Get order status by id	id (path)	None	Yes
DELETE /orders/{id}	Cancel an active order	id (path)	None	Yes
DELETE /orders/cancelByIds	Cancel multiple orders by IDs	orderIds or clientOrderIds	None	Yes
DELETE /orders	Cancel all orders	None	symbols, accountTypes	Yes
POST /orders/killSwitch	Set kill switch timer to cancel all orders	timeout	None	Yes
GET /orders/killSwitchStatus	Get kill switch status	None	None	Yes

Smart Orders (Private)

Endpoint	Description	Required	Optional	Authentication
POST /smartorders	Create a smart order	symbol, side, quantity	timeInForce, type, accountType, price, stopPrice, amount, clientOrderId, trailingOffset, limitOffset, operator	Yes
PUT /smartorders/{id}	Cancel and replace a smart order	id (path)	clientOrderId, price, stopPrice, quantity, amount, type, timeInForce, proceedOnFailure	Yes
GET /smartorders	Get list of pending smart orders	None	limit, types	Yes
GET /smartorders/{id}	Get smart order status	id (path)	None	Yes
DELETE /smartorders/{id}	Cancel a smart order	id (path)	None	Yes
DELETE /smartorders/cancelByIds	Cancel multiple smart orders by IDs	orderIds or clientOrderIds	None	Yes
DELETE /smartorders	Cancel all smart orders	None	symbols, accountTypes, orderTypes	Yes

Order History (Private)

Endpoint	Description	Required	Optional	Authentication
GET /orders/history	Get historical orders (max 30 days)	None	accountType, type, side, symbol, from, direction, states, limit, hideCancel, startTime, endTime	Yes
GET /smartorders/history	Get historical smart orders (max 30 days)	None	accountType, type, side, symbol, from, direction, states, limit, hideCancel, startTime, endTime, types	Yes

Trade History (Private)

Endpoint	Description	Required	Optional	Authentication
GET /trades	Get all trades for account (max 180 days)	None	limit, endTime, startTime, from, direction, symbols	Yes
GET /orders/{id}/trades	Get all trades for a specific order	id (path)	None	Yes

---

Parameters

Common Parameters

Symbol & Market

• symbol: Trading pair symbol (e.g., BTC_USDT, ETH_USDT)
• currency: Currency name (e.g., USDT, BTC, ETH)
• interval: Candle interval — MINUTE_1, MINUTE_5, MINUTE_10, MINUTE_15, MINUTE_30, HOUR_1, HOUR_2, HOUR_4, HOUR_6, HOUR_12, DAY_1, DAY_3, WEEK_1, MONTH_1
• scale: Price aggregation scale for order book
• accountType: Account type — SPOT (primary supported)

Order Parameters

• side: Order side — BUY, SELL
• type: Order type — MARKET, LIMIT, LIMIT_MAKER
• timeInForce: Time in force — GTC (default), IOC, FOK
• price: Order price — required for LIMIT and LIMIT_MAKER orders
• quantity: Base currency quantity — required for MARKET SELL or LIMIT orders
• amount: Quote currency amount — required for MARKET BUY
• clientOrderId: Client-defined order ID (max 64 characters)
• allowBorrow: Allow borrow for margin orders (default false)
• stpMode: Self-trade prevention — None, EXPIRE_TAKER (default)
• slippageTolerance: Slippage tolerance for MARKET orders (range: >0 and <1)

Smart Order Parameters

• stopPrice: Trigger price for STOP/STOP_LIMIT; activation price for TRAILING types
• trailingOffset: Required for TRAILING types; suffix with % for proportion
• limitOffset: Required for TRAILING_STOP_LIMIT
• operator: GTE or LTE — used with TRAILING types
• proceedOnFailure: Continue with new order even if cancel fails (default false)

Pagination Parameters

• from: ID to begin query (default 0)
• direction: Query direction — PRE (previous), NEXT (default)
• limit: Number of records to return
• startTime: Start time (Unix milliseconds)
• endTime: End time (Unix milliseconds)

Transfer Parameters

• fromAccount: Source account identifier
• toAccount: Destination account identifier
• fromAccountId: External UID of source account (subaccount transfers)
• toAccountId: External UID of destination account (subaccount transfers)
• fromAccountType: Source account type — SPOT or FUTURES
• toAccountType: Destination account type — SPOT or FUTURES

Wallet Parameters

• address: Withdrawal destination address
• paymentId: Memo/tag for command deposit addresses (V1 withdraw)
• coin: Currency name for V2 withdrawal (e.g., BTC, USDT, USDD)
• network: Target blockchain network for V2 withdrawal (e.g., BTC, ETH, TRX)
• addressTag: Memo for V2 withdrawal command deposit addresses

Enums

Order Side

• side: BUY, SELL

Order Type

• type: MARKET, LIMIT, LIMIT_MAKER

Smart Order Type

• type: STOP, STOP_LIMIT, TRAILING_STOP, TRAILING_STOP_LIMIT

Time in Force

• timeInForce: GTC (Good Till Cancel, default), IOC (Immediate or Cancel), FOK (Fill or Kill)

Order State

• state: NEW, PARTIALLY_FILLED, FILLED, PENDING_CANCEL, PARTIALLY_CANCELED, CANCELED, FAILED

Smart Order State

• state: PENDING_NEW, PENDING_CANCEL, CANCELED, TRIGGERED, FAILED

Symbol State

• state: NORMAL, PAUSE, POST_ONLY

Account Type

• accountType: SPOT, FUTURES

Query Direction

• direction: PRE, NEXT

Activity Type

• activityType: 200 (ALL), 201 (AIRDROP), 202 (COMMISSION_REBATE), 203 (STAKING), 204 (REFERAL_REBATE), 205 (SWAP), 104 (CREDIT_ADJUSTMENT), 105 (DEBIT_ADJUSTMENT), 199 (OTHER)

Trade Match Role

• matchRole: MAKER, TAKER

---

Authentication

For private endpoints, you will need to provide Polo API credentials.

Required credentials:

• apiKey: Your Polo API key
• secretKey: Your Polo API secret (for signing)

See references/authentication.md for the full signing process.

---

Security

Share Credentials

Users can provide Polo API credentials by sending a file where the content is in the following format:

api_key_here
secret_key_here

Never Display Full Secrets

When showing credentials to users:

• API Key: Show first 5 + last 4 characters: abcde...xyz1
• Secret Key: Always mask, show only last 5: ***...key12

Example response when asked for credentials:

Account: main
API Key: abcde...xyz1
Secret: ***...key12
Environment: Production

Listing Accounts

When listing accounts, show names and environment only — never keys:

Polo Accounts:
* main (Production)
* trading (Production)

Transactions in Production

When performing transactions in production, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.

---

Polo Accounts

main

• API Key: your_api_key
• Secret: your_secret_key
• Environment: https://api.poloniex.com
• Description: Primary spot trading account

TOOLS.md Structure

## Polo Accounts

### main
- API Key: abcde...xyz1
- Secret: secret_abc...key
- Environment: https://api.poloniex.com
- Description: Primary spot trading account

Agent Behavior

1. Credentials requested: Mask secrets (show last 5 chars only)
2. Listing accounts: Show names and environment, never keys
3. Account selection: Ask if ambiguous, default to main
4. When doing a transaction in production, confirm with user before by asking to write "CONFIRM" to proceed
5. New credentials: Prompt for name, environment

Adding New Accounts

When user provides new credentials:

• Ask for account name
• Ask: Which environment (Production)
• Store in TOOLS.md with masked display confirmation

User Agent Header

Include User-Agent header with the following string: polo-spot/1.0.0 (Skill)

Important Notes

• All timestamps are in Unix milliseconds unless specified otherwise
• Symbol format uses underscore separator (e.g., BTC_USDT, not BTC-USDT)
• For order IDs: if using clientOrderId, prefix with cid: (e.g., cid:my-order-1)
• Order quantity is in base currency units; amount is in quote currency units
• MARKET BUY requires amount (quote units); MARKET SELL requires quantity (base units)
• LIMIT and LIMIT_MAKER orders require both price and quantity
• Kill switch timeout range: -1 (disable) or 10–600 seconds
• Batch order creation supports up to 20 orders per request
• Order history max interval: 30 days; trade history max interval: 180 days
• Canceled orders archived after 7 days; other orders after 90 days
• Self-trading not allowed — incoming orders causing self-trade are canceled
• Orders causing >20% price movement are rejected
• Subaccount transfers: primary can transfer between any accounts; subaccounts can only transfer to primary
• Transfer records max interval: 6 months (default last 7 days)
• Interest history max interval: 90 days (default last 7 days)
• All DELETE requests that do not require parameters must include a request body of {} (empty JSON object) — use json={} in the request
• All request endpoints must match the endpoints specified in the documentation.