BoP Score Docs

Interactive API docs for a standalone trustless scoring product.

Clear contracts, runnable examples, and proof-attribution primitives by Bank of Bots.

Quickstart

Three commands to first intent.

Step 1

Authenticate

clibob

export BOB_API_KEY=bok_...
export BOB_API_URL=http://localhost:8080/api/v1
bob auth me

Step 2

Create and inspect an agent

clibob

bob agent get <agent-id>
bob wallet list <agent-id>
bob policy list <agent-id>

Step 3

Quote and execute payment intent

clibob

bob intent quote <agent-id> --amount 2500 \
  --destination-type bank_counterparty \
  --destination-ref <counterparty-id>
bob intent execute <agent-id> <intent-id>

API Reference

Interactive endpoint explorer.

Base URL: https://api.bankofbots.ai/api/v1 • Auth: Authorization: Bearer <api_key>

POST/api/v1/agents/{agent_id}/payment-intents

Create a quoted payment intent

Builds an intent with ranked rails, fee projection, and settlement ETA guidance.

Parameters

agent_idpath · uuid · requiredOwning agent identifier.

amountbody · integer · requiredSmallest unit amount (cents/sats).

destination_typebody · enum · requiredOne of raw | bank_counterparty | unit_account | bob_address.

destination_refbody · string · requiredDestination handle or resource id.

prioritybody · enum · optionalcheapest | fastest | balanced.

Request Example

curl

curl -X POST "$BOB_API_URL/agents/$AGENT_ID/payment-intents" \
  -H "Authorization: Bearer $BOB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500,
    "destination_type": "bank_counterparty",
    "destination_ref": "cp_123",
    "priority": "balanced"
  }'

request body schema

{
  "amount": 2500,
  "destination_type": "bank_counterparty",
  "destination_ref": "cp_123",
  "priority": "balanced"
}