Post transaction

Creates a new financial transaction record in the guild ledger. Positive amounts are deposits (money goes up), negative amounts are withdrawals (money goes down). Optional explicit type validation helps catch exploiters.

POST /guild/ledger

Create Ledger Transaction

cURL

curl --request POST \
  --url https://api.multex.tech/guild/ledger \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "robloxId": "<string>",
  "name": "<string>",
  "quantity": 2,
  "amount": 123,
  "source": "<string>",
  "deposit": true,
  "withdrawal": true
}
'

200

{
  "success": true,
  "message": "Transaction Posted (deposit)",
  "type": "deposit"
}

Required Scopes

guild:write

Rate Limit

10 requests per second

Authorizations

x-api-key · string · header · required

API key for accessing protected guild endpoints

Body

application/json

robloxId · string · required

Roblox user ID of the player

name · string · required

Name of the transaction (item name, etc.)

quantity · number · required

Quantity of items in the transaction

Required range: x >= 1

amount · number · required

Amount per item (positive = deposit, negative = withdrawal)

source · string · required

Source of the transaction

deposit · boolean

Optional: explicitly mark as deposit for validation

withdrawal · boolean

Optional: explicitly mark as withdrawal for validation

Response

200

application/json

Transaction created successfully

success · boolean

Example:

true

message · string

Example:

"Transaction Posted (deposit)"

type · enum<string>

Available options: deposit, withdrawal

Example:

"deposit"