Skip to main content
POST
/
v1
/
programs
/
{id}
/
assets
/
{assetId}
/
fund
Fund a program
curl --request POST \
  --url https://api.scrip.dev/v1/programs/{id}/assets/{assetId}/fund \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount": "10000.00",
  "description": "Initial program funding for Q1"
}
'
{
  "available": "10000.00",
  "journal_entry_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Program funded successfully"
}
Adds funds to a program’s wallet for a specific PREFUNDED asset. This is how you set a budget. Every CREDIT action on this asset draws from the wallet, and credits fail when the wallet is empty. This endpoint has no effect on UNLIMITED assets, which mint value on demand and bypass the wallet entirely.
For usage patterns and examples, see the Programs guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

​
id
string<uuid>
required

Program ID

​
assetId
string<uuid>
required

Asset ID

Body

application/json

Funding details

​
amount
string
required

Decimal amount to add to the wallet

Minimum string length: 1
Example:

"10000.00"

​
description
string

Reason for this funding

Maximum string length: 500
Example:

"Initial program funding for Q1"

Response

Funding successful

​
available
string

Wallet balance after the operation

Example:

"10000.00"

​
journal_entry_id
string<uuid>

Ledger journal entry created by this operation

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
message
string

Confirmation message

Example:

"Program funded successfully"