Bankr Dev API Workflow

This is a reference implementation for Bankr's async API pattern: submit a prompt, poll for status every 2 seconds, handle the terminal state. It's the kind of thing you'd use if you're building against the Bankr Agent API and need Claude to help you follow their three-step job workflow correctly. The skill documents the endpoints and expected flow, which is helpful if you're tired of looking up whether it's /agent/job or /job/agent for the fifth time today. Nothing fancy here, just a structured way to keep the submit-poll-complete pattern consistent across your codebase. If you're not using Bankr's API, this won't do anything for you.

GitHub stars: 80
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add bankrbot/claude-plugins --skill 'Bankr Dev - API Workflow' --agent claude-code

Installs into .claude/skills of the current project.

Files

API Workflow

Complete reference for the asynchronous job pattern used by the Bankr Agent API.

Core Pattern: Submit-Poll-Complete

1. SUBMIT  -> POST /agent/prompt   -> Get jobId + threadId
2. POLL    -> GET /agent/job/{id}  -> Check status every 2s
3. COMPLETE -> Terminal status      -> Process response + richData

Endpoints

POST /agent/prompt

const response = await fetch(`${API_URL}/agent/prompt`, {
  method: "POST",
  headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    prompt: "What is my ETH balance?",
    threadId: "thr_XYZ789", // optional: continue conversation
  }),
});
// → { success: true, jobId: "job_abc123", threadId: "thr_XYZ789", status: "pending" }

Request fields:

prompt (string, required): Natural language prompt (max 10,000 chars)
threadId (string, optional): Continue existing conversation. Omit for new thread.

GET /agent/job/{jobId}

const status = await fetch(`${API_URL}/agent/job/${jobId}`, {
  headers: { "x-api-key": API_KEY },
});

POST /agent/job/{jobId}/cancel

SKILL.md on GitHub

Details

Repository: github.com/bankrbot/claude-plugins
Categories: Backend & APIs, AI & Agent Building, Automation & Workflows
First seen: Jun 3, 2026