API Endpoints

Complete reference for all Gold Digger API endpoints. Use these endpoints to interact with the Gold Digger platform programmatically.

Base URL

All API requests should be made to the following base URL

https://api.golddigger.io/v1

Authentication

Most API endpoints require authentication. Include your API key in the request headers.

Authorization: Bearer YOUR_API_KEY

You can generate an API key in your account settings. Keep your API keys secure and never expose them in client-side code.

GET

/token/price

Get the current price of the GOLD token

Parameters

Name	Type	Required	Default	Description
currency	string	No	USD	Currency to convert to (USD, EUR, etc.)

Response

{
  "success": true,
  "data": {
    "symbol": "GOLD",
    "price": 0.87,
    "change24h": 3.5,
    "volume24h": 1250000,
    "marketCap": 87000000,
    "lastUpdated": "2023-11-15T12:30:45.123Z"
  }
}

GET

/token/history

Get historical price data for the GOLD token

Parameters

Name	Type	Required	Default	Description
timeframe	string	No	1D	Timeframe for price history (1D, 1W, 1M, 1Y, ALL)
currency	string	No	USD	Currency to convert to (USD, EUR, etc.)

Response

{
  "success": true,
  "data": [
    {
      "timestamp": 1699123200000,
      "price": 0.85,
      "volume": 1200000
    },
    {
      "timestamp": 1699209600000,
      "price": 0.87,
      "volume": 1250000
    }
  ]
}

GET

/token/metadata

Get metadata for the GOLD token

Response

{
  "success": true,
  "data": {
    "name": "Gold Digger",
    "symbol": "GOLD",
    "address": "GoldDiggerTokenMintAddress123456789",
    "decimals": 9,
    "logoURI": "/images/icons/gold.png",
    "tags": ["defi", "nft", "gaming"],
    "extensions": {
      "website": "https://golddigger.io",
      "twitter": "@golddigger",
      "discord": "https://discord.gg/golddigger"
    }
  }
}