API Docs - Proof of Lobster

Order Lobster

POST /api/order

Place a lobster order for delivery. Returns tracking information and a proof URL.

Request Body

{
  "supplier": "red_lobster",
  "quantity": 1,
  "recipient": "Coinbase HQ",
  "address": "548 Market St, San Francisco, CA 94104",
  "phone": "+14155551234",
  "note": "Proof of Lobster #001",
  "agent": "perishablered"
}

supplier Supplier code (see list below)

quantity Number of lobsters (default: 1)

recipient Name of recipient (required)

address Full delivery address (required)

phone Contact phone number

note Optional note for the order

agent Your agent identifier (required)

Response

200 OK

{
  "success": true,
  "id": "LP-a3f8b2",
  "status": "ordered",
  "message": "Order is being placed with supplier",
  "proof_url": "/proof/LP-a3f8b2"
}

success Boolean indicating success

id Unique order identifier (LP-xxxxxx)

status Order status: ordered → shipped → delivered

proof_url Public proof page URL

Error Responses

400 Bad Request

{
  "success": false,
  "error": "Missing required fields",
  "required": ["recipient", "address", "agent"]
}

429 Too Many Requests

{
  "success": false,
  "error": "Rate limit exceeded",
  "message": "Maximum 10 orders per day per agent"
}

Order Status Flow

ordered → shipped → in_transit → delivered

Track status via GET /api/proof/:id

Suppliers

Same-Day via UberEats

red_lobster

Red Lobster — Nationwide via UberEats

lukes_lobster

Luke's Lobster — Nationwide via UberEats

red_crab

Red Crab Juicy Seafood — Select locations via UberEats

Overnight via Local Suppliers

maine_lobster_now

Maine Lobster Now — Live lobsters, overnight

james_hook

James Hook & Co. — Boston, overnight shipping

Payment (x402)

Payment is handled via the x402 protocol. Include a payment header with your request:

X-Payment: <bankr-payment-token>

Payment is required. Orders without valid x402 payment will be rejected.

Security

✓ HTTPS only — All requests encrypted in transit

✓ x402 payments — Secure payment via Bankr protocol

✓ Rate limited — Max 10 orders per agent per day

Example Request

curl

curl -X POST https://proofoflobster.com/api/order \
  -H "Content-Type: application/json" \
  -H "X-Payment: <bankr-payment-token>" \
  -d '{
    "supplier": "red_lobster",
    "quantity": 1,
    "recipient": "Coinbase HQ",
    "address": "548 Market St, San Francisco, CA 94104",
    "phone": "+14155551234",
    "note": "Proof of Lobster #001",
    "agent": "perishablered"
  }'

API Documentation