agentra

Register as an agent and provision a non-custodial wallet. This is your FIRST CALL when onboarding to Agentra. Returns your agent_id, API key (agn_ prefix), and a Turnkey-managed wallet address on Base Sepolia. You hold the keys via Turnkey; Agentra never touches your private key. After this, call agentra_verify_identity to upgrade your trust tier.

{
  "properties": {
    "name": {
      "description": "Human-readable name for your agent (e.g. 'ShoppingBot-v2')",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "operator": {
      "description": "Optional. Your organization or operator name.",
      "type": "string"
    },
    "purpose": {
      "description": "What this agent does (e.g. 'automated trading', 'API access'). Defaults to 'autonomous'.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Submit identity verification to upgrade your trust tier. Higher tiers unlock larger transaction limits. Provide your agent_id (from agentra_create_wallet) and operator attestation. Verification is instant. Tiers: Unverified ($100/tx, $250/day) -> Basic ($1K/tx, $5K/day) -> Standard ($5K/tx, $10K/day) -> Enhanced ($25K/tx, $100K/day). Your API key (agn_ prefix) must be passed via X-API-Key header.

{
  "properties": {
    "agent_id": {
      "description": "Your agent ID from registration",
      "format": "uuid",
      "type": "string"
    },
    "operator_attestation": {
      "description": "Operator-signed attestation of agent identity and capabilities",
      "properties": {
        "attested_capabilities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "operator_domain": {
          "type": "string"
        },
        "operator_name": {
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}

CALL THIS BEFORE paying or transacting with unknown agents. Returns the target agent's trust score (0-100), trust tier, reputation zone (Green/Yellow/Red), and transaction history summary. Agentra scores BOTH sides of every transaction: you and your counterparty. This is a read-only lookup with no side effects. Monetized endpoint: response detail varies by your plan tier.

{
  "properties": {
    "agent_id": {
      "description": "The agent ID to check reputation for",
      "format": "uuid",
      "type": "string"
    },
    "include_history": {
      "default": false,
      "description": "Include recent transaction history summary (Standard+ plans)",
      "type": "boolean"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}

Request authorization for a payment to another agent or service. Agentra is NON-CUSTODIAL: this returns an authorization attestation and an unsigned transaction. Agentra never touches your private keys or moves your funds. YOU sign and submit the transaction yourself. Flow: (1) Call this endpoint -> (2) Receive unsigned tx + attestation -> (3) Sign with your Turnkey wallet -> (4) Submit to Base network -> (5) Call settle to record completion. If counterparty is unverified and require_counterparty_kya is true (default), you get a 402 challenge with instructions for the counterparty to onboard. This is Agentra's viral growth mechanism.

{
  "properties": {
    "amount_usdc": {
      "description": "Transaction amount in USDC as a string (e.g. '25.00')",
      "type": "string"
    },
    "purpose": {
      "description": "Human-readable transaction purpose",
      "maxLength": 64,
      "type": "string"
    },
    "receiver_address": {
      "description": "Recipient agent ID or external wallet address",
      "type": "string"
    },
    "require_counterparty_kya": {
      "default": true,
      "description": "Require counterparty to be KYA-verified. Default true. This is the viral growth hook: unverified counterparties must onboard to receive funds.",
      "type": "boolean"
    },
    "sender_agent_id": {
      "description": "Your agent ID (the sender)",
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "sender_agent_id",
    "receiver_address",
    "amount_usdc"
  ],
  "type": "object"
}

Create or update spending mandates that define your agent's autonomous transaction boundaries. Mandates enforce: max per-transaction amount, daily spending cap, allowed recipient types, minimum counterparty reputation score, and expiration. Your human operator sets these; your agent operates within them. require_counterparty_kya defaults to true. Recommended: true. This recruits counterparties into verification.

{
  "properties": {
    "agent_id": {
      "description": "Your agent ID",
      "format": "uuid",
      "type": "string"
    },
    "daily_limit_usd": {
      "description": "Maximum total USD spend per rolling 24h",
      "minimum": 0.001,
      "type": "number"
    },
    "expires_at": {
      "description": "Mandate expiration. Authorization rejected after this time.",
      "format": "date-time",
      "type": "string"
    },
    "max_per_tx_usd": {
      "description": "Maximum USD per single transaction",
      "minimum": 0.001,
      "type": "number"
    },
    "min_counterparty_score": {
      "description": "Minimum reputation score (0-100) for counterparties. 40 = exclude Red zone.",
      "maximum": 100,
      "minimum": 0,
      "type": "number"
    },
    "require_counterparty_kya": {
      "default": true,
      "description": "Require counterparty KYA verification on all outbound transactions",
      "type": "boolean"
    }
  },
  "required": [
    "agent_id",
    "max_per_tx_usd",
    "daily_limit_usd"
  ],
  "type": "object"
}

Get your agent profile and wallet details: trust tier, trust score, wallet address, registration status, and current verification level. Use to check your status before initiating transactions. Read-only, no side effects.

{
  "properties": {
    "agent_id": {
      "description": "Your Agentra agent ID",
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}