Consume Rate Limit Token API

Consume one (or N) tokens from a named rate limiter bucket. Returns whether the request was allowed or rejected, remaining tokens, and time until the next token is available. Creates the limiter on first use with provided max/window config. Available as a simple REST API — POST your input, get structured JSON back. 1 credit per call, no rate limiting, works in any language with HTTP support.

How it works

POST a JSON object with your input data to /v1/orch-rate-limit-consume. The API processes your request server-side using real computation (not mocked data) and returns a structured JSON response with your results and metadata including credits used and processing time.

Use cases

• Use Consume Rate Limit Token in automated pipelines without installing a library
• Call Consume Rate Limit Token from AI agent workflows via MCP or REST
• Integrate Consume Rate Limit Token into serverless functions with zero dependencies
• Build Consume Rate Limit Token functionality into any language that supports HTTP

API Reference

POST https://slopshop.gg/v1/orch-rate-limit-consume
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Input parameters

Example response

{
  "data": {
    "result": "success",
    "processed": true
  },
  "meta": {
    "credits_used": 1,
    "engine": "real",
    "ms": 4
  }
}

Examples

Three real-world scenarios showing how developers use Consume Rate Limit Token in production.

curl -X POST https://slopshop.gg/v1/orch-rate-limit-consume \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "sample input data"}'

curl -X POST https://slopshop.gg/v1/orch-rate-limit-consume \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "agent workflow input for consume rate limit token"}'

curl -X POST https://slopshop.gg/v1/orch-rate-limit-consume \
  -H "Authorization: Bearer $SLOPSHOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "production data payload"}'

Code examples

curl

curl -X POST https://slopshop.gg/v1/orch-rate-limit-consume \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "your data here"}'

Python

import requests

response = requests.post(
    "https://slopshop.gg/v1/orch-rate-limit-consume",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input": "your data here"}
)
result = response.json()
print(result["data"])

Node.js

const response = await fetch("https://slopshop.gg/v1/orch-rate-limit-consume", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ input: "your data here" })
});
const { data } = await response.json();
console.log(data);

CLI

# Install the Slopshop CLI
npm install -g slopshop

# Set your API key
export SLOPSHOP_KEY=your_api_key

# Call orch-rate-limit-consume
slop orch-rate-limit-consume '{"input": "your data here"}'

Pricing

Credits are purchased in bundles starting at $1 for 1,000 credits. All compute APIs like this one use 1 credit per call — that's $0.001. See all pricing tiers.

Related APIs in Orchestrate

• Async Delay API — Wait for a specified number of milliseconds (max 30000ms) before returning. Useful for implementing rate limiting, respecting API cooldown windows, or adding intentional pacing between steps in an agent workflow.
• Retry API Call with Backoff API — Retry a Slopshop API call up to N times with configurable backoff strategy (linear, exponential, or fixed) and jitter. Specify which error codes should trigger a retry vs abort. Returns the first successful response or final error.
• Parallel API Calls API — Execute multiple Slopshop API calls concurrently and return all results when all complete (or when any fail, depending on mode). Each call is specified as slug + input. Returns results in input order with per-call timing.
• Race API Calls API — Execute multiple Slopshop API calls concurrently and return the result of whichever completes first. Remaining calls are cancelled. Useful for calling multiple redundant sources and taking the fastest successful response.
• API Call with Timeout API — Execute a Slopshop API call and fail with a timeout error if it does not complete within the specified milliseconds. Returns the result on success or a structured timeout error with elapsed time on failure.

View the full API catalog · Try in playground · Documentation