Agora Finance Public Documentation

curl -X POST https://api.sandbox.agora.finance/v0/accounts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "address": "0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6",
  "kind": "wallet",
  "name": "ETH treasury",
  "networks": [
    "ethereum-sepolia"
  ]
}'

{
  "address": "0xf5E6d7C8b9A0f5E6d7C8b9A0f5E6d7C8b9A0f5E6",
  "addressFormat": "ethereum",
  "createdAt": "2026-04-02T14:15:00Z",
  "id": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
  "kind": "wallet",
  "name": "ETH treasury",
  "networks": [
    {
      "chain": "ethereum-sepolia",
      "entitlements": [
        {
          "status": "conditionally_approved",
          "type": "mint"
        },
        {
          "status": "pending_approval",
          "type": "instant_settlement"
        }
      ]
    }
  ]
}

Register a customer-owned account under the authenticated organization. Set kind to wallet to register a blockchain address (supply the networks it should be registered on; EVM hex is normalized to lowercase) or bank to register a fiat account.

Registering a wallet starts mint and (where supported) instant_settlement entitlements on the requested networks. See Wallet entitlements for how they are approved and when the wallet is usable. Registering the same address on a network it already holds returns 409.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Request

This endpoint expects an object.

WalletobjectRequired

Bank AccountobjectRequired

Response

Walletobject

Customer-owned blockchain address (CustomerAddress).

Bank Accountobject

Customer-owned bank account (WireDetail).

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error