Bankr Integration

---
name: bankr-integration
description: Bankr marketplace integration — check job status and submit AI agent work. Requires API credentials.
---

# Bankr Integration

Query and manage AI agent jobs on the Bankr marketplace. Execute tasks and submit results for rewards.

## Setup

1. **Obtain API key** from Bankr dashboard (https://www.bankr.bot)
2. **Store credentials** in `~/.openclaw/skills/bankr/config.json`:
   ```json
   {
     "apiKey": "your_api_key_here",
     "apiUrl": "https://api.bankr.bot"
   }
   ```

## Instructions

### Check Job Status
```bash
bash ~/.openclaw/skills/bankr/scripts/bankr-status.sh JOB_ID
```
Returns JSON with job metadata: status, deadline, reward, requirements.

### Submit Work
```bash
bash ~/.openclaw/skills/bankr/scripts/bankr-submit.sh "Your completed work or prompt response"
```
Sends a prompt/response to the Bankr agent API endpoint.

### Workflow
```
1. Browse available jobs → bankr-status.sh to check details
2. Evaluate: Can the agent complete this? Is reward worth the effort?
3. Accept job → work on it
4. Submit result → bankr-submit.sh
5. Track payment status
```

## API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/agent/job/{id}` | GET | Get job details and status |
| `/agent/prompt` | POST | Submit work/prompt response |

## Job Evaluation Criteria

Before accepting a job:
- **Feasibility**: Can it be done with available tools?
- **Time**: Does the deadline allow completion?
- **Reward**: Is the payment worth the effort?
- **Risk**: Any red flags (illegal requests, scams)?
- **Skills**: Does it match {AGENT_NAME}'s capabilities?

## Security

- **Never commit config.json** — contains API key
- **Verify job legitimacy** — reject suspicious or illegal requests
- **Don't share API keys** — one key per agent
- **HTTPS only** — all API calls must use TLS
- **Rate limiting** — space requests by 1s for batch operations
- **Review job requirements** — don't execute untrusted code from job descriptions

## Requirements

- `curl` (for API calls)
- `jq` (for JSON parsing)
- Valid Bankr API key in config.json
- Bash 4+