Create fund

curl --request POST \
  --url https://api.endaoment.org/v1/funds/partner \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Lovelace Family DAF",
  "partnerAccountIdentifier": "a7e21d94-5c3f-4b8a-9f60-2e4d8c1b7a53",
  "description": "A family DAF managed through a partner integration",
  "type": "Private",
  "partnerUserIdentifier": "c3f8b2e4-9d1a-4f6b-8e2c-7a5d90c41b3f"
}
'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Doe Family Foundation",
  "type": "Private",
  "manager": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  },
  "chainId": 1,
  "advisor": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "featuredIndex": 1,
  "usdcBalance": "20500000",
  "availableBalance": "21000000",
  "description": "A family foundation dedicated to supporting educational initiatives",
  "createdAtUtc": "2024-01-01T00:00:00Z",
  "updatedAtUtc": "2024-03-14T12:00:00Z",
  "lifetimeDonationsUsdc": "1000000000",
  "inboundFeeBps": 25,
  "outboundFeeBps": 50,
  "grantsGiven": 10,
  "inTransitBuyUsdcAmount": "5000000",
  "inTransitSellUsdcAmount": "3000000",
  "investedUsdc": "50000000",
  "totalGrantedUsdc": "25000000",
  "processingTransfersTotalUsdc": "1000000",
  "illiquidBalance": "10000000",
  "poolDetails": {
    "eligibleEntities": "Organizations",
    "algorithmType": "QuadraticFunding",
    "distributionSchedule": "Quarterly",
    "distributionPercentage": 0.25,
    "eligibleVotes": "GrantsAndDonations",
    "voteWeight": "UsdcValue"
  },
  "expectedDeploymentInfo": {
    "expectedManagerAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "expectedSalt": "0x0000000000000000000000000000000000000000000000000000000000000123",
    "expectedComputedAddress": "0x1234567890123456789012345678901234567890",
    "expectedChainId": 1
  },
  "deploymentTransactionHash": "0xf89f7da1e5d79dcb1b8863d0926fe41204785b443ce2d1dca4bf50070c492567",
  "contractAddress": "0x1234567890123456789012345678901234567890",
  "lastBalanceSyncUtc": "2024-03-14T12:00:00Z",
  "shortDescription": "Supporting education",
  "vanityUrl": "doe-family-foundation",
  "paypalId": "123e4567-e89b-12d3-a456-426614174000",
  "logo": "https://example.com/logo.png",
  "staffNotes": "<string>",
  "category": "Education",
  "customFeeDetail": "Special Community Fund Agreement"
}

Partner Endpoints

Create fund

Creates a partner-managed DAF using the acting user identity and partnerAccountIdentifier idempotency.

The acting user is resolved in one of two ways:

Tech-platform impersonation: a partner API key plus the x-endaoment-user-id user header (or partner OIDC bearer).
API-key-only body resolution: a partner API key plus a body partnerUserIdentifier and no impersonation header, available when partner inflow routes are enabled. The identifier selects a partner-owned, previously provisioned user.

When both a header/OIDC user and a body partnerUserIdentifier are supplied they must resolve to the same user; a contradiction is rejected with 400 and an identifier that does not match a user for this partner is 404.

POST

funds

partner

Create fund

curl --request POST \
  --url https://api.endaoment.org/v1/funds/partner \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Lovelace Family DAF",
  "partnerAccountIdentifier": "a7e21d94-5c3f-4b8a-9f60-2e4d8c1b7a53",
  "description": "A family DAF managed through a partner integration",
  "type": "Private",
  "partnerUserIdentifier": "c3f8b2e4-9d1a-4f6b-8e2c-7a5d90c41b3f"
}
'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Doe Family Foundation",
  "type": "Private",
  "manager": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  },
  "chainId": 1,
  "advisor": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "featuredIndex": 1,
  "usdcBalance": "20500000",
  "availableBalance": "21000000",
  "description": "A family foundation dedicated to supporting educational initiatives",
  "createdAtUtc": "2024-01-01T00:00:00Z",
  "updatedAtUtc": "2024-03-14T12:00:00Z",
  "lifetimeDonationsUsdc": "1000000000",
  "inboundFeeBps": 25,
  "outboundFeeBps": 50,
  "grantsGiven": 10,
  "inTransitBuyUsdcAmount": "5000000",
  "inTransitSellUsdcAmount": "3000000",
  "investedUsdc": "50000000",
  "totalGrantedUsdc": "25000000",
  "processingTransfersTotalUsdc": "1000000",
  "illiquidBalance": "10000000",
  "poolDetails": {
    "eligibleEntities": "Organizations",
    "algorithmType": "QuadraticFunding",
    "distributionSchedule": "Quarterly",
    "distributionPercentage": 0.25,
    "eligibleVotes": "GrantsAndDonations",
    "voteWeight": "UsdcValue"
  },
  "expectedDeploymentInfo": {
    "expectedManagerAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "expectedSalt": "0x0000000000000000000000000000000000000000000000000000000000000123",
    "expectedComputedAddress": "0x1234567890123456789012345678901234567890",
    "expectedChainId": 1
  },
  "deploymentTransactionHash": "0xf89f7da1e5d79dcb1b8863d0926fe41204785b443ce2d1dca4bf50070c492567",
  "contractAddress": "0x1234567890123456789012345678901234567890",
  "lastBalanceSyncUtc": "2024-03-14T12:00:00Z",
  "shortDescription": "Supporting education",
  "vanityUrl": "doe-family-foundation",
  "paypalId": "123e4567-e89b-12d3-a456-426614174000",
  "logo": "https://example.com/logo.png",
  "staffNotes": "<string>",
  "category": "Education",
  "customFeeDetail": "Special Community Fund Agreement"
}

Authorizations

x-api-key

string

header

required

Headers

x-endaoment-user-id

string

UUID of the Endaoment user to act as. Optional when a body partnerUserIdentifier is supplied on an API-key-only request (no impersonation header).

x-api-key

string

Partner API key. Required for server-to-server partner flows; omit when the caller presents a registered OAuth client access token via Bearer auth.

Body

application/json

name

string

required

Name of the fund

Maximum string length: 255

Example:

"Lovelace Family DAF"

partnerAccountIdentifier

string

required

Opaque partner-generated identifier for this fund, used as the partner-scoped idempotency key. Must be 16-64 printable ASCII characters; leading/trailing whitespace is trimmed before validation.

Required string length: 16 - 64

Pattern: ^[\x20-\x7E]{16,64}$

Example:

"a7e21d94-5c3f-4b8a-9f60-2e4d8c1b7a53"

description

string

Description of the fund. Defaults to the partner DAF name when omitted.

Example:

"A family DAF managed through a partner integration"

type

enum<string>

Type of the fund being created.

Available options:

Private,

Transparent

Example:

"Private"

partnerUserIdentifier

string

Opaque partner-generated identifier for the acting user. Used only to resolve or corroborate the user; it is not stored on the fund or returned in the response.

Required string length: 16 - 64

Pattern: ^[\x20-\x7E]{16,64}$

Example:

"c3f8b2e4-9d1a-4f6b-8e2c-7a5d90c41b3f"

Response

An existing partner-managed fund was returned idempotently.

string

required

Unique identifier of the fund

Example:

"123e4567-e89b-12d3-a456-426614174000"

name

string

required

Name of the fund

Example:

"Doe Family Foundation"

type

enum<string>

required

Access type of the fund

Available options:

Private,

Community,

Transparent,

ImpactPool

Example:

"Private"

manager

object

required

Basic information about the fund manager. The manager has technical capability to interact with the blockchain and perform programmatic functions.

Show child attributes

chainId

object

required

Chain ID where the fund is deployed

Example:

1

advisor

object

required

Fund advisor information. The advisor is tied to a real-world person/entity and acts as the public contact for the fund. This can be the same person as the manager or someone the manager acts on behalf of.

Show child attributes

featuredIndex

number

required

Index determining the fund's position in featured listings. Lower numbers appear first

Example:

1

usdcBalance

string

required

Current synced USDC balance in the smallest currency unit (1000000 = 1 USD). This does not account for asynchronous grants, asynchronous entity transfers, or asynchronous investments that may still be processing.

Example:

"20500000"

availableBalance

string

required

Amount available to grant or transfer in the smallest currency unit (1000000 = 1 USD), adjusted for invested value, in-transit portfolio operations, and pending asynchronous transfers.

Example:

"21000000"

description

string

required

Detailed description of the fund

Example:

"A family foundation dedicated to supporting educational initiatives"

createdAtUtc

string

required

UTC timestamp of fund creation

Example:

"2024-01-01T00:00:00Z"

updatedAtUtc

string

required

UTC timestamp of last fund update

Example:

"2024-03-14T12:00:00Z"

lifetimeDonationsUsdc

string

required

Total lifetime donations received in USDC, in the smallest currency unit (1000000 = 1 USD)

Example:

"1000000000"

inboundFeeBps

number

required

The fee charged for inbound operations in basis points (1 basis point = 0.01%)

Example:

25

outboundFeeBps

number

required

The fee charged for outbound operations in basis points (1 basis point = 0.01%)

Example:

50

grantsGiven

number

required

Total number of grants given by this fund

Example:

10

inTransitBuyUsdcAmount

string

required

Amount of USDC pending purchase in the smallest currency unit (1000000 = 1 USD)

Example:

"5000000"

inTransitSellUsdcAmount

string

required

Amount of USDC pending sale in the smallest currency unit (1000000 = 1 USD)

Example:

"3000000"

investedUsdc

string

required

Total amount invested in USDC, in the smallest currency unit (1000000 = 1 USD)

Example:

"50000000"

totalGrantedUsdc

string

required

Total amount granted in USDC, in the smallest currency unit (1000000 = 1 USD)

Example:

"25000000"

processingTransfersTotalUsdc

string

required

Total amount in processing transfers in USDC, in the smallest currency unit (1000000 = 1 USD)

Example:

"1000000"

illiquidBalance

string

required

Total balance in illiquid portfolios in USDC, in the smallest currency unit (1000000 = 1 USD)

Example:

"10000000"

poolDetails

object

required

Impact Pool specific details. Only available for Impact Pool type funds

Show child attributes

expectedDeploymentInfo

object

required

Information needed for on-chain deployment. Only available for funds not yet deployed

Show child attributes

deploymentTransactionHash

object

Transaction hash of the deployment transaction

Example:

"0xf89f7da1e5d79dcb1b8863d0926fe41204785b443ce2d1dca4bf50070c492567"

contractAddress

object

Contract address of the fund

Example:

"0x1234567890123456789012345678901234567890"

lastBalanceSyncUtc

object

UTC timestamp of the last balance sync

Example:

"2024-03-14T12:00:00Z"

shortDescription

object

Brief description of the fund

Example:

"Supporting education"

vanityUrl

object

Custom URL identifier for the fund

Example:

"doe-family-foundation"

paypalId

object

PayPal merchant ID associated with the fund

Example:

"123e4567-e89b-12d3-a456-426614174000"

logo

object

URL of the fund's logo image

Example:

"https://example.com/logo.png"

staffNotes

string | null

Internal notes about the fund (staff only)