This guide will help you get started with the Pure API quickly. Follow these steps to make your first API request and start integrating with Pure’s precious metals marketplace.

​
Prerequisites

Before you begin, make sure you have:

  1. An API key from Pure (contact us at [email protected] to request one) OR OAuth credentials if you’re using OAuth authentication
  2. A tool for making HTTP requests (like cURL, Postman, or your preferred programming language)

​
Authentication

The Pure API supports two authentication methods:

​
API Key Authentication

For simple integrations, you can authenticate using your API key. Include your key in the x-api-key header with each request:

curl -X GET "https://public.api.collectpure.com/v1/protected" \
  -H "x-api-key: YOUR_API_KEY"

​
OAuth Authentication

For more secure integrations, you can use OAuth authentication. First, obtain an access token:

curl -X POST "https://public.api.collectpure.com/v1/oauth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "AUTHORIZATION_CODE",
    "public_key": "YOUR_PUBLIC_KEY",
    "secret_key": "YOUR_SECRET_KEY",
    "redirect_url": "YOUR_REDIRECT_URL"
  }'

Then use the token in subsequent requests with these headers:

curl -X GET "https://public.api.collectpure.com/v1/protected" \
  -H "x-auth-token: YOUR_ACCESS_TOKEN" \
  -H "x-public-key: YOUR_PUBLIC_KEY" \
  -H "x-secret-key: YOUR_SECRET_KEY"

​
Making Your First Request

Let’s verify your authentication is working by making a request to the authentication test endpoint:

# Using API Key
curl -X GET "https://public.api.collectpure.com/v1/protected" \
  -H "x-api-key: YOUR_API_KEY"

# OR using OAuth
curl -X GET "https://public.api.collectpure.com/v1/protected" \
  -H "x-auth-token: YOUR_ACCESS_TOKEN" \
  -H "x-public-key: YOUR_PUBLIC_KEY" \
  -H "x-secret-key: YOUR_SECRET_KEY"

If successful, you should receive a response like:

{
  "message": "Successfully authenticated",
  "organizationId": "your-organization-id"
}

​
Getting Spot Prices

To retrieve current spot prices for precious metals:

curl -X GET "https://public.api.collectpure.com/v1/spot-prices" \
  -H "x-api-key: YOUR_API_KEY"

This will return the current bid/ask prices and market status for all supported metals.

​
Retrieving Product Data

​
Get a Single Product

To retrieve information about a specific product:

curl -X GET "https://public.api.collectpure.com/v1/product/PRODUCT_ID" \
  -H "x-api-key: YOUR_API_KEY"

Replace PRODUCT_ID with the actual ID of the product you want to retrieve.

​
List Products

To retrieve a paginated list of products:

curl -X GET "https://public.api.collectpure.com/v1/products?offset=0&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

You can adjust the offset and limit parameters to control pagination.

​
Code Examples

​
JavaScript/Node.js

​
Using API Key

const axios = require("axios");

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://public.api.collectpure.com";

async function getSpotPrices() {
  try {
    const response = await axios.get(`${BASE_URL}/v1/spot-prices`, {
      headers: {
        "x-api-key": API_KEY,
      },
    });
    console.log(response.data);
    return response.data;
  } catch (error) {
    console.error("Error fetching spot prices:", error.message);
  }
}

getSpotPrices();

​
Using OAuth

const axios = require("axios");

const AUTH_TOKEN = "YOUR_ACCESS_TOKEN";
const PUBLIC_KEY = "YOUR_PUBLIC_KEY";
const SECRET_KEY = "YOUR_SECRET_KEY";
const BASE_URL = "https://public.api.collectpure.com";

async function getSpotPrices() {
  try {
    const response = await axios.get(`${BASE_URL}/v1/spot-prices`, {
      headers: {
        "x-auth-token": AUTH_TOKEN,
        "x-public-key": PUBLIC_KEY,
        "x-secret-key": SECRET_KEY,
      },
    });
    console.log(response.data);
    return response.data;
  } catch (error) {
    console.error("Error fetching spot prices:", error.message);
  }
}

getSpotPrices();

​
Python

​
Using API Key

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://public.api.collectpure.com'

def get_spot_prices():
    headers = {
        'x-api-key': API_KEY
    }
    response = requests.get(f'{BASE_URL}/v1/spot-prices', headers=headers)

    if response.status_code == 200:
        return response.json()
    else:
        print(f"Error: {response.status_code}")
        print(response.text)
        return None

spot_prices = get_spot_prices()
print(spot_prices)

​
Using OAuth

import requests

AUTH_TOKEN = 'YOUR_ACCESS_TOKEN'
PUBLIC_KEY = 'YOUR_PUBLIC_KEY'
SECRET_KEY = 'YOUR_SECRET_KEY'
BASE_URL = 'https://public.api.collectpure.com'

def get_spot_prices():
    headers = {
        'x-auth-token': AUTH_TOKEN,
        'x-public-key': PUBLIC_KEY,
        'x-secret-key': SECRET_KEY
    }
    response = requests.get(f'{BASE_URL}/v1/spot-prices', headers=headers)

    if response.status_code == 200:
        return response.json()
    else:
        print(f"Error: {response.status_code}")
        print(response.text)
        return None

spot_prices = get_spot_prices()
print(spot_prices)

​
Next Steps

Now that you’ve made your first API requests, you can:

  1. Explore the API Reference to learn about all available endpoints
  2. Integrate the API into your application
  3. Contact us at [email protected] if you have any questions or need assistance