Create a crypto donation pledge

curl --request POST \
  --url https://api.endaoment.org/v1/donation-pledges/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cryptoGiven": {
    "inputAmount": "1000000000000000000",
    "tokenId": 1
  },
  "receivingEntityType": "fund",
  "receivingEntityId": "123e4567-e89b-12d3-a456-426614174000",
  "otcDonationTransactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "recommendationId": "123e4567-e89b-12d3-a456-426614174000",
  "isRebalanceRequested": false,
  "donorName": "<string>",
  "donorIdentity": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "address": {
      "line1": "123 Main Street",
      "city": "San Francisco",
      "line2": "Suite 100",
      "state": "CA",
      "zip": "94105",
      "country": "USA"
    }
  },
  "updateIdentity": false,
  "shareMyEmail": false
}
'

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Donation Pledges

Create a crypto donation pledge

Creates a new donation pledge for a cryptocurrency donation to Endaoment.

Minimum Donation Requirements: Please note we enforce a minimum on all donations of assets in this manner as they require manual processing. All sub-$250 donations are re-routed to Endaoment’s operating fund.

By proceeding, you accept our disclaimer for over-the-counter donations.

Authentication is optional:

Authenticated users will have the pledge associated with their account
Unauthenticated users can still create pledges but won’t have them linked to any account

This endpoint allows users to:

Register their crypto donation with Endaoment, alongside the transaction hash proving the donation happened on-chain
Specify the amount and receiving fund
Optionally provide donor identity information for the donation receipt

If you are donating crypto via the Endaoment smart contract functions, please use the ‘donations’ endpoint instead to register your donation.

POST

donation-pledges

crypto

Create a crypto donation pledge

curl --request POST \
  --url https://api.endaoment.org/v1/donation-pledges/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cryptoGiven": {
    "inputAmount": "1000000000000000000",
    "tokenId": 1
  },
  "receivingEntityType": "fund",
  "receivingEntityId": "123e4567-e89b-12d3-a456-426614174000",
  "otcDonationTransactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "recommendationId": "123e4567-e89b-12d3-a456-426614174000",
  "isRebalanceRequested": false,
  "donorName": "<string>",
  "donorIdentity": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "[email protected]",
    "address": {
      "line1": "123 Main Street",
      "city": "San Francisco",
      "line2": "Suite 100",
      "state": "CA",
      "zip": "94105",
      "country": "USA"
    }
  },
  "updateIdentity": false,
  "shareMyEmail": false
}
'

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

Authorization

string

header

required

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

Body

application/json

cryptoGiven

object

required

Asset that was pledged to the entity

Show child attributes

cryptoGiven.inputAmount

string

required

The input amount of the token that was given, in its smallest unit of a token

Example:

"1000000000000000000"

cryptoGiven.tokenId

number

required

The ID of the token that was given. The full list of tokens and their IDs can be found in the GET /v2/tokens endpoint.

Example:

1

receivingEntityType

enum<string>

required

The type of the entity receiving the pledge

Available options:

org,

fund,

subproject

Example:

"fund"

receivingEntityId

string<uuid>

required

The ID of the entity receiving the pledge

Example:

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

otcDonationTransactionHash

string

Transaction hash proving that the asset was sent to the entity

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

recommendationId

string<uuid>

The ID of the recommendation that led to the pledge

Example:

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

isRebalanceRequested

boolean

default:false

Whether the fund needs it's investments rebalanced after the pledge is deemed fulfilled

Example:

false

donorName

string

Optional donor name the donor might want to expose to the receiving entity

donorIdentity

object

Optional identity information to be used in the donation receipt

Show child attributes

donorIdentity.firstName

string

required

First name of the donor

Maximum string length: 255

Example:

"John"

donorIdentity.lastName

string

required

Last name of the donor

Maximum string length: 255

Example:

"Doe"

donorIdentity.email

string<email>

required

Email address of the donor

Example:

"[email protected]"

donorIdentity.address

object

required

Physical address of the donor

Show child attributes

donorIdentity.address.line1

string

required

First line of the address

Maximum string length: 255

Example:

"123 Main Street"

donorIdentity.address.city

string

required

City name

Maximum string length: 255

Example:

"San Francisco"

donorIdentity.address.line2

object

Second line of the address (optional)

Example:

"Suite 100"

donorIdentity.address.state

object

State/Province/Region. Required if country is USA

Example:

"CA"

donorIdentity.address.zip

string | null

Postal/ZIP code. Required if country is USA

Maximum string length: 255

Example:

"94105"

donorIdentity.address.country

enum<string>

default:USA

Three-letter ISO country code. Defaults to USA

Available options:

ABW,

AFG,

AGO,

AIA,

ALA,

ALB,

AND,

ARE,

ARG,

ARM,

ASM,

ATA,

ATF,

ATG,

AUS,

AUT,

AZE,

BDI,

BEL,

BEN,

BES,

BFA,

BGD,

BGR,

BHR,

BHS,

BIH,

BLM,

BLR,

BLZ,

BMU,

BOL,

BRA,

BRB,

BRN,

BTN,

BVT,

BWA,

CAF,

CAN,

CCK,

CHE,

CHL,

CHN,

CIV,

CMR,

COD,

COG,

COK,

COL,

COM,

CPV,

CRI,

CUB,

CUW,

CXR,

CYM,

CYP,

CZE,

DEU,

DJI,

DMA,

DNK,

DOM,

DZA,

ECU,

EGY,

ERI,

ESH,

ESP,

EST,

ETH,

FIN,

FJI,

FLK,

FRA,

FRO,

FSM,

GAB,

GBR,

GEO,

GGY,

GHA,

GIB,

GIN,

GLP,

GMB,

GNB,

GNQ,

GRC,

GRD,

GRL,

GTM,

GUF,

GUM,

GUY,

HKG,

HMD,

HND,

HRV,

HTI,

HUN,

IDN,

IMN,

IND,

IOT,

IRL,

IRN,

IRQ,

ISL,

ISR,

ITA,

JAM,

JEY,

JOR,

JPN,

KAZ,

KEN,

KGZ,

KHM,

KIR,

KNA,

KOR,

KWT,

LAO,

LBN,

LBR,

LBY,

LCA,

LIE,

LKA,

LSO,

LTU,

LUX,

LVA,

MAC,

MAF,

MAR,

MCO,

MDA,

MDG,

MDV,

MEX,

MHL,

MKD,

MLI,

MLT,

MMR,

MNE,

MNG,

MNP,

MOZ,

MRT,

MSR,

MTQ,

MUS,

MWI,

MYS,

MYT,

NAM,

NCL,

NER,

NFK,

NGA,

NIC,

NIU,

NLD,

NOR,

NPL,

NRU,

NZL,

OMN,

PAK,

PAN,

PCN,

PER,

PHL,

PLW,

PNG,

POL,

PRI,

PRK,

PRT,

PRY,

PSE,

PYF,

QAT,

REU,

ROU,

RUS,

RWA,

SAU,

SDN,

SEN,

SGP,

SGS,

SHN,

SJM,

SLB,

SLE,

SLV,

SMR,

SOM,

SPM,

SRB,

SSD,

STP,

SUR,

SVK,

SVN,

SWE,

SWZ,

SXM,

SYC,

SYR,

TCA,

TCD,

TGO,

THA,

TJK,

TKL,

TKM,

TLS,

TON,

TTO,

TUN,

TUR,

TUV,

TWN,

TZA,

UGA,

UKR,

UMI,

URY,

USA,

UZB,

VAT,

VCT,

VEN,

VGB,

VIR,

VNM,

VUT,

WLF,

WSM,

XKX,

YEM,

ZAF,

ZMB,

ZWE

Example:

"USA"

updateIdentity

boolean

Inform if user wants to update their global identity based on the informed donation identity

Example:

false

Whether the donor wants to share their email with the org

Example:

false

Response

Crypto donation pledge successfully created

string<uuid>

required

Unique identifier of the created donation pledge

Example:

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

Remove a collaborator from a fund Create a stock donation pledge

⌘I

About

Quickstart

Endpoints

Smart Contracts

Create a crypto donation pledge

Authorizations

Body

Response