List supported currencies with networks, fees, and prices

The currencies endpoint lists every crypto asset PeerPesa supports, such as USDC, together with the blockchain networks it runs on and its current market price. Use it to show users which networks are active for a coin, how long deposits take to confirm, and what fees apply before you generate a quote.

GET /currencies

Returns all supported coins.

string

Filter by coin symbol, for example USDC.

string

Filter by coin status: active or inactive.

curl "https://api.peerpesa.co/v1/currencies?symbol=USDC" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://api.peerpesa.co/v1/currencies?symbol=USDC", {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const coins = await res.json();

Example coin

Response

{
  "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
  "token_name": "USDC",
  "symbol": "USDC",
  "token_type": "Native",
  "coin_status": "active",
  "networks": [
    {
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "connection_id": "16597dd6-024d-437f-bfa0-6b4702b0b72e",
      "blockchain_network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711b",
      "network": "STELLAR",
      "label": "STELLAR",
      "confirmations": "3",
      "duration": "1 min",
      "details": "Stellar Network",
      "send_fees": 0.0000102,
      "deposit_fees": 0.0000102,
      "swap_fees": 0.0000102,
      "buy_fees": 0.0000102,
      "fees_type": null,
      "slippage": null,
      "app_fee_rate": null,
      "min_withdraw": null,
      "max_withdraw": null,
      "status": "active"
    },
    {
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "connection_id": "a1a2b4aa-ca4d-4f44-bf6a-614799a3fa9e",
      "blockchain_network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
      "network": "CELO",
      "label": "CELO",
      "confirmations": "2",
      "duration": "4 mins",
      "details": "CELO",
      "send_fees": 0.11,
      "deposit_fees": 0.11,
      "swap_fees": 0.11,
      "buy_fees": 0.11,
      "fees_type": null,
      "slippage": null,
      "app_fee_rate": null,
      "min_withdraw": null,
      "max_withdraw": null,
      "status": "active"
    },
    {
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "connection_id": "c3e8d9f6-7a5b-4c3d-9e2f-3a7b6c8d3333",
      "blockchain_network_id": "550e8400-e29b-41d4-a716-446655440000",
      "network": "SOLANA",
      "label": "Sol",
      "confirmations": "1",
      "duration": "5-10 seconds",
      "details": "High-performance L1 blockchain with low fees and fast finality",
      "send_fees": 0.000005,
      "deposit_fees": 0,
      "swap_fees": 0.001,
      "buy_fees": 0.002,
      "fees_type": "flat",
      "slippage": 0.5,
      "app_fee_rate": 0.01,
      "min_withdraw": 0.01,
      "max_withdraw": 1000000,
      "status": "inactive"
    },
    {
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "connection_id": "e5a9c3b7-4f2d-4b8a-9d6e-5c7a8b9f5555",
      "blockchain_network_id": "8cf1955c-ff62-4088-b753-97748628ea31",
      "network": "BASE",
      "label": "BASE",
      "confirmations": "5",
      "duration": "1 min",
      "details": "BASE Network",
      "send_fees": 0.0396,
      "deposit_fees": 0.0396,
      "swap_fees": 0.0396,
      "buy_fees": 0.0396,
      "fees_type": null,
      "slippage": 0.5,
      "app_fee_rate": null,
      "min_withdraw": null,
      "max_withdraw": null,
      "status": "inactive"
    }
  ],
  "icon": "USDC",
  "price": {
    "id": "",
    "base_coin": "USDC",
    "quote_coin": "USD",
    "amount": 0.99965,
    "rate": {
      "buy_rate": 1,
      "sale_rate": 0.9999,
      "exchange_rate": 0.99965
    },
    "market_details": {
      "usd24hVolume": 20032062892.67423,
      "usd24hChange": -0.00407187,
      "usdMarketCap": 72722013902.91692
    },
    "provider": {
      "sell": "100002",
      "buy": "100002"
    },
    "source": "",
    "status": "active",
    "marketcap_amount": 0.99965
  }
}

Only networks with status: "active" can be used for deposits, sends, and quotes. In the example above, USDC is live on Stellar and Celo, while Solana and Base are listed but inactive.

Response fields

string

Unique identifier of the coin (UUID).

string

Display name of the coin, for example USDC.

string

Ticker symbol, for example USDC.

string

Token type, for example Native.

string

active or inactive. Inactive coins cannot be used.

string

Icon identifier for the coin.

object[]

Blockchain networks the coin is available on, with per-network fees and limits.

Show properties

string

ID of the parent coin.

string

ID of the coin and network connection.

string

ID of the blockchain network.

string

Network code, for example STELLAR, CELO, SOLANA, or BASE.

string

Display label for the network.

string

Block confirmations required before a deposit is credited.

string

Typical confirmation time, for example 1 min.

string

Short description of the network.

number

Fee to send or withdraw the coin on this network.

number

Fee charged on deposits.

number

Fee charged on swaps.

number

Fee charged on purchases.

string | null

How fees are applied, for example flat. null when not set.

number | null

Maximum allowed slippage in percent.

number | null

Additional application fee rate.

number | null

Minimum withdrawal amount. null means no minimum.

number | null

Maximum withdrawal amount. null means no maximum.

string

active or inactive for this network.

object

Current market price of the coin.

Show properties

string

Coin being priced, for example USDC.

string

Currency the price is quoted in, for example USD.

number

Current price of one unit.

object

Buy and sell rates.

Show properties

number

Rate when buying the coin.

number

Rate when selling the coin.

number

Mid-market exchange rate.

object

Market data in USD.

Show properties

number

24-hour trading volume.

number

24-hour price change in percent.

number

Total market capitalization.

object

Liquidity provider IDs for buy and sell.

string

Price source. Empty when not set.

string

active or inactive for the price feed.

number

Price used for market cap calculations.

Network stats

Check live network status before sending funds.

Check rates

Get indicative fiat rates for a coin.

​GET /currencies

​Example coin

​Response fields

Network stats

Check rates

GET /currencies

Example coin

Response fields