📦Shared resources

Buy and sell flows use the same discovery resources. Retrieve them before requesting quotes and filter them for the current user context.

Active providers

curl 'https://api.coindisco.com/api/white-label/v1/active-providers/' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

[
  {
    "id": 5,
    "name": "Example Provider",
    "slug_name": "example-provider",
    "icon": "https://cdn.example.com/provider.png",
    "url_for_transaction_details": "https://provider.example/orders/",
    "url_for_support": "https://provider.example/support",
    "domain": "provider.example",
    "privacy": "https://provider.example/privacy",
    "terms": "https://provider.example/terms",
    "sell_available": true
  }
]

sell_available indicates provider-level sell support. Final availability still depends on the selected region, asset, network, currency, method, and amount.

Regions

curl 'https://api.coindisco.com/api/white-label/v1/regions/' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

[
  {
    "id": 157,
    "kind": "country",
    "name": "Poland",
    "alpha2_code": "PL",
    "alpha3_code": "POL",
    "letter_id": "poland",
    "icon": "https://cdn.example.com/regions/PL.png",
    "parent_region": null,
    "child_exists": false,
    "states": []
  }
]

If child_exists is true, require the applicable state or province rather than submitting only the parent country.

Payment methods

curl 'https://api.coindisco.com/api/white-label/v1/regions/157/payment-methods/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

[
  {
    "id": 39,
    "letter_id": "debit_card",
    "code": "debit_card",
    "name": "Debit card",
    "icon": "https://cdn.example.com/payment-methods/debit-card.png",
    "sell_available": true
  }
]

Omit service_id to discover methods across all providers available to the widget.

Fiat currencies

curl 'https://api.coindisco.com/api/white-label/v1/regions/157/currencies/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

[
  {
    "id": 3,
    "name": "USD",
    "symbol": "$",
    "icon": "https://cdn.example.com/currencies/USD.png",
    "full_name": "United States Dollar"
  }
]

Crypto assets and networks

curl 'https://api.coindisco.com/api/white-label/v1/cryptocurrency/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'

{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "code": "btc",
      "letter_id": "bitcoin",
      "logo": "https://cdn.example.com/crypto/bitcoin.png",
      "issuer": null,
      "home_domain": null,
      "networks": [
        {
          "id": 1,
          "name": "Bitcoin",
          "code": "bitcoin",
          "protocol_standard": "native"
        }
      ]
    }
  ]
}

Follow next until it is null; do not assume that the first page is the complete catalog.