DAO Details

Read-only DAO-scoped endpoints accessible with DAO tokens.

Get DAO details

get

Returns detailed information about a single DAO.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

Responses

200

DAO details

application/json

addressstringRequired

owner_addressstringRequired

namestringRequired

jetton_addressstringRequired

success_percentagenumberRequired

total_supplystringRequired

date_createstringRequired

crowdfunding_statusstring · enumRequiredPossible values:

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

404

Requested resource was not found.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address} HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "address": "0:698fb737c352c9691994ed676fa5718243d15f11ed7c89d85d1f29e20ee5304c",
  "owner_address": "0:a8f9f41035f7c2208d3e8842f6f2f2df8ab3f9496fba4d472f7f01d8cb9c0011",
  "name": "TON Growth DAO",
  "jetton_address": "0:de3d0f1a5bcb8e3127f0d2b2f9ef4e95f620fbe22088697f7bf7b9a1e83400aa",
  "jetton_metadata": {
    "metadata": {
      "name": "TON Growth DAO",
      "symbol": "TGDAO",
      "image": "https://cdn.xdao.app/tokens/tgdao.png"
    }
  },
  "success_percentage": 51,
  "total_supply": "1000000000000",
  "date_create": "2026-01-15 12:10:44",
  "crowdfunding_status": "enabled",
  "plugins": [
    {
      "address": "0:4d96f12f4cfde1a9e7e4559f6c16f9342f44e6e981a4f440e36ac2ad5d9f9988",
      "type": "lpManagerV65",
      "lp_manager_index": 1,
      "lp_jetton_master_address": "0:ca11ab1e7a7c51ec9d6f132a33f7b34a04965af7d15e9c8f2f9b2df8f3168891",
      "lp_token_name": "XDAO LP",
      "lp_token_symbol": "XLP",
      "lp_token_image": "https://cdn.xdao.app/tokens/xlp.png",
      "subaccount_index": null,
      "subaccount_name": null
    }
  ]
}

Get DAO holders

get

Returns paginated list of DAO holders.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

Query parameters

limitinteger · min: 1 · max: 1000Optional

Page size.

Default: 100

offsetintegerOptional

Pagination offset.

Default: 0

Responses

200

DAO holder list

application/json

totalinteger · int64Required

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}/holders

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address}/holders HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 2,
  "items": [
    {
      "jetton_wallet_address": "0:1111111111111111111111111111111111111111111111111111111111111111",
      "owner_address": "0:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "balance": "1250000000"
    },
    {
      "jetton_wallet_address": "0:2222222222222222222222222222222222222222222222222222222222222222",
      "owner_address": "0:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "balance": "980000000"
    }
  ]
}

Get DAO proposals

get

Returns paginated list of proposals for a DAO.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

Query parameters

limitinteger · min: 1 · max: 1000Optional

Page size.

Default: 100

offsetintegerOptional

Pagination offset.

Default: 0

Responses

200

DAO proposal list

application/json

totalinteger · int64Required

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}/proposals

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address}/proposals HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 1,
  "items": [
    {
      "proposal_id": 42,
      "name": "Treasury rebalance",
      "description": "Reallocate treasury assets",
      "is_user_voted": false,
      "address": "0:0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f",
      "dao_address": "0:698fb737c352c9691994ed676fa5718243d15f11ed7c89d85d1f29e20ee5304c",
      "jetton_master_address": "0:de3d0f1a5bcb8e3127f0d2b2f9ef4e95f620fbe22088697f7bf7b9a1e83400aa",
      "initiated_by_address": "0:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "success_amount": "510000000000",
      "current_amount": "312000000000",
      "total_supply": "1000000000000",
      "success_percentage": 51,
      "date_start": "2026-03-10 10:00:00",
      "date_expire": "2026-03-17 10:00:00",
      "type": "generic",
      "data": {
        "title": "Treasury rebalance",
        "action": "transfer"
      },
      "status": "active",
      "raw_data": "b5ee9c720101010100...",
      "dao": {
        "address": "0:698fb737c352c9691994ed676fa5718243d15f11ed7c89d85d1f29e20ee5304c",
        "owner_address": "0:a8f9f41035f7c2208d3e8842f6f2f2df8ab3f9496fba4d472f7f01d8cb9c0011",
        "name": "TON Growth DAO",
        "jetton_address": "0:de3d0f1a5bcb8e3127f0d2b2f9ef4e95f620fbe22088697f7bf7b9a1e83400aa",
        "jetton_metadata": {
          "metadata": {
            "symbol": "TGDAO"
          }
        },
        "success_percentage": 51,
        "total_supply": "1000000000000",
        "date_create": "2026-01-15 12:10:44",
        "crowdfunding_status": "enabled",
        "plugins": []
      }
    }
  ]
}

Get proposal votes

get

Returns paginated votes for a DAO proposal.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

proposal_addressstringRequired

Proposal address in raw format.

Query parameters

limitinteger · min: 1 · max: 1000Optional

Page size.

Default: 100

offsetintegerOptional

Pagination offset.

Default: 0

Responses

200

Proposal votes list

application/json

totalinteger · int64Required

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}/proposals/{proposal_address}/votes

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address}/proposals/{proposal_address}/votes HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 2,
  "items": [
    {
      "proposal_address": "0:0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f",
      "voter_address": "0:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "amount": "50000000000",
      "date_create": "2026-03-11 11:24:10"
    },
    {
      "proposal_address": "0:0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f",
      "voter_address": "0:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "amount": "21000000000",
      "date_create": "2026-03-11 11:25:22"
    }
  ]
}

Get DAO crowdfunding campaigns

get

Returns paginated crowdfunding campaigns for a DAO.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

Query parameters

limitinteger · min: 1 · max: 1000Optional

Page size.

Default: 100

offsetintegerOptional

Pagination offset.

Default: 0

Responses

200

DAO crowdfunding campaign list

application/json

totalinteger · int64Required

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}/crowdfundings

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address}/crowdfundings HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 1,
  "items": [
    {
      "address": "0:9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a",
      "daoAddress": "0:698fb737c352c9691994ed676fa5718243d15f11ed7c89d85d1f29e20ee5304c",
      "status": "active",
      "name": "DAO Seed Round",
      "description": "Seed round for protocol growth",
      "daoName": "TON Growth DAO",
      "isNative": true,
      "jettonSymbol": null,
      "jettonDecimals": null,
      "jettonImage": null,
      "jettonMasterAddress": "",
      "lpManagerAddress": "0:7777777777777777777777777777777777777777777777777777777777777777",
      "lpJettonMasterAddress": "0:8888888888888888888888888888888888888888888888888888888888888888",
      "destinationAddress": "0:9999999999999999999999999999999999999999999999999999999999999999",
      "feeManagerAddress": "0:1212121212121212121212121212121212121212121212121212121212121212",
      "minTotalAmount": "100000000000",
      "maxTotalAmount": "1000000000000",
      "minAmountPerUser": "1000000000",
      "maxAmountPerUser": "50000000000",
      "startTime": "2026-03-01T00:00:00Z",
      "endTime": "2026-04-01T00:00:00Z",
      "lpPrice": "1000000000",
      "managementFee": 200,
      "paused": false,
      "totalAmount": "250000000000",
      "totalClaimed": "0",
      "totalRefunded": "0",
      "isEmergencyWithdrawn": false,
      "hasWhitelist": false,
      "whitelist": [],
      "contributors": [],
      "participantsCount": 123,
      "progressPercentage": 25,
      "updatedAt": "2026-03-11T13:00:00Z",
      "finishedAt": "0001-01-01T00:00:00Z",
      "daoFeeClaimed": false,
      "daoFeeClaimedAt": null,
      "daoFeeAmount": "5000000000",
      "dao": {
        "address": "0:698fb737c352c9691994ed676fa5718243d15f11ed7c89d85d1f29e20ee5304c",
        "owner_address": "0:a8f9f41035f7c2208d3e8842f6f2f2df8ab3f9496fba4d472f7f01d8cb9c0011",
        "name": "TON Growth DAO",
        "jetton_address": "0:de3d0f1a5bcb8e3127f0d2b2f9ef4e95f620fbe22088697f7bf7b9a1e83400aa",
        "jetton_metadata": {
          "metadata": {
            "symbol": "TGDAO"
          }
        },
        "success_percentage": 51,
        "total_supply": "1000000000000",
        "date_create": "2026-01-15 12:10:44",
        "crowdfunding_status": "enabled",
        "plugins": []
      }
    }
  ]
}

Get DAO LP masters with LP holders

get

Returns LP masters and nested LP holders for a DAO.

Authorizations

DaoBearerAuth

AuthorizationstringRequired

DAO service token in Bearer format. The token must be valid, not revoked, and authorized for the same dao_address as in path.

Path parameters

dao_addressstringRequired

DAO address in raw format.

Query parameters

masters_limitinteger · min: 1 · max: 1000OptionalDefault: 100

masters_offsetintegerOptionalDefault: 0

holders_limitinteger · min: 1 · max: 1000OptionalDefault: 100

holders_offsetintegerOptionalDefault: 0

Responses

200

DAO LP masters with LP holders

application/json

totalinteger · int64Required

401

Token is missing, invalid, expired, or revoked.

application/json

403

Token does not have access to this DAO or endpoint.

application/json

500

Internal server error.

application/json

get

/api/v1/daos/{dao_address}/lp-masters-with-lp-holders

HTTPcURLJavaScriptPython

GET /api/v1/daos/{dao_address}/lp-masters-with-lp-holders HTTP/1.1
Host: ton.xdao.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 1,
  "items": [
    {
      "lpJettonMasterAddress": "0:8888888888888888888888888888888888888888888888888888888888888888",
      "campaignAddresses": [
        "0:9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a9a"
      ],
      "holdersTotal": 2,
      "holders": [
        {
          "lpJettonWalletAddress": "0:abababababababababababababababababababababababababababababababab",
          "ownerAddress": "0:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "balance": "800000000"
        },
        {
          "lpJettonWalletAddress": "0:bcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbcbc",
          "ownerAddress": "0:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
          "balance": "250000000"
        }
      ]
    }
  ]
}