Quickstart

1. Register

Create an API agent. This provisions a dedicated Privy server wallet and returns your API key.

curl -X POST https://api.trydocent.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-trading-bot"}'

Response

{
  "agentId": "jg7h0r7m7j6q6y4m2jv1v67jv17m9h3k",
  "apiKey": "dk_live_a1b2c3d4..."
}

Save your API key now. It is only shown once and cannot be retrieved later.

2. Get your wallet address

Use auth status to fetch your deposit address after registration.

curl https://api.trydocent.com/v1/auth/status \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

Response

{
  "agentId": "jg7h0r7m7j6q6y4m2jv1v67jv17m9h3k",
  "addresses": {
    "ethereum": "0x1234...abcd"
  }
}

3. Fund your wallet

Send USDC to addresses.ethereum on Arbitrum or Base. Docent uses OneBalance to move funds between venues, so you do not need to bridge manually before you trade.

4. Check your balance

curl https://api.trydocent.com/v1/balances \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

Response

{
  "balances": {
    "evm": {
      "address": "0x1234...abcd",
      "value": 1.25,
      "available": "1250000"
    },
    "hyperliquid": {
      "address": "0x1234...abcd",
      "value": 0,
      "available": "0"
    },
    "polymarket": {
      "address": null,
      "value": 0,
      "available": "0"
    },
    "totals": {
      "value": 1.25,
      "cash": 1.25
    }
  }
}

5. Place a trade

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

Response

{
  "success": true,
  "actionId": "action_123",
  "workflowId": "wf_456"
}

6. Poll for completion

Orders execute asynchronously. Poll the action until status is completed or failed.

curl "https://api.trydocent.com/v1/actions?actionId=action_123" \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

Response

{
  "id": "action_123",
  "workflowId": "wf_456",
  "venue": "hyperliquid_perp",
  "status": "completed",
  "summary": "API: long 0.001 BTC market",
  "createdAt": 1744700000000,
  "startedAt": 1744700000200,
  "completedAt": 1744700004200,
  "error": null
}

Use GET /v1/transfers?transferId=... the same way when you create a venue transfer.

Next steps

Browse the full endpoint reference
Use POST /v1/orders/polymarket to trade prediction markets
Use POST /v1/transfers to move funds between venues
Use POST /v1/auth/keys/rotate to rotate your API key periodically

Getting started

Auth

Balances & Positions

Markets

Orders

Transfers

Actions & Strategies

1. Register

2. Get your wallet address

3. Fund your wallet

4. Check your balance

5. Place a trade

6. Poll for completion

Next steps

​1. Register

​2. Get your wallet address

​3. Fund your wallet

​4. Check your balance

​5. Place a trade

​6. Poll for completion

​Next steps

1. Register

2. Get your wallet address

3. Fund your wallet

4. Check your balance

5. Place a trade

6. Poll for completion

Next steps