API Reference

Julia automatically exposes plugin logic as RESTful endpoints via its built-in Scalar integration. This section provides an overview of how the API system works and how to interact with your deployed plugins.

Base URL

All endpoints are accessible under your base domain or IP:

https://yourdomain.com/api/{plugin-name}

If Scalar UI is enabled, you can explore, test, and document APIs directly via:

https://yourdomain.com/scalar/v1

Authentication

By default, Julia supports Bearer token-based authentication:

Authorization: Bearer your_token_here

You can configure schemes via MapScalarApiReference() in Program.cs.

Standard Plugin Endpoint

Each plugin exposes a single endpoint:

POST /api/{plugin-name}

The request body should be JSON, and the response will be a JSON object returned by the plugin runtime.

Example: quantum_oracle

POST /api/quantum-oracle
Content-Type: application/json
 
{
  "token": "PEPE",
  "wallet": "0xabc123"
}

Sample Response:

{
  "token": "PEPE",
  "prediction": {
    "next_7_days": "Chaotic Bullish",
    "quantum_alignment": 98.76,
    "entry_signal": "Enter between 0.000042 - 0.000046",
    "exit_signal": "Exit sharply if > 0.000072",
    "warning": "Avoid Thursdays. Quantum disruption probable."
  },
  "oracle_id": "quantum-7f42e913"
}

Plugin List (Examples)

Plugin Name	Endpoint	Description
quantum_oracle	/api/quantum-oracle	Forecasts token fate using quantum data
reinforcement_learning_plugin	/api/reinforcement-learning	Suggests actions via AI agent
arithmetic_agent	/api/arithmetic-agent	Projects supply metrics for tokens
zero_knowledge_voting	/api/zero-knowledge-voting	Anonymous voting using zk-proofs
permission_enforcer	/api/permission-enforcer	Checks if an action is permitted
ai_shiller_rating	/api/ai-shiller-rating	Evaluates shill content potential

Error Handling

Julia returns structured error responses:

{
  "error": "Missing required parameter: token",
  "code": 400
}

Errors can come from:

Malformed input
Unauthorized request
Plugin runtime exceptions

Try It Out

Use the Scalar UI to send requests directly from your browser. It supports:

Auto-generated docs
Auth header injection
Test request interface
JSON schema validation

SDKs (Coming Soon)

Julia will support automatic client generation for:

TypeScript (fetch, axios)
Python (requests)
C# (.NET HttpClient)
Go (native net/http)

By exposing plugins as clean, stateless, versioned APIs — Julia lets you treat your infrastructure like a composable service mesh, ready for automation, orchestration, and public access.

API Reference

On this page