> For a complete index of Agora Finance documentation, fetch https://docs.agora.finance/llms.txt # Register an Account POST https://api.agora.finance/v0/accounts Content-Type: application/json 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`. Reference: https://docs.agora.finance/api/endpoints/accounts/create ## Authentication - `Authorization` header (bearer token, required) — Session JWT from `POST /v0/auth/token`, sent as `Authorization: Bearer `. See [Authentication](/api/authentication) for more details. ## Request ### Body (application/json) This endpoint expects an accounts_create_Request. - `accounts_create_Request` ## Response ### 201 OK - `accounts_create_Response_201` ## Errors ### 400 Bad Request Error One or more request parameters are invalid. - `code` (enum, required) - Allowed values: `parameter_invalid` - `docs_url` (string, required) - `message` (string, required) - `context` (ErrorResponse400ParameterInvalidContext, optional) ### 401 Unauthorized Error Authentication is required. - `code` (enum, required) - Allowed values: `unauthorized` - `docs_url` (string, required) - `message` (string, required) - `context` (ErrorResponse401UnauthorizedContext, optional) ### 403 Forbidden Error The account is not eligible for the requested route direction. - `code` (enum, required) - Allowed values: `account_not_eligible`, `account_not_provisioned`, `account_verification_pending`, `forbidden` - `docs_url` (string, required) - `message` (string, required) ### 404 Not Found Error Resource not found. - `code` (enum, required) - Allowed values: `not_found` - `docs_url` (string, required) - `message` (string, required) ### 409 Conflict Error An account with these details already exists. - `code` (enum, required) - Allowed values: `account_already_exists` - `docs_url` (string, required) - `message` (string, required) ### 429 Too Many Requests Error Too many requests. - `code` (enum, required) - Allowed values: `rate_limit_exceeded` - `docs_url` (string, required) - `message` (string, required) ### 500 Internal Server Error An unexpected error occurred. - `code` (enum, required) - Allowed values: `internal_error` - `docs_url` (string, required) - `message` (string, required) ## Types ### Wallet - `kind` (enum, required) — Discriminator: register a customer-owned blockchain address. - Allowed values: `wallet` - `address` (string, required) — On-chain address to register. EVM hex is normalized to lowercase; Solana base58 is kept verbatim. - `networks` (list of enum, required) — Networks to register this address on. Each must be compatible with the address format. - Allowed values: `arbitrum`, `avalanche`, `base`, `binance-smart-chain`, `core`, `ethereum`, `fraxtal`, `gnosis`, `immutable`, `injective`, `katana`, `mantle`, `monad`, `plume`, `polygon-pos`, `solana`, `sui` - `name` (string, optional) — User-set label. Free-form; max 200 characters. ### Bank Account - `kind` (enum, required) — Discriminator: register a customer-owned bank account. - Allowed values: `bank` - `accountNumber` (string, required) — Bank account number. 6-100 uppercase letters and digits; embedded spaces are ignored. - `bankName` (string, required) — Name of the receiving bank. - `beneficiary` (string, required) — Account-holder name on the wire. Part of the account's identity (with routing + account number): omnibus/custodian accounts share one account number across beneficiaries, so this disambiguates them. - `routingNumber` (string, required) — ABA routing number (US) or SWIFT/BIC (international). 6-100 uppercase letters and digits; embedded spaces are ignored. - `name` (string, optional) — User-set label. Free-form; max 200 characters. ### Wallet Customer-owned blockchain address (CustomerAddress). - `id` (string, required) — Stable UUID identifying this account; safe to cache or display. - `address` (string, required) — On-chain address. EIP-55 checksummed for EVM (`ethereum`), base58 for Solana. - `addressFormat` (enum, required) — Address syntax family. `ethereum` covers every EVM chain (Ethereum, Base, Polygon, Arbitrum, etc.); per-chain authorization is enforced separately via the account's chain entitlements. - Allowed values: `ethereum`, `solana` - `createdAt` (datetime, required) — ISO-8601 UTC timestamp when this address was added to the org. - `kind` (enum, required) — Discriminator: this is a customer-owned blockchain address. - Allowed values: `wallet` - `name` (string, required) — User-set label. Free-form; may be empty if the user hasn't set one. - `networks` (list of V0AccountsPostResponsesContentApplicationJsonSchemaOneOf0NetworksItems, required) — The networks this address is registered on, each with its per-type entitlement states. ### Bank Account Customer-owned bank account (WireDetail, status=verified). - `id` (string, required) — Stable UUID identifying this account; safe to cache or display. - `accountNumber` (string, required) — Full bank account number. - `bankName` (string, required) — Name of the receiving bank. - `beneficiary` (string, required) — Account-holder name on the wire. Part of the account's identity: distinguishes accounts that share a routing + account number (e.g. omnibus/custodian accounts holding several funds under one account number). - `createdAt` (datetime, required) — ISO-8601 UTC timestamp when this account was added to the org. - `currency` (enum, required) — Settlement currency. Today only `usd`; will extend as new currencies launch. - Allowed values: `usd` - `kind` (enum, required) — Discriminator: this is a customer-owned bank account. - Allowed values: `bank` - `name` (string, required) — User-set label. Free-form; may be empty if the user hasn't set one. - `routingNumber` (string, required) — ABA routing number identifying the receiving bank. A public bank identifier, returned in full. ### ErrorResponse400ParameterInvalidContext - `issues` (list of ErrorResponse400ParameterInvalidContextIssuesItems, required) ### ErrorResponse401UnauthorizedContext - `reason` (enum, required) - Allowed values: `invalid_token`, `key_not_provisioned`, `missing_claim`, `missing_header`, `token_expired`, `token_paused`, `token_revoked`, `unknown_tenant` ### V0AccountsPostResponsesContentApplicationJsonSchemaOneOf0NetworksItems Per-network entitlement state for the wallet. - `chain` (enum, required) — Network the wallet is registered on (kebab-case public network id). - Allowed values: `arbitrum`, `avalanche`, `base`, `binance-smart-chain`, `core`, `ethereum`, `fraxtal`, `gnosis`, `immutable`, `injective`, `katana`, `mantle`, `monad`, `plume`, `polygon-pos`, `solana`, `sui` - `entitlements` (list of V0AccountsPostResponsesContentApplicationJsonSchemaOneOf0NetworksItemsEntitlementsItems, required) — Entitlement states on this network, one per type the wallet holds on the chain. ### ErrorResponse400ParameterInvalidContextIssuesItems - `field` (string, required) - `message` (string, required) ### V0AccountsPostResponsesContentApplicationJsonSchemaOneOf0NetworksItemsEntitlementsItems - `type` (enum, required) — Entitlement type. `mint` is the mint capability gated by the per-chain compliance scan; `instant_settlement` is the instant-settlement whitelist; `rewards` is rewards eligibility. - Allowed values: `instant_settlement`, `mint`, `rewards` - `status` (enum, required) — Entitlement status. `pending_approval` is requested and under Agora review; `approved` is active. `conditionally_approved` applies to `mint` only: the address is usable now (screening and whitelisting are auto-initiated) while final approval is still pending internally. `instant_settlement` and `rewards` stay `pending_approval` until reviewed. The API never auto-approves. - Allowed values: `approved`, `conditionally_approved`, `pending_approval`, `pending_removal`, `rejected`, `removed` ## Examples ### Wallet **Request** ```json { "address": "0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6", "kind": "wallet", "name": "ETH treasury", "networks": [ "ethereum" ] } ``` **Response** ```json { "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" } ] } ] } ``` **SDK Code** ```python Wallet import requests url = "https://api.agora.finance/v0/accounts" payload = { "address": "0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6", "kind": "wallet", "name": "ETH treasury", "networks": ["ethereum"] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Wallet const url = 'https://api.agora.finance/v0/accounts'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"address":"0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6","kind":"wallet","name":"ETH treasury","networks":["ethereum"]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Wallet package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.agora.finance/v0/accounts" payload := strings.NewReader("{\n \"address\": \"0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6\",\n \"kind\": \"wallet\",\n \"name\": \"ETH treasury\",\n \"networks\": [\n \"ethereum\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Wallet require 'uri' require 'net/http' url = URI("https://api.agora.finance/v0/accounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"address\": \"0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6\",\n \"kind\": \"wallet\",\n \"name\": \"ETH treasury\",\n \"networks\": [\n \"ethereum\"\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Wallet import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.agora.finance/v0/accounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"address\": \"0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6\",\n \"kind\": \"wallet\",\n \"name\": \"ETH treasury\",\n \"networks\": [\n \"ethereum\"\n ]\n}") .asString(); ``` ```php Wallet request('POST', 'https://api.agora.finance/v0/accounts', [ 'body' => '{ "address": "0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6", "kind": "wallet", "name": "ETH treasury", "networks": [ "ethereum" ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Wallet using RestSharp; var client = new RestClient("https://api.agora.finance/v0/accounts"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"address\": \"0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6\",\n \"kind\": \"wallet\",\n \"name\": \"ETH treasury\",\n \"networks\": [\n \"ethereum\"\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Wallet import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "address": "0xf5e6d7c8b9a0f5e6d7c8b9a0f5e6d7c8b9a0f5e6", "kind": "wallet", "name": "ETH treasury", "networks": ["ethereum"] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.agora.finance/v0/accounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Bank account **Request** ```json { "accountNumber": "483910277", "bankName": "JPMorgan Chase", "beneficiary": "Acme Corp Operating", "kind": "bank", "name": "Operating USD wire", "routingNumber": "021000021" } ``` **Response** ```json { "accountNumber": "483910277", "bankName": "JPMorgan Chase", "beneficiary": "Acme Corp Operating", "createdAt": "2026-04-02T14:12:00Z", "currency": "usd", "id": "8b3e4f12-9a7c-4d8e-b1f0-2c5d6e7a8b9c", "kind": "bank", "name": "Operating USD wire", "routingNumber": "021000021" } ``` **SDK Code** ```python Bank account import requests url = "https://api.agora.finance/v0/accounts" payload = { "accountNumber": "483910277", "bankName": "JPMorgan Chase", "beneficiary": "Acme Corp Operating", "kind": "bank", "name": "Operating USD wire", "routingNumber": "021000021" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Bank account const url = 'https://api.agora.finance/v0/accounts'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"accountNumber":"483910277","bankName":"JPMorgan Chase","beneficiary":"Acme Corp Operating","kind":"bank","name":"Operating USD wire","routingNumber":"021000021"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Bank account package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.agora.finance/v0/accounts" payload := strings.NewReader("{\n \"accountNumber\": \"483910277\",\n \"bankName\": \"JPMorgan Chase\",\n \"beneficiary\": \"Acme Corp Operating\",\n \"kind\": \"bank\",\n \"name\": \"Operating USD wire\",\n \"routingNumber\": \"021000021\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Bank account require 'uri' require 'net/http' url = URI("https://api.agora.finance/v0/accounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"accountNumber\": \"483910277\",\n \"bankName\": \"JPMorgan Chase\",\n \"beneficiary\": \"Acme Corp Operating\",\n \"kind\": \"bank\",\n \"name\": \"Operating USD wire\",\n \"routingNumber\": \"021000021\"\n}" response = http.request(request) puts response.read_body ``` ```java Bank account import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.agora.finance/v0/accounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"accountNumber\": \"483910277\",\n \"bankName\": \"JPMorgan Chase\",\n \"beneficiary\": \"Acme Corp Operating\",\n \"kind\": \"bank\",\n \"name\": \"Operating USD wire\",\n \"routingNumber\": \"021000021\"\n}") .asString(); ``` ```php Bank account request('POST', 'https://api.agora.finance/v0/accounts', [ 'body' => '{ "accountNumber": "483910277", "bankName": "JPMorgan Chase", "beneficiary": "Acme Corp Operating", "kind": "bank", "name": "Operating USD wire", "routingNumber": "021000021" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Bank account using RestSharp; var client = new RestClient("https://api.agora.finance/v0/accounts"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"accountNumber\": \"483910277\",\n \"bankName\": \"JPMorgan Chase\",\n \"beneficiary\": \"Acme Corp Operating\",\n \"kind\": \"bank\",\n \"name\": \"Operating USD wire\",\n \"routingNumber\": \"021000021\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Bank account import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "accountNumber": "483910277", "bankName": "JPMorgan Chase", "beneficiary": "Acme Corp Operating", "kind": "bank", "name": "Operating USD wire", "routingNumber": "021000021" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.agora.finance/v0/accounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```