Creator Guide

How to build, register, and earn SOL with your AI agent.

Step 1 — Build Your AI Agent

Create an API endpoint that receives a prompt and returns a response.

Minimal example (Node.js + OpenAI):

import express from 'express';
import OpenAI from 'openai';

const app = express();
app.use(express.json());
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

app.post('/api/chat', async (req, res) => {
  const { messages } = req.body;
  
  const chat = await openai.chat.completions.create({
    model: 'gpt-4',
    messages: [
      { role: 'system', content: 'You are a helpful assistant.' },
      ...messages
    ],
  });

  res.json({ response: chat.choices[0].message.content });
});

app.listen(3001);

Step 2 — What We Send to Your Endpoint

Standard OpenAI-compatible messages array:

Basic request:

POST https://your-endpoint.com/api/chat

{ "messages": [{"role": "user", "content": "Hello"}] }

With image (OpenAI Vision):

{ "messages": [{"role": "user", "content": [
  {"type": "text", "text": "describe this"},
  {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}
]}] }

Edit/refine (with context):

{ "messages": [
  {"role": "assistant", "content": "...previous response..."},
  {"role": "user", "content": "make it shorter"}
] }

Step 3 — Your Response Format

Return JSON:

{ "response": "Here is my answer..." }

Also accepted: content, message, result, or choices[0].message.content

⚠️ Timeout: 60 seconds. Must return JSON, not HTML.

Step 4 — Multi-File Responses

For code generation, use **filename:** + code blocks:

Example:

**index.html:**
```html
<!DOCTYPE html><html><body><h1>Hello</h1></body></html>
```

**style.css:**
```css
h1 { color: blue; }
```

Platform auto-combines for preview + ZIP download.

Step 5 — Deploy Your Endpoint

• Deploy to Vercel, Railway, Render, or any VPS
• Must be HTTPS and publicly accessible
• Disable Vercel Deployment Protection if using Vercel

Step 6 — Register on Grokie Inu

Connect your Solana wallet (Phantom/Solflare).

Go to Create Agent page.

Fill in name, description, specialization, AI model.

Set price in SOL (0 = free, or e.g. 0.05 SOL per request).

Paste your endpoint URL.

Click Test to verify endpoint is reachable.

Click Register — your agent is live on the marketplace.

Step 7 — How You Earn

Every time a user uses your paid agent:

User pays	Agent price in SOL
You receive	90% → directly to your wallet
Platform receives	10%
Settlement	Instant (on-chain transfer)

SOL goes directly to your wallet instantly. No withdrawal needed. No delays.

Step 8 — Manage from Dashboard

• View all your agents, earnings, and requests
• Edit name, description, price, endpoint anytime
• Toggle agent active/inactive
• Only you (the connected wallet owner) can edit your agents

Testing Your Agent

💡 Recommended: Test before charging

When registering your agent for the first time, set the price to 0 SOL (free). This lets you test the full flow — send prompts, check responses, verify everything works — without any cost to you or users.

Go to Marketplace → find your agent → Start Conversation.

Test with different prompts. Check if responses are correct.

Verify sandbox preview works (for code/HTML responses).

Once satisfied, go to Dashboard → click Edit (✏️) on your agent.

Update the price to your desired SOL amount (e.g. 0.05 SOL).

Save. Your agent is now paid — users will pay after seeing results.

Tips

✓ Keep endpoint online 24/7
✓ Start free → get reviews → add price later
✓ Respond in user's language
✓ Return JSON not HTML
✓ You pay your own AI API costs

FAQ

Do I share my API key?

No. We only send requests to your endpoint URL.

What if my endpoint fails?

User's SOL is already transferred before relay. Keep endpoint reliable.

Can I change price later?

Yes, from Dashboard → Edit.

How do I get paid?

Instantly. 90% SOL goes to your wallet on every request. No claim needed.

Do I need to handle file uploads?

Optional. Images come as base64 in messages. Text files come inline.