Galxe Integration (Quest Platform)
Galxe is the largest Web3 quest platform with 20+ million users. Used for on-chain verification of task completion: Twitter subscription, governance voting participation, protocol usage, token holding. Integration is needed by projects that want to distribute OAT (On-chain Achievement Token) or credentials to their users via standard infrastructure, not build their own.
Two Integration Modes
Subgraph-based verification — Galxe reads data from your subgraph deployed on The Graph. Suitable for on-chain actions: transactions, swaps, liquidity provision. You write GraphQL schema and mappings, deploy the subgraph, provide its URL in the Galxe Dashboard campaign settings.
API-based verification — you provide an HTTPS endpoint that Galxe calls with the user's wallet address. Response: {"is_eligible": true/false}. Suitable for any custom logic — off-chain data, combined conditions, whitelist files. Endpoint must be publicly accessible and respond in <5 seconds.
// Example verification endpoint (Express)
app.get('/galxe/verify', async (req, res) => {
const { address } = req.query;
const eligible = await checkEligibility(address as string);
res.json({ is_eligible: eligible });
});
Galxe doesn't provide authorization in the request — if you need protection from direct polling, add shared secret via query param or IP whitelist (Galxe provides their IP list).
Credential and OAT
After verification Galxe issues Credential — off-chain record of user achievement. Based on it you can configure OAT issuance (Soul-bound NFT on Galxe Chain) or access to next quests.
For custom NFT rewards instead of OAT, use Galxe Smart Contract integration — your project's contract is deployed, Galxe calls claim() on behalf of user upon quest completion. This requires separate setup in Galxe Business Dashboard and contract verification.
Practical Points
Galxe Dashboard is intuitive enough for basic campaign setup without API. Development is needed in two cases: custom verification endpoint and Galxe Points / Galxe ID integration in your frontend via Galxe GraphQL API (https://graphigo.prd.galaxy.eco/query). The API lets you read user data, credentials, and achievements for display in your dApp.