Register an Account | Agora Finance

The endpoints exposed here are currently in Beta! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution.

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.

<Callout intent="warning"> The endpoints exposed here are currently in **Beta**! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution. </Callout> 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](/api/endpoints/accounts/overview#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>.

Request

This endpoint expects an object.

objectRequired

Response

object

Customer-owned blockchain address (CustomerAddress).

object

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

$	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"
>	]
>	}'

1	{
2	"address": "0xf5E6d7C8b9A0f5E6d7C8b9A0f5E6d7C8b9A0f5E6",
3	"addressFormat": "ethereum",
4	"createdAt": "2026-04-02T14:15:00Z",
5	"id": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
6	"kind": "wallet",
7	"name": "ETH treasury",
8	"networks": [
9	{
10	"chain": "ethereum",
11	"entitlements": [
12	{
13	"status": "conditionally_approved",
14	"type": "mint"
15	},
16	{
17	"status": "pending_approval",
18	"type": "instant_settlement"
19	}
20	]
21	}
22	]
23	}