Getting Started

Slopshop is the API bazaar for AI agents and developers -- 420 real APIs that actually process your data, return real results, and charge by the credit. Every response includes _engine: "real" to prove your data was genuinely processed, not mocked. It is self-hostable, open source, and designed to be called by agents, scripts, or humans alike.

Quick Install

npm install -g slopshop

Set Your API Key

export SLOPSHOP_KEY=sk_live_your_key_here

Make Your First Call

slop call crypto-hash-sha256 --data "hello"

You will get back a JSON response with the SHA256 hash of "hello", along with metadata including _engine: "real" confirming it was actually computed.

What _engine: "real" Means

Every Slopshop response includes "_engine": "real" to signal that the result was genuinely computed, not cached from a template or mocked. This is Slopshop's core guarantee: when you call an API, your data is actually processed. Hash APIs run real cryptographic functions. Network APIs make real DNS/HTTP calls. LLM APIs send real prompts to Claude or GPT. There are no fake responses.

Authentication

All API calls require a Bearer token in the Authorization header.

Using Your Key

Authorization: Bearer sk_live_your_key_here

Generating Keys

Create a new API key by posting to the keys endpoint:

curl -X POST https://slopshop.gg/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

The response includes your key and initial credit balance. Store your key securely -- it cannot be retrieved after creation.

Demo Key

For testing, you can use the demo key sk_demo_slopshop which comes with 100 credits and is rate-limited to 10 requests per minute. The demo key works for all compute-tier APIs.

Credits & Billing

Slopshop uses a credit system. Every API call costs a specific number of credits based on its complexity.

Credit Cost Tiers

Checking Balance

curl https://slopshop.gg/v1/balance \
  -H "Authorization: Bearer sk_live_your_key"

Buying Credits

curl -X POST https://slopshop.gg/v1/buy \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'

Auto-Reload

Configure auto-reload to automatically purchase more credits when your balance drops below a threshold. Set auto_reload_threshold and auto_reload_amount on your account to enable this.

Agent-to-Agent Credit Transfer

Agents can transfer credits between accounts for agent-to-agent commerce:

curl -X POST https://slopshop.gg/v1/transfer \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": "sk_live_recipient_key", "amount": 50}'

API Reference

All 420 APIs documented below. Each API accepts a POST request with a JSON body and returns JSON. The base URL is https://slopshop.gg/v1/tools/{slug}.

CLI Reference

The Slopshop CLI lets you call any API from the terminal. Install globally with npm.

slop call <slug>

Call any API by slug. Pass data with --data or -d, or pipe JSON via stdin.

# Simple call with inline data
slop call crypto-hash-sha256 --data "hello world"

# Pass JSON body
slop call text-word-count -d '{"text": "Count these words please"}'

# Pipe from file
cat document.txt | slop call llm-summarize

slop pipe <slug>

Run a pre-built pipe (multi-step workflow) by slug.

slop pipe content-machine -d '{"topic": "AI agents", "keywords": "automation"}'
slop pipe security-audit -d '{"data": "{}", "domain": "example.com"}'

slop search <query>

Search available APIs by name or description.

slop search hash
slop search "json convert"
slop search dns

slop list

List all available APIs grouped by category.

slop list
slop list --category "Crypto & Security"

slop balance

Check your current credit balance.

slop balance

slop buy <amount>

Purchase credits.

slop buy 1000

slop health

Check API server health and status.

slop health

slop help

Show help and list all available commands.

slop help
slop call --help

SDK Reference

Python SDK

Install

pip install slopshop

Initialize

from slopshop import Slop

client = Slop(api_key="sk_live_your_key")
# Or use SLOPSHOP_KEY environment variable
client = Slop()

Call an API

result = client.call("crypto-hash-sha256", data="hello world")
print(result["hash"])

Batch Calls

results = client.batch([
    ("crypto-hash-sha256", {"data": "hello"}),
    ("crypto-hash-md5", {"data": "hello"}),
    ("crypto-uuid", {}),
])
for r in results:
    print(r)

Run a Pipe

result = client.pipe("content-machine", topic="AI agents", keywords="automation")
print(result["steps"])

Resolve (call with auto-retry)

result = client.resolve("llm-summarize", text="Long document...", retries=3)
print(result["summary"])

Node.js SDK

Install

npm install slopshop

Initialize

const { Slop } = require('slopshop');

const client = new Slop({ apiKey: 'sk_live_your_key' });
// Or use SLOPSHOP_KEY environment variable
const client = new Slop();

Call an API

const result = await client.call('crypto-hash-sha256', { data: 'hello world' });
console.log(result.hash);

Batch Calls

const results = await client.batch([
  ['crypto-hash-sha256', { data: 'hello' }],
  ['crypto-hash-md5', { data: 'hello' }],
  ['crypto-uuid', {}],
]);
results.forEach(r => console.log(r));

Run a Pipe

const result = await client.pipe('content-machine', {
  topic: 'AI agents',
  keywords: 'automation',
});
console.log(result.steps);

Resolve (call with auto-retry)

const result = await client.resolve('llm-summarize', {
  text: 'Long document...',
}, { retries: 3 });
console.log(result.summary);

Pipes

Pipes are pre-built multi-step workflows that chain multiple APIs together. A single pipe call executes all steps in sequence, passing data between them automatically. You pay the total credit cost of all steps combined.

Running a Pipe

curl -X POST https://slopshop.gg/v1/pipes/content-machine \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"topic": "How AI agents use APIs", "keywords": "slopshop, automation"}'

Listing All Pipes

curl https://slopshop.gg/v1/pipes

All 14 Pipes

Self-Hosting

Slopshop is fully self-hostable. Run your own instance with zero external dependencies for compute-tier APIs.

Quick Start

git clone https://github.com/slopshop/slopshop.git
cd slopshop
npm install
node server-v2.js

The server starts on port 3000 by default.

Docker

docker build -t slopshop .
docker run -p 3000:3000 \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -e OPENAI_API_KEY=sk-... \
  slopshop

Environment Variables