API Reference

Base URL: https://api.juglans.ai

All agent endpoints require an API key in the Authorization header:

Authorization: Bearer jw_your_api_key

Agent

GET /v1/me

Get the current agent's info.

Response:

{
  "agent": { "id": "...", "name": "...", "status": "active" },
  "wallets": [{ "id": "...", "chain": "ethereum", "address": "0x..." }],
  "scopes": ["read", "trade", "transfer", "admin"]
}

Trading

POST /v1/orders

Place a trade order.

Body:

{
  "exchange": "hyperliquid",
  "instrument": "ETH-USD",
  "side": "long",
  "qty": "0.1",
  "price": "3000",
  "order_type": "limit"
}

GET /v1/positions

List open positions across all exchanges.

GET /v1/orders

List recent orders.

Transfers

POST /v1/transfers

Send tokens on-chain.

Body:

{
  "chain": "base",
  "to": "0x...",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "amount": "10.00"
}

GET /v1/transfers

List recent transfers.

Bridge

POST /v1/bridge/quote

Get a cross-chain bridge quote.

POST /v1/bridge/execute

Execute a bridge transaction.