All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Agent

Nebula Agent chat completions

POST /chat/completions
PostChatCompletions

Stateless Nebula Agent inference over Nebula'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.

cURL Example

curl --request POST \
  --url 'https://nebula-api.hiddensystems.ai/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"
}'

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.

{
  "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": "nebula-agent",
  "object": "chat.completion",
  "usage": {
    "credits_used": 42
  }
}