imbawallet-com Catalog API

Cards, eSIM, gifts, and catalog reads

Operations 7

GET /api/deposit_address Prepaid USDT balance #
POST /api/card_products List card products #
POST /api/cards List this agent's cards #
POST /api/pin/create_card Issue a virtual card from prepaid USDT #
POST /api/pin/topup_card Top up a card from prepaid USDT #
POST /api/offers List gift offers #
POST /api/purchase Buy a gift card from prepaid USDT #

Specifications

Schemas & Data

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/imbawallet-com:imbawallet-com-catalog-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

imbawallet-com-catalog-api-openapi.yml Raw ↑
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