Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: IMBA Agent Catalog API
version: 0.1.0
summary: Prepaid HTTP API for autonomous agents
description: 'Permissionless prepaid agents: register an Ed25519 key, fund USDT on TRC-20,
buy the live catalog (virtual cards, eSIM, gift cards).
- API host: `https://imbawallet.com`
- Human docs: `https://api-docs.imbawallet.com/agent`
- HowTo: `https://imbawallet.com/agent_api_about_en.html`
- Not Partner B2B (`POST /api/partner/*` on this same host)
- Not a human Wallet HS256 session
- Access JWT: `typ=agent`, `client_id`, EdDSA (same JWKS as Partner)
- Tier 0 (default): catalog spend only. Convert closed (AML).
- Tier 1+: operator reputation after real catalog spend. Convert is a
separate request — raising the number does not turn convert on.
- Withdraw stays closed. The agent JWT cannot send C2C; a human Wallet
user may C2C to this client_id.'
contact:
name: IMBA Agent Support
email: support@imbawallet.com
license:
name: Proprietary
url: https://imbawallet.com
servers:
- url: https://imbawallet.com
description: Production (auth + retail /api)
security:
- bearerAuth: []
tags:
- name: Catalog
description: Cards, eSIM, gifts, and catalog reads
paths:
/api/deposit_address:
get:
operationId: getAgentBalance
tags:
- Catalog
summary: Prepaid USDT balance
description: Spendable prepaid USDT for this `client_id` after confirmed TRON credit.
responses:
'200':
description: Balance snapshot
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
/api/card_products:
post:
operationId: listAgentCardProducts
tags:
- Catalog
summary: List card products
description: Use product `id` as `imba_product_id` on `create_card`. Space catalog reads ~1s apart (`catalog_gap` otherwise 429).
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: true
responses:
'200':
description: Product list
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
/api/cards:
post:
operationId: listAgentCards
tags:
- Catalog
summary: List this agent's cards
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: true
responses:
'200':
description: Cards for this agent JWT
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
/api/pin/create_card:
post:
operationId: createAgentCard
tags:
- Catalog
summary: Issue a virtual card from prepaid USDT
description: '`ext_id` is required. `imba_product_id` comes from `POST /api/card_products`.
`payment_source=stars` → 403. Do not send `client_id`.'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCardRequest'
responses:
'200':
description: Accepted or completed
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
/api/pin/topup_card:
post:
operationId: topupAgentCard
tags:
- Catalog
summary: Top up a card from prepaid USDT
description: '`card_id` must belong to this agent. `ext_id` required. Stars → 403.'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TopupCardRequest'
responses:
'200':
description: Accepted or completed
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
'403':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/Error'
/api/offers:
post:
operationId: listAgentGiftOffers
tags:
- Catalog
summary: List gift offers
requestBody:
content:
application/json:
schema:
type: object
properties:
query:
type: string
maxLength: 64
responses:
'200':
description: Offer list
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Error'
/api/purchase:
post:
operationId: purchaseAgentGift
tags:
- Catalog
summary: Buy a gift card from prepaid USDT
description: '`ext_id` required. `payment_source=stars` → 403.'
requestBody:
required: true
content:
application/json: sc
components:
schemas:
TopupCardRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
CreateCardRequest:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
responses:
Error:
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true