To connect to the XP API, you will need an authentication key provided by the XP team.

You can request one here ->

Valid score submission

  1. You must be approved with a valid api key to submit scores to this endpoint.

  2. For a score to take effect, you must also sign the update with a wallet address that is approved as an "owner" or "updater" for that specific XP Project Id. (Can be added in your dashboard/Directly on contract)


Connect using the "X-API-KEY" header in your request


Example Request

let myHeaders = new Headers();
let message =;
let signatureObject = await web3.eth.accounts.sign(message, <PRIVATE_KEY>);
let signature = signatureObject.signature;

myHeaders.append("Content-Type", "application/json");
  //Send to API
    const body = JSON.stringify({
        "updateId": updateId,
        "projectId": <PROJECT_ID>,
        "actionName": <action-name>,
        "scoreType": <scoreType>,
        "targetWallet": <targetAddress>,
        "signature": signature,
        "message": message
    const requestOptions = {
        method: 'POST',
        headers: myHeaders,
        body: body,
        redirect: 'follow'
    let response = await fetch(', requestOptions).then(async (response) => ({ status: response.status, value: await response.text() }));

Last updated