v1

latestOpenAPI 3.0.02026-07-2464438356.8 KB

Accounts

Create an Account

Creates a Mural Account that you can deposit funds into and perform payouts from.

post/api/accounts

Headers

on-behalf-ofstring

Organization ID to act on behalf of

Request body

descriptionstring

The description of the Account

namestring required

The name of the Account

Example request

{
  "developerFees": {
    "payinsDeveloperFees": [
      {
        "developerFeePercentage": 2.5,
        "type": "usd"
      },
      {
        "developerFeePercentage": 1.8,
        "type": "eur"
      },
      {
        "developerFeePercentage": 2,
        "type": "mxn"
      },
      {
        "developerFeePercentage": 1.5,
        "type": "brl"
      },
      {
        "developerFeePercentage": 2,
        "type": "ars"
      }
    ]
  }
}

Response

Create an Account

createdAtstring date-time required

descriptionstring

The description of the Account

idstring uuid required

The unique identifier for the Account

isApiEnabledboolean required

Whether or not the Account can be managed by the API. Accounts created in the platform will not be enabled unless you grant API access to the Account in the platform.

namestring required

The name of the Account

status'INITIALIZING' | 'ACTIVE' required

The status of the Account. Will start in INITIALIZING and move to ACTIVE once the Account is ready to use.

updatedAtstring date-time required

Example response

{
  "accountDetails": {
    "balancesV2": [
      {
        "exponent": 6,
        "value": "2500000"
      }
    ],
    "payinMethods": [
      {
        "supportedDestinationTokens": [
          {
            "fees": {
              "fixedTransactionFee": {
                "fiatCurrencyCode": "USD"
              }
            },
            "transactionMinimum": {
              "fiatCurrencyCode": "USD"
            }
          }
        ]
      }
    ],
    "walletDetails": {
      "walletAddress": "0x0000000000000000000000000000000000000000"
    }
  }
}