Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Ruma Agent chat completions

POST /chat/completions

PostChatCompletions

Stateless Ruma Agent inference over Ruma's market intelligence layer. Pass a messages array; the latest user message is answered and up to six preceding messages are used as caller-managed conversation context. Set stream=true for OpenAI-style SSE text deltas. thinking_mode is optional and defaults to auto; use deep for deeper reasoning.

Parameters

No parameters for this endpoint.

Responses

200 OK

400 Bad Request ErrorResponse

OK. When stream=true, the response is text/event-stream with OpenAI-style chat.completion.chunk data frames.

Media type application/json

choices

array<object> optional

No description provided.

choices[].delta

object optional

No description provided.

choices[].delta.content

string optional

No description provided.

choices[].delta.role

string optional

No description provided.

choices[].finish_reason

string optional

No description provided.

choices[].index

integer optional

No description provided.

choices[].message

object optional

No description provided.

choices[].message.content

string optional

No description provided.

choices[].message.role

string optional

No description provided.

created

integer (int64) optional

No description provided.

id

string optional

No description provided.

model

string optional

No description provided.

object

string optional

No description provided.

usage

object optional

No description provided.

usage.credits_used

integer (int64) optional

No description provided.

cURL Example

curl --request POST \
  --url 'https://api.ruma.fun/api/v1/public/chat/completions' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "messages": [
    {
      "content": "What narratives are heating up around Solana?",
      "role": "user"
    }
  ],
  "stream": true,
  "thinking_mode": "auto"
}'

JSON Response

200 · application/json

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Solana attention is being driven by renewed DEX volume, app-token speculation, and smart-money accumulation in adjacent ecosystem names.",
        "role": "assistant"
      }
    }
  ],
  "created": 1780934400,
  "id": "chatcmpl_example",
  "model": "ruma-agent",
  "object": "chat.completion",
  "usage": {
    "credits_used": 42
  }
}