Skip to content

Get Stablecoin Details

Use this endpoint to retrieve key details about a deployed stablecoin including contract addresses, supply stats, token metadata, and connected deployments.

Prerequisites

Before you begin, ensure:

You have the stablecoinId returned from the deploy step

Endpoint

GET /v2/stablecoin/{stablecoinId}

Example Request

curl -X GET https://api.fsco.io/v2/stablecoin/{{stablecoinId}} \
  -H "Authorization: Bearer $FSCO_API_KEY"

import axios from 'axios';

const FSCO_API_KEY = process.env.FSCO_API_KEY;

const getStablecoinDetails = async () => {
  const response = await axios.get(
    'https://api.fsco.io/v2/stablecoin/{{stablecoinId}}',
    {
      headers: {
        Authorization: `Bearer ${FSCO_API_KEY}`,
        'Content-Type': 'application/json'
      }
    }
  );

  console.log('Stablecoin details:', response.data);
};

getStablecoinDetails();

import requests
import os

FSCO_API_KEY = os.getenv("FSCO_API_KEY")

headers = {
    "Authorization": f"Bearer {FSCO_API_KEY}",
    "Content-Type": "application/json",
}

response = requests.get(
    "https://api.fsco.io/v2/stablecoin/{{stablecoinId}}", headers=headers
)

print("Stablecoin details:", response.json())

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var apiKey = Environment.GetEnvironmentVariable("FSCO_API_KEY");

        var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

        var response = await client.GetAsync("https://api.fsco.io/v2/stablecoin/{{stablecoinId}}");
        var responseString = await response.Content.ReadAsStringAsync();

        Console.WriteLine("Stablecoin details: " + responseString);
    }
}

Response

JSON

{
  "stablecoin": {
    "id": "{{stablecoinId}}",
    "name": "My Stablecoin",
    "symbol": "USDX",
    "decimals": 18,
    "circulatingSupply": "10000000000000000000",
    "totalMinted": "15000000000000000000",
    "totalBurned": "5000000000000000000",
    "backingCurrency": "United States Dollar",
    "backingCurrencySymbol": "$",
    "factoryContractDeploymentId": "{{factoryContractDeploymentId}}",
    "tokenContractDeploymentId": "{{tokenContractDeploymentId}}",
    "attestationContractDeploymentId": "{{attestationContractDeploymentId}}",
    "tokenContractAddress": "{{tokenContractAddress}}",
    "attestationContractAddress": "{{attestationContractAddress}}"
  }
}

The response includes:

Token name, symbol, decimals
Current supply stats (circulatingSupply, totalMinted, totalBurned)
Addresses for token and attestation contracts
Linked contract deployment IDs (useful for advanced integration)

Next Steps