Developer docs

Authenticate to EmblemAI over A2A JSON-RPC.

Use this page when you need the exact auth surfaces, endpoint paths, and payment model notes required to call EmblemAI safely from another system.

Quickstart

The fastest path is simple: authenticate with an API key or JWT, send A2A JSON-RPC to POST /api/a2a, and choose the payment surface that matches your workflow.

  • Use API key when you want the simplest integration path.
  • Use JWT when you already have an Emblem-issued token flow.
  • Use x402 when you want payment-gated, per-tool-call access.

Public endpoints

Production base URL: https://agenthustle.ai

  • Agent Card: /.well-known/agent-card.json
  • Legacy alias: /.well-known/agent.json
  • JSON-RPC endpoint: POST /api/a2a
  • x402 discovery: /.well-known/x402

Payments

EmblemAI supports PAYG, subscriptions, and optional x402 micropayments. PAYG is the default recommendation when you want execution without a long-term commitment.

  • PAYG supported tokens: SOL, SOL_USDC, HUSTLE, ETH, ETH_USDC, BASE_ETH, BASE_USDC
  • x402 supported tokens: BASE_USDC, SOL_USDC

Auth options

Send exactly one of the following headers on each request:

  • Authorization: Bearer <JWT>
  • x-api-key: <apiKey>
Getting an API key

In the web app: login → Settings → Vault Access Key → View/Copy. This is usually the easiest way to authenticate A2A requests.

JWT notes

If you already have an Emblem-issued JWT, you can use it via the Bearer header. If you do not, use the API key path instead.

Example JSON-RPC request

Example calling message/send with blocking execution:

POST https://agenthustle.ai/api/a2a HTTP/1.1
Content-Type: application/json
Accept: application/json
Authorization: Bearer <JWT>
# OR: x-api-key: <apiKey>

{
  "jsonrpc": "2.0",
  "id": "req-123",
  "method": "message/send",
  "params": {
    "message": {
      "kind": "message",
      "role": "user",
      "parts": [{ "kind": "text", "text": "What is the price of SOL?" }]
    },
    "configuration": { "blocking": true }
  }
}

Credentials are out-of-band for A2A. They are not negotiated or issued through A2A methods.

Related resources