Welcome to the Goat Arena API documentation. Below are the details of the available endpoints, their parameters, and sample responses.

Get info on active arena

Endpoint: https://api.goatarena.xyz/

Method: get

Sample Response:

{
    "currentGame": {
"status" : "running" / "preparing",
        "data": {
            "id": 15,
            "timeStarted": "2024-12-23T11:32:41.196Z",
            "memecoinName": "Jingle",
            "contractAddress": "7z3vmSUGWZzFi1cmCmkB4NLN3sxWK7tc3U7MYcwepump",
            "timeEnded": null,
            "totalPot": "0",
            "overPot": "0",
            "underPot": "0",
            "overTokenMinted": "0",
            "underTokenMinted": "0",
            "overTokenBurnt": "0",
            "underTokenBurnt": "0",
            "overPrice": 1000000,
            "underPrice": 1000000,
            "claimableWinningPotInSol": "0",
            "over_token_address": "BKsXSkMJStmwtL1T2Jrn3FRG2b5yBB9499bb3hCDkrwB",
            "under_token_address": "4dpjkpSHbhL6CxJvebRTEZxk5koAyqaR6L7z4CEFUU2t",
            "memecoin_symbol": "BELLS",
            "memecoin_usd_start": 0.00021913162335856609,
            "memecoin_usd_end": 0,
            "token_decimal": 6,
            "over_pot_address": "GbXnR6189x9PMACu7x6WUjj6ioh8oKxVTJenfYLS5cEh",
            "under_pot_address": "BJBg3ytB9hhKss8NQTRRAdpc2LUbuoSNShcWKQjp1PbF",
            "goatArenaBurnerWallet": "5ajyDtkDnpjWvjHvYdVRWwbmG6VHyU1QuAEEVrC5ZHBv"
        }
    }
}
401 : {error : error}

Buy OVER or UNDER token

<aside> ⚠️

Call this API AFTER you transfer SOL amount to buy the token, putting tx signature to the API call

</aside>

Endpoint: https://api.goatarena.xyz/buy

Method: post

Parameters:

wallet : varchar

Sample Response:

"buyResult": {
        "data: {
            "success": true
      
        }
    }

401 : {error : error}

Sell OVER or UNDER token

<aside> ⚠️

Call this API AFTER you transferred token (OVER or UNDER), putting tx signature to the API call.

</aside>