Rhun REST API

You will need an API Key to access the Rhun REST API. Get your API Key at https://beta.rhun.io/account

The Rhun REST API provides programmatic access to the core functionality of the Rhun trading and research platform. Designed for developers, quants, and crypto analysts, this API enables seamless integration with Rhun’s suite of financial intelligence tools.

Key Features:

• Access real-time and historical market data

• Analyze token trends, movements, and sentiment

• Execute custom research queries through AI-enhanced endpoints

• Integrate Rhun tools into custom dashboards, bots, or trading strategies

Chat with the AI

post

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

Chat response

application/json

responsestringOptional

401

Unauthorized

application/json

429

Rate limit exceeded

application/json

post

/api/chat

HTTPcURLJavaScriptPython

POST /api/chat HTTP/1.1
Host: beta.rhun.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "messages": [
    {
      "role": "user",
      "content": "text"
    }
  ],
  "agent": {
    "id": "text",
    "userId": "text"
  }
}

{
  "response": "text"
}

List agents

get

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of agents

application/json

idstringOptional

userIdstringOptional

namestringOptional

descriptionstringOptional

imageUrlstring · nullableOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

modelstring · enumOptionalPossible values:

401

Unauthorized

application/json

get

/api/agents

HTTPcURLJavaScriptPython

GET /api/agents HTTP/1.1
Host: beta.rhun.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "userId": "text",
    "name": "text",
    "description": "text",
    "imageUrl": "text",
    "createdAt": "2026-03-01T13:22:21.232Z",
    "updatedAt": "2026-03-01T13:22:21.232Z",
    "model": "claude-3-5-sonnet-20240620",
    "configuration": {
      "coreCapabilities": "text",
      "interactionStyle": "text",
      "analysisApproach": "text",
      "riskCommunication": "text",
      "responseFormat": "text",
      "limitationsDisclaimers": "text",
      "prohibitedBehaviors": "text",
      "knowledgeUpdates": "text",
      "specialInstructions": "text",
      "wallets": [
        {
          "address": "text",
          "network": "text",
          "type": "text"
        }
      ]
    }
  }
]

Create new agent

post

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

imagestring · binaryOptional

Agent profile image (optional)

Responses

201

Agent created successfully

application/json

401

Unauthorized

application/json

post

/api/agents

HTTPcURLJavaScriptPython

POST /api/agents HTTP/1.1
Host: beta.rhun.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 780

{
  "data": {
    "name": "Crypto Analyst",
    "description": "A crypto analyst providing insights on market trends",
    "model": "claude-3-5-sonnet-20240620",
    "configuration": {
      "coreCapabilities": "Deep expertise in cryptocurrency markets...",
      "interactionStyle": "Professional yet approachable tone...",
      "analysisApproach": "Consider multiple perspectives...",
      "riskCommunication": "Always highlight potential risks...",
      "responseFormat": "1. Context\n2. Analysis\n3. Considerations\n4. Next Steps",
      "limitationsDisclaimers": "Clearly state when information is insufficient...",
      "prohibitedBehaviors": "Never make specific price predictions...",
      "knowledgeUpdates": "Base analysis on available historical data...",
      "specialInstructions": "When analyzing trends: 1. Start with longer timeframes..."
    }
  },
  "image": "binary"
}

{
  "message": "text",
  "agentId": "text",
  "userId": "text",
  "imageUrl": "text"
}

List watchers

get

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of watchers

application/json

idstringOptional

namestringOptional

typestringOptional

statusstringOptional

401

Unauthorized

application/json

get

/api/watchers

HTTPcURLJavaScriptPython

GET /api/watchers HTTP/1.1
Host: beta.rhun.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "type": "text",
    "status": "text"
  }
]

Create new watcher

post

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringOptional

typestringOptional

configurationobjectOptional

Responses

201

Watcher created successfully

application/json

401

Unauthorized

application/json

post

/api/watchers

HTTPcURLJavaScriptPython

POST /api/watchers HTTP/1.1
Host: beta.rhun.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "name": "text",
  "type": "text",
  "configuration": {}
}

{
  "id": "text",
  "name": "text",
  "type": "text",
  "status": "text"
}