Quick Start

Make your first API call

This section uses POST /feign/wallet/account/create as the first-call example. Replace placeholders with your Test environment values.

1) Configure environment

TODO – Requires Obita input: Provide Test & Live base URLs, and the required authentication header(s).

export OBITA_BASE_URL="https://api-test.obita.example"  # TODO
export OBITA_AUTH="Bearer <your_token>"               # TODO

2) Create a wallet

Request body is based on CreateWalletRequest from the spec.

curl -X POST "{BASE_URL}/feign/wallet/account/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: {TODO_AUTH}" \
  -d '{"walletName": "Demo Wallet", "walletType": "Saas", "subtype": "Asset", "ownerType": "Merchant", "ownerId": "mch_123456"}'

Example response

{
  "code": "",
  "msg": "",
  "data": {
    "walletId": "",
    "addresses": [
      {
        "chainId": 0,
        "address": "",
        "chainName": ""
      }
    ]
  },
  "timestamp": 0
}

Node.js example

import fetch from "node-fetch";

const res = await fetch(`${process.env.OBITA_BASE_URL}/feign/wallet/account/create`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": process.env.OBITA_AUTH ?? "TODO_AUTH",
  },
  body: JSON.stringify({
  "walletName": "Demo Wallet",
  "walletType": "Saas",
  "subtype": "Asset",
  "ownerType": "Merchant",
  "ownerId": "mch_123456"
}),
});

const json = await res.json();
console.log(json);

Python example