Developer Platform API

Developer Platform API

The Veah Developer Platform API gives developers direct access to Veah, the Solana-native large language model. Use it to integrate real-time intelligence, on-chain reasoning, and natural language capabilities into your Solana applications.

Built for builders — fast, composable, and fully open-source. ⚡️

Base URL

https://api.veahllm.com/v1

All requests must be sent over HTTPS.

Authentication

Each request must include your API key in the Authorization header. You can generate and manage keys in your Developer Console.

Header Example:

Authorization: Bearer YOUR_API_KEY

Endpoints

1. POST /query

Generate text, retrieve on-chain insights, or reason over Solana data.

Endpoint:

POST https://api.veahllm.com/v1/query

Request Body:

Parameter
Type
Required
Description

prompt

string

✅

The text, question, or instruction you want Veah to process.

mode

string

❌

Defines the query type — text, onchain, or analytics. Default: text.

temperature

float

❌

Controls creativity/randomness. (0.0–1.0, default: 0.3)

max_tokens

integer

❌

Maximum response length in tokens. Default: 512

stream

boolean

❌

If true, enables streaming responses. Default: false

Example Request (cURL):

curl https://api.veahllm.com/v1/query \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
        "prompt": "Summarize current Solana validator performance and staking trends.",
        "mode": "onchain",
        "temperature": 0.2
      }'

Response Example:

{
  "result": "Solana validator performance remains strong at 99.7% uptime with increasing stake distribution across community validators.",
  "latency_ms": 86,
  "timestamp": "2025-10-14T18:42:00Z"
}

2. GET /models

List available models and their capabilities.

Endpoint:

GET https://api.veahllm.com/v1/models

Response Example:

{
  "models": [
    {
      "id": "veah-base",
      "description": "General-purpose LLM optimized for Solana-native tasks",
      "context_window": 8192,
      "max_tokens": 2048
    },
    {
      "id": "veah-onchain",
      "description": "Fine-tuned model for blockchain reasoning and analytics",
      "context_window": 16384,
      "max_tokens": 4096
    }
  ]
}

3. GET /metrics

Retrieve real-time model statistics and API usage analytics.

Endpoint:

GET https://api.veahllm.com/v1/metrics

Response Example:

{
  "status": "active",
  "requests_today": 12493,
  "avg_latency_ms": 82,
  "uptime": "99.98%",
  "timestamp": "2025-10-14T18:45:00Z"
}

Query Modes

Mode
Description
Example Use Case

text

General-purpose reasoning and generation

Summaries, explanations, writing

onchain

Live reasoning using Solana on-chain data

Validator metrics, transaction trends

analytics

Ecosystem-level data analysis

DeFi flows, NFT activity reports

Each mode is optimized for different Solana data layers and latency requirements.

Rate Limits

Tier
Requests / Min
Notes

Free

20

Ideal for testing and experimentation

Pro

200

For dApps and production bots

Enterprise

Custom

Dedicated infrastructure and SLA

You can view your live rate usage in the Veah Dashboard.

Error Handling

Veah returns clear JSON-formatted errors.

Example:

{
  "error": {
    "code": 401,
    "message": "Invalid or missing API key."
  }
}
Code
Meaning

400

Invalid request payload

401

Unauthorized / missing API key

403

Rate limit exceeded

500

Internal server error

Webhooks (Optional)

For async tasks or long-running queries, register a webhook URL.

Example:

{
  "prompt": "Generate an overview of Solana DeFi protocols.",
  "webhook_url": "https://yourapp.com/veah-webhook"
}

Veah will POST the completed result to your endpoint once finished.

SDKs

Official SDKs are available for JavaScript and Python.

  • JS/TS → npm install veah-sdk

  • Python → pip install veah

Docs: https://docs.veahllm.com/sdk

Support & Community

Need help or want to contribute? Join the Veah developer community and stay updated:

Final Notes

The Veah API is designed to empower builders — fast, open, and deeply integrated with Solana’s architecture. Whether you’re creating an AI copilot, DeFi assistant, or analytics dashboard, Veah provides the foundation for intelligent, on-chain applications that scale.

Start building → https://console.veahllm.com

Would you like me to follow this with a “Model Architecture” doc next (explaining Veah’s core LLM structure, Solana data pipeline, and fine-tuning process)? That’s usually the next logical tab after the API section.

Last updated