DORRS Data
Login
Client APICoingecko

Link or Unlink Symbol to CoinGecko

POST
/backend/api/v1/coingecko/link/

Links an existing DORRS Symbol to a CoinGecko asset, or removes the existing link.

Send a non-empty coingecko_id to link the Symbol. The DORRS ticker must exactly match the CoinGecko ticker, and every word in the CoinGecko asset name must be present in the DORRS Symbol security name. Cleanup flags are ignored when linking. The first link does not remove data. Changing an existing link to a different CoinGecko ID removes stale data derived from the previous CoinGecko asset before the new link is created.

Send an empty or omitted coingecko_id to unlink the Symbol. The cleanup flags apply only in this unlink mode. clean_blockchain_data removes Blockchain network data only when its stored address matches the platform address of the previously linked CoinGecko asset; different addresses are preserved as client-managed data. clean_last_sale_data removes CoinGecko-imported Last Sale data and disables future CoinGecko Last Sale imports for the Symbol.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/backend/api/v1/coingecko/link/" \  -H "Content-Type: application/json" \  -d '{    "symbol": "USDT",    "coingecko_id": "tether"  }'
{  "message": "success",  "data": [    {      "id": "tether",      "symbol": "usdt",      "name": "Tether",      "url": "https://www.coingecko.com/en/coins/tether"    }  ],  "code": 200}
{  "message": "Could not resolve and link CoinGecko symbol",  "code": 400}
Empty
{  "message": "Symbol not found",  "code": 404}