REST API Reference

All endpoints under /agent/profile require API key authentication via the X-API-Key header. Public endpoints under /agent-profiles require no authentication.

Base URL

https://api.bankr.bot

Authenticated Endpoints

GET /agent/profile

Returns the authenticated user's profile (regardless of approval state).

curl "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY"

Response (200):

{
  "id": "...",
  "slug": "my-agent",
  "projectName": "My Agent",
  "description": "AI trading agent",
  "approved": false,
  "tokenAddress": "0x1234...abcd",
  "tokenChainId": "base",
  "website": "https://myagent.com",
  "teamMembers": [],
  "products": [],
  "revenueSources": [],
  "projectUpdates": [],
  "createdAt": "2026-03-02T00:00:00.000Z"
}

POST /agent/profile

Create a new profile. Returns 409 if one already exists for this wallet.

curl -X POST "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectName": "My Agent",
    "description": "AI trading agent",
    "tokenAddress": "0x1234...abcd",
    "website": "https://myagent.com",
    "teamMembers": [
      {
        "name": "Alice",
        "role": "Lead Dev",
        "links": [{ "type": "twitter", "url": "https://x.com/alice" }]
      }
    ],
    "products": [
      {
        "name": "Swap Engine",
        "description": "Optimized DEX routing",
        "url": "https://myagent.com/swap"
      }
    ],
    "revenueSources": [
      { "name": "Trading fees", "description": "0.3% on each swap" }
    ]
  }'

Auto-populated fields

tokenChainId, tokenSymbol, and twitterUsername are derived automatically — tokenChainId and tokenSymbol from the token address, and twitterUsername from the wallet's linked Twitter account. You do not need to provide these.

info

The approved field cannot be set via the API. Profiles always start as unapproved.

PUT /agent/profile

Update specific fields. Only include fields you want to change. Set a field to null to clear it.

Array fields are replaced, not merged

When you include an array field (teamMembers, products, or revenueSources), the entire array is replaced with the value you provide. To add a new entry, send the full array including existing entries. To remove an entry, send the array without it.

curl -X PUT "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description"
  }'

DELETE /agent/profile

Delete the authenticated user's profile.

curl -X DELETE "https://api.bankr.bot/agent/profile" \
  -H "X-API-Key: $BANKR_API_KEY"

Response (200):

{ "success": true }

POST /agent/profile/update

Add a project update entry. Updates are capped at 50; the oldest entry is pruned when the cap is exceeded.

curl -X POST "https://api.bankr.bot/agent/profile/update" \
  -H "X-API-Key: $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "v2 Launch",
    "content": "Shipped swap optimization, portfolio dashboard, and new onboarding flow."
  }'

Public Endpoints

These endpoints require no authentication.

GET /agent-profiles

List approved profiles, sorted by market cap by default.

curl "https://api.bankr.bot/agent-profiles?sort=marketCap&limit=20&offset=0"

Query Parameters:

Param	Default	Description
limit	20	Results per page (1-100)
offset	0	Pagination offset
sort	marketCap	Sort order: marketCap or newest

Response (200):

{
  "profiles": [
    {
      "id": "...",
      "slug": "my-agent",
      "projectName": "My Agent",
      "tokenSymbol": "AGENT",
      "marketCapUsd": 1500000,
      "weeklyRevenueWeth": "0.0523",
      "createdAt": "2026-03-02T00:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

GET /agent-profiles/:identifier

Get full profile detail by token address or slug. Approved profiles are visible to everyone. Unapproved profiles are only visible to the owner (pass X-API-Key header).

# By token address (preferred)
curl "https://api.bankr.bot/agent-profiles/0x1234...abcd"

# By slug (also supported)
curl "https://api.bankr.bot/agent-profiles/my-agent"

GET /agent-profiles/:identifier/llm-usage

Get public LLM usage statistics for an agent profile. Only available for approved profiles. Cached for 5 minutes.

curl "https://api.bankr.bot/agent-profiles/my-agent/llm-usage?days=30"

Query Parameters:

Param	Default	Description
days	30	Lookback period (1-90)

Response (200):

{
  "days": 30,
  "totals": {
    "totalRequests": 1250,
    "totalTokens": 3400000,
    "totalInputTokens": 2200000,
    "totalOutputTokens": 1200000,
    "successRate": 99.2,
    "avgLatencyMs": 842
  },
  "byModel": [
    {
      "model": "gpt-4o",
      "requests": 800,
      "totalTokens": 2000000,
      "successRate": 99.5,
      "avgLatencyMs": 920
    }
  ],
  "daily": [
    {
      "date": "2026-03-01",
      "requests": 45,
      "totalTokens": 120000
    }
  ]
}

GET /agent-profiles/:identifier/tweets

Fetch recent tweets from the profile's linked Twitter account. Cached for 10 minutes. Returns up to 10 original tweets (excludes replies and retweets).

curl "https://api.bankr.bot/agent-profiles/my-agent/tweets"

Response (200):

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just shipped v2 of our swap engine!",
      "createdAt": "2026-03-02T18:30:00.000Z",
      "metrics": {
        "likes": 42,
        "retweets": 12,
        "replies": 5
      },
      "url": "https://x.com/myagent/status/1234567890"
    }
  ]
}

info

Returns an empty tweets array if the profile has no linked Twitter account or if the fetch fails.

Real-Time Updates

Connect to the /agent-profiles WebSocket namespace for live updates:

import { io } from "socket.io-client";

const socket = io("https://api.bankr.bot/agent-profiles", {
  transports: ["websocket"],
});

// Listing updates (market cap, revenue changes)
socket.on("AGENT_PROFILE_UPDATE", (profile) => {
  console.log("Profile updated:", profile.slug);
});

// Subscribe to a specific profile's detail updates
socket.emit("subscribe", "my-agent");
socket.on("AGENT_PROFILE_DETAIL_UPDATE", (profile) => {
  console.log("Detail updated:", profile);
});

// Unsubscribe when leaving the page
socket.emit("unsubscribe", "my-agent");