Skip to main content
The Docent API lets you create API agents, fund a dedicated wallet, place trades, check balances, and move funds between Hyperliquid and Polymarket. Each API account gets its own non-custodial wallet powered by Privy.

​
Base URL

​
Authentication

All endpoints except POST /v1/auth/register require a Bearer token.
API keys use the dk_live_ prefix. You receive your key exactly once during registration.

​
Permissions

Each API key has four permission scopes. All permissions are enabled by default on new keys.

​
Rate limits

When rate limited, the response includes a Retry-After header in seconds and a retryAfter field in milliseconds.

​
Asynchronous execution

Orders and transfers run through durable workflows.
  1. Call POST /v1/orders/perp, POST /v1/orders/spot, POST /v1/orders/polymarket, or POST /v1/transfers.
  2. Docent returns an actionId for orders or a transferId for transfers.
  3. The workflow handles funding and execution in the background.
  4. Poll GET /v1/actions?actionId=... for orders or GET /v1/transfers?transferId=... for transfers.
This is why a request can be accepted before the trade or transfer is finished.

​
Error format

All errors follow the same shape.

​
Supported venues

The API supports trading and venue-to-venue transfers. External withdrawals to arbitrary addresses are not supported.