GET
/
v1
/
funds
/
{id}
Get fund by ID
curl --request GET \
  --url https://api.endaoment.org/v1/funds/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Doe Family Foundation",
  "type": "Private",
  "manager": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  },
  "chainId": 1,
  "deploymentTransactionHash": "0xf89f7da1e5d79dcb1b8863d0926fe41204785b443ce2d1dca4bf50070c492567",
  "contractAddress": "0x1234567890123456789012345678901234567890",
  "advisor": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "featuredIndex": 1,
  "usdcBalance": "20500000",
  "lastBalanceSyncUtc": "2024-03-14T12:00:00Z",
  "description": "A family foundation dedicated to supporting educational initiatives",
  "shortDescription": "Supporting education",
  "vanityUrl": "doe-family-foundation",
  "paypalId": "123e4567-e89b-12d3-a456-426614174000",
  "logo": "https://example.com/logo.png",
  "createdAtUtc": "2024-01-01T00:00:00Z",
  "updatedAtUtc": "2024-03-14T12:00:00Z",
  "lifetimeDonationsUsdc": "1000000000",
  "staffNotes": "<string>",
  "category": "Education",
  "inboundFeeBps": 25,
  "outboundFeeBps": 50,
  "customFeeDetail": "Special Community Fund Agreement",
  "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
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The unique identifier of the fund

Response

Fund details successfully retrieved

​
id
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.

​
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.

​
featuredIndex
number
required

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

Example:

1

​
usdcBalance
string
required

Current USDC balance with 6 decimal places (1000000 = 1 USDC)

Example:

"20500000"

​
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 with 6 decimal places

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 with 6 decimal places

Example:

"5000000"

​
inTransitSellUsdcAmount
string
required

Amount of USDC pending sale with 6 decimal places

Example:

"3000000"

​
investedUsdc
string
required

Total amount invested in USDC with 6 decimal places

Example:

"50000000"

​
totalGrantedUsdc
string
required

Total amount granted in USDC with 6 decimal places

Example:

"25000000"

​
processingTransfersTotalUsdc
string
required

Total amount in processing transfers in USDC with 6 decimal places

Example:

"1000000"

​
illiquidBalance
string
required

Total balance in illiquid portfolios in USDC with 6 decimal places

Example:

"10000000"

​
poolDetails
object
required

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

​
expectedDeploymentInfo
object
required

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

​
deploymentTransactionHash
object | null

Transaction hash of the deployment transaction

Example:

"0xf89f7da1e5d79dcb1b8863d0926fe41204785b443ce2d1dca4bf50070c492567"

​
contractAddress
object | null

Contract address of the fund

Example:

"0x1234567890123456789012345678901234567890"

​
lastBalanceSyncUtc
object | null

UTC timestamp of the last balance sync

Example:

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

​
shortDescription
object | null

Brief description of the fund

Example:

"Supporting education"

​
vanityUrl
object | null

Custom URL identifier for the fund

Example:

"doe-family-foundation"

​
paypalId
object | null

PayPal merchant ID associated with the fund

Example:

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

URL of the fund's logo image

Example:

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

​
staffNotes
string | null

Internal notes about the fund (staff only)

​
category
object | null

Category of the fund (e.g., Education, Health)

Example:

"Education"

​
customFeeDetail
object | null

Details about why this fund has custom fees. Only set if either inbound or outbound fee is custom

Example:

"Special Community Fund Agreement"