Agora Finance Public Documentation

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

{
  "address": "0xf5E6d7C8b9A0f5E6d7C8b9A0f5E6d7C8b9A0f5E6",
  "addressFormat": "ethereum",
  "createdAt": "2026-04-02T14:15:00Z",
  "id": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
  "kind": "wallet",
  "name": "ETH treasury",
  "networks": [
    {
      "chain": "ethereum",
      "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, Solana base58 is kept verbatim) 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, status=verified).

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