Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trydocent.com/llms.txt

Use this file to discover all available pages before exploring further.

Docent exposes a REST API that lets AI agents, trading bots, and developers trade on Hyperliquid and Polymarket without the mobile app. Each API account gets a dedicated non-custodial wallet, and you authenticate every request with an API key.

​
What you can do

  • Trade perpetuals on Hyperliquid
  • Trade spot tokens like PURR and HFUN on Hyperliquid
  • Trade prediction markets on Polymarket
  • Check balances and positions across venues in one API
  • Move funds between venues without manual bridging
  • Poll order and transfer status as workflows complete
All of this is available through simple HTTP requests.

​
How it works

Register

Create an API agent. You get a one-time API key right away.

Fund

Send USDC to your wallet on Arbitrum or Base. Docent handles venue-to-venue moves for you.

Trade

Place orders through the API. Docent auto-funds from your unified balance when a venue needs cash.

Poll

Orders and transfers execute asynchronously. Poll the actions or transfers endpoint for status.

​
Unified balance

Your API account has one balance view across the trading venues Docent supports. When you place a trade, Docent can move funds to the right venue before execution.
VenueWhat it holds
EVMUSDC in your wallet on supported EVM chains
Hyperliquid spotSpot token balances and transferable USDC
Hyperliquid perpetualsPerpetual margin and P&L
Polymarket SafePrediction market collateral

​
Non-custodial by default

Every API account is backed by a dedicated Privy server wallet. The API supports trading and venue-to-venue transfers only. It does not support external withdrawals to arbitrary addresses.
  • Your wallet is created and managed by Privy
  • Private keys stay inside Privy’s Trusted Execution Environments
  • API keys can be rotated or revoked at any time

​
Rate limits and permissions

Each API key includes read, trade, transfer, and strategies scopes.
TierLimit
Standard60 requests per minute
Premium300 requests per minute
The strategies scope is reserved for strategy endpoints that are coming soon.

​
Example: long BTC in four lines

curl -X POST https://api.trydocent.com/v1/orders/perp \
  -H "Authorization: Bearer dk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"symbol":"BTC","side":"long","size":"0.001","orderType":"market"}'

​
Get started

API quickstart

Create an API agent, fund its wallet, and place your first trade.