> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.imbawallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IMBA Agent API

> Prepaid HTTP API for autonomous agents — register a key, fund USDT TRC-20, buy the catalog.

# IMBA Agent API

The Agent API is an HTTP interface for **programs that pay on their own**. Register an Ed25519 key, fund **USDT on TRC-20**, then buy the live catalog (virtual cards, eSIM, gift cards).

This is **not** the [Partner B2B API](/) (no `/api/partner`, no company KYB). It is **not** a human login to IMBA Wallet.

|              |                                                                                             |
| ------------ | ------------------------------------------------------------------------------------------- |
| **API host** | `https://imbawallet.com`                                                                    |
| **Docs**     | `https://api-docs.imbawallet.com/agent`                                                     |
| **HowTo**    | [imbawallet.com/agent\_api\_about\_en.html](https://imbawallet.com/agent_api_about_en.html) |
| **Support**  | [support@imbawallet.com](mailto:support@imbawallet.com)                                     |

Partner B2B uses a different host: `https://api.imbawallet.com`. Do not mix the two.

## What you can do

| Area     | Live default (tier 0)                                           |
| -------- | --------------------------------------------------------------- |
| Identity | Permissionless `POST /auth/v1/agent/register`                   |
| Money in | USDT **TRC-20 only** via `POST /api/deposit_address`            |
| Spend    | Cards, eSIM, gift cards from prepaid USDT (`ext_id` required)   |
| OTP      | Email + notifications inbox + optional HMAC webhook field `otp` |

## Closed by design

| Rail                          | Policy                                                                                                             |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Withdraw / C2C                | Closed                                                                                                             |
| Convert                       | Closed at **tier 0** (AML). At **tier 1** — [separate request](/agent/guides/tiers), not automatic with the number |
| Stars, EVM, BTC, RUB bank/SBP | Closed                                                                                                             |
| `/api/partner/*`              | Closed — that is a different product                                                                               |

## Flow

```
Your agent
  │  1. POST /auth/v1/agent/register (Ed25519 public key)
  ▼
  │  2. Sign 60s assertion (aud=imba-agent-api)
  ▼
POST /auth/v1/agent/token → Bearer typ=agent
  │  3. POST /api/deposit_address before every send
  ▼
USDT TRC-20 credit (after confirmation_blocks)
  │  4. POST catalog buys with ext_id
  ▼
Cards / eSIM / gifts
```

<CardGroup cols={2}>
  <Card title="Register" href="/agent/guides/register" icon="user-plus">
    Permissionless key register — identity only, no USDT
  </Card>

  <Card title="Authentication" href="/agent/guides/authentication" icon="key">
    Assertion JWT → access token
  </Card>

  <Card title="Deposit" href="/agent/guides/deposit" icon="coins">
    Re-fetch the TRON address every time
  </Card>

  <Card title="Tiers and convert" href="/agent/guides/tiers" icon="shield">
    AML: convert closed at 0, request-only at 1
  </Card>
</CardGroup>