canonical: https://jentic.com/apis/poloniex.com/poloniex-api

# Poloniex API

Poloniex is a cryptocurrency exchange offering spot trading for hundreds of digital assets including Bitcoin, Ethereum, and altcoins. The Poloniex API provides programmatic access to market data, order placement, account management, and wallet operations. Traders use it to implement automated trading strategies, arbitrage bots, and portfolio rebalancing algorithms. The API supports both REST endpoints for account queries and order management, plus WebSocket streams for real-time price feeds and order book updates. Institutions and quantitative trading firms integrate Poloniex to execute high-frequency strategies, manage cross-exchange positions, and aggregate liquidity. The API includes advanced order types like stop-limit and fill-or-kill, margin trading capabilities, and lending market access for earning yield on idle crypto holdings.

## For AI agents

Trade cryptocurrencies, manage accounts, access market data, and execute wallet operations on Poloniex exchange.

## Scope

Provides spot trading, account management, and market data access. Does not support futures trading, options, or derivatives-use specialized derivatives exchanges. Does not provide tax reporting or portfolio analytics-use dedicated crypto tax software.

## Capabilities

- Retrieve real-time and historical market data for cryptocurrency trading pairs
- Place market, limit, stop-limit, and advanced order types
- Query account balances across spot, margin, and lending accounts
- Transfer funds between spot, margin, and lending wallets
- Access order book depth and recent trade history for price discovery
- Manage open orders including placement, cancellation, and modification
- Query account trading activity and transaction history for reconciliation

## Use cases

### Automated Trading Strategy Execution

Quantitative traders and crypto funds use the API to implement algorithmic trading strategies like momentum trading, mean reversion, and statistical arbitrage. Trading bots query real-time price feeds, calculate technical indicators like RSI and MACD, and execute buy/sell orders based on signal generation. The API's order management endpoints enable strategies to track fill rates, manage position sizes, and implement stop-loss protection. Traders backtest strategies using historical data endpoints, then deploy live bots that run 24/7 to capitalize on crypto market volatility.

Example prompt: Query Poloniex for BTC/USDT current price and order book depth, calculate trading signal using RSI indicator, place limit buy order if signal triggers, monitor order status, adjust position sizing based on account balance.

### Cross-Exchange Arbitrage and Liquidity Aggregation

Crypto arbitrage firms monitor price differences across Poloniex and other exchanges like Binance, Coinbase, and Kraken. The API enables real-time price queries for the same trading pair on multiple venues, identifying arbitrage opportunities when spreads exceed trading fees. Bots execute simultaneous buy/sell orders across exchanges to capture risk-free profit. The account activity endpoints enable reconciling positions and calculating net P&L across venues. This increases market efficiency while generating consistent returns for arbitrage operators.

Example prompt: Fetch BTC/USDT price from Poloniex and competitor exchanges, calculate spread after fees, if spread exceeds threshold execute buy on cheaper exchange and sell on expensive exchange, transfer funds via wallet operations to rebalance.

### Portfolio Management and Rebalancing

Crypto portfolio managers and robo-advisors use the API to implement automated rebalancing strategies that maintain target asset allocations. The API's account balance endpoints provide real-time portfolio valuations, while market data endpoints supply current prices for rebalancing calculations. When an asset drifts beyond tolerance bands (e.g., Bitcoin allocation drops from 40% to 35%), the bot sells overweight positions and buys underweight assets. This maintains risk-adjusted returns and prevents concentration risk, operating continuously across multiple client accounts.

Example prompt: Query account balances for all assets, calculate current portfolio weights using market prices, compare to target allocation, generate rebalancing trades to restore weights, execute orders, log rebalancing activity for reporting.

### Market Making and Liquidity Provision

Professional market makers use the API to provide liquidity on Poloniex trading pairs, earning spreads between bid and ask prices. Market making bots place limit orders on both sides of the order book, continuously adjusting prices based on mid-market movements and inventory risk. The API's order book endpoints enable calculating optimal quote prices, while order management endpoints allow rapid cancellation and replacement as market conditions change. Market makers earn rebates from exchanges for providing liquidity while managing inventory risk through hedging strategies.

Example prompt: Query order book for target trading pair, calculate mid-market price and spread, place limit buy order below mid and limit sell above mid, monitor inventory levels, cancel and replace orders as market moves, hedge inventory on other exchanges.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/markets/price` | Get current price for a trading pair |
| POST | `/orders` | Place a new trading order |
| GET | `/accounts` | Get account types and IDs |
| GET | `/accounts/balances` | Get balances for all accounts |
| POST | `/accounts/transfer` | Transfer funds between account types |

## Key resources

- **Markets** — Access market data, trading pairs, and price information.
- **Orders** — Place, modify, and cancel trading orders.
- **Accounts** — Query balances and transfer funds between wallets.
- **Trades** — Access trade history and transaction records.

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 62 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 56 / 100
  - AI-Readiness & Agent Experience: 42 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/poloniex.com/poloniex-api/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Poloniex API by hand means generating an HMAC signature and timestamp header for every request to api.poloniex.com alongside your API key. Through Jentic you install once, import the Poloniex API from the API Directory, store the key and secret once, and your agent calls it.
- **Permission scoping:** Poloniex identifies orders and transfers through the request body rather than pinning a resource in the URL path, so scope the agent to the operations it needs, such as reading balances or placing an order. You choose that set, so a fund-moving operation like a transfer is included only if you add it while a read-only agent keeps just the price and balance operations.
- **Credential handling:** Your Poloniex API key and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time, including the request signing. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'place a limit order for Bitcoin' or 'check account balances', and Jentic returns the matching Poloniex operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Binance Spot API** — Binance provides the world's largest cryptocurrency exchange with deep liquidity and extensive trading pairs.
- **CoinGecko API** — CoinGecko provides aggregated cryptocurrency market data, prices, and metadata across exchanges.

## FAQ

### What authentication does the Poloniex API use?

The Poloniex API uses API key authentication with HMAC-SHA256 signatures. You generate API keys in your Poloniex account settings with specific permissions (read-only, trading, withdrawals), then sign each request with your secret key.

### Does Poloniex support WebSocket for real-time data?

Yes, Poloniex provides WebSocket endpoints for streaming real-time price updates, order book changes, and account activity. Use REST endpoints for historical data and account management, and WebSockets for live market data in trading bots.

### What order types does the Poloniex API support?

The API supports market orders, limit orders, stop-limit orders, fill-or-kill, immediate-or-cancel, and post-only orders. This enables sophisticated trading strategies including stop-loss protection and maker-only liquidity provision.

### Can I transfer crypto between different wallet types on Poloniex?

Yes, the accounts/transfer endpoint enables moving funds between spot, margin, and lending wallets within your Poloniex account. This is useful for allocating capital to different trading strategies or earning yield on idle balances.

### How do AI agents use the Poloniex API through Jentic?

Agents search Jentic for tasks like 'get Bitcoin price on Poloniex' or 'place a limit order' and receive operation schemas. Jentic securely stores API keys, handles HMAC signature generation, and allows agents to execute trades, query balances, and analyze market data with natural language instructions.

### Can I limit what my agent is allowed to do with the Poloniex API?

Yes. Because you run Jentic One yourself, your own rules decide which Poloniex operations the agent can call and which credentials it uses. Since Poloniex identifies orders and transfers through the request body rather than a resource in the URL path, you scope the agent at the operation level: a read-only agent keeps just the price and balance-query operations, while a fund-moving operation like accounts/transfer or placing an order is included only if you add it. Your API key and secret stay encrypted in your own instance and are injected only for the operations you allow.
