> This page is for Taurus PROTECT, version v3.56. > For other versions, use one of these documentation indexes: > - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt > - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt > - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt > - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt > - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt > - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt > - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt > - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt > - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt > - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt > - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server. # Get participant by ID GET https://your-protect-instance.example.com/api/rest/v1/tn/participants/{participantID} This endpoint returns a Taurus-NETWORK participant based on the provided ID. Reference: https://taurushq.ferndocs.com/protect-capital/reference/taurus-network-participants/get ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `participantID` (string, required) ### Query parameters - `includeTotalPledgesValuation` (boolean, optional) — Include the total aggregated valuation (outgoing and incoming) of the pledges for the participant. ## Response ### 200 A successful response. - `result` (tgvalidatordTnParticipant, optional) ## Errors ### 400 Bad Request Error Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing) - `any` ### 401 Unauthorized Error Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource - `any` ### 403 Forbidden Error Forbidden: indicates that the server understands the request but refuses to authorize it - `any` ### 404 Not Found Error Not Found: indicates that the server cannot find the requested resource - `any` ### 500 Internal Server Error Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request - `any` ### 503 Service Unavailable Error Service Unavailable: indicates that the server is not ready to handle the request. - `any` ## Types ### tgvalidatordTnParticipant - `id` (string, optional) - `name` (string, optional) - `legalAddress` (string, optional) - `country` (string, optional) - `logoBase64` (string, optional) - `publicKey` (string, optional) - `shield` (string, optional) - `originRegistrationDate` (datetime, optional) - `originDeletionDate` (datetime, optional) - `createdAt` (datetime, optional) - `updatedAt` (datetime, optional) - `details` (tgvalidatordTnParticipantDetails, optional) - `blockConfirmations` (list of tgvalidatordBlockConfirmations, optional) - `ownedSharedAddressesCount` (string, optional) — Count of shared addresses where the participant is the owner. - `targetedSharedAddressesCount` (string, optional) — Count of shared addresses where the participant is the target. - `outgoingTotalPledgesValuationBaseCurrency` (string, optional) — Total valuation of all outgoing pledges in base currency in main unit (ex. CHF). - `incomingTotalPledgesValuationBaseCurrency` (string, optional) — Total valuation of all incoming pledges in base currency in main unit (ex. CHF). - `publicSubname` (string, optional) - `legalEntityIdentifier` (string, optional) - `attributes` (list of tgvalidatordTnParticipantAttribute, optional) - `status` (string, optional) - `tnLendingOffers` (list of tgvalidatordTnLendingOffer, optional) - `defaultSharedAddresses` (tgvalidatordDefaultSharedAddresses, optional) - `types` (list of string, optional) - `capabilities` (list of string, optional) ### tgvalidatordTnParticipantDetails - `contactPersons` (list of tgvalidatordTnContactPerson, optional) - `attributesSpecifications` (list of tgvalidatordTnParticipantAttributeSpecification, optional) - `supportedBlockchains` (list of tgvalidatordBlockchainEntity, optional) — List of supported blockchains and networks for the participant. This is used to determine which blockchains and networks the participant can interact with. ### tgvalidatordBlockConfirmations - `blockchain` (string, optional) - `network` (string, optional) - `confirmationsThreshold` (string, optional) ### tgvalidatordTnParticipantAttribute - `id` (string, optional) - `key` (string, optional) - `value` (string, optional) - `owner` (string, optional) - `type` (string, optional) - `subtype` (string, optional) - `contentType` (string, optional) - `isTaurusNetworkShared` (boolean, optional) ### tgvalidatordTnLendingOffer - `id` (string, optional) - `annualPercentageYield` (string, optional) — The interest rate of the to create lending offer, based on 5 decimals. Example: 525000 corresponds to 5.25% annual percentage yield - `duration` (string, optional) - `collateralRequirement` (tgvalidatordLendingCollateralRequirement, optional) - `participantID` (string, optional) - `blockchain` (string, optional) - `network` (string, optional) - `arg1` (string, optional) - `arg2` (string, optional) - `currencyInfo` (tgvalidatordCurrency, optional) - `annualPercentageYieldMainUnit` (string, optional) - `originCreatedAt` (datetime, optional) - `createdAt` (datetime, optional) - `updatedAt` (datetime, optional) - `amount` (string, optional) - `amountMainUnit` (string, optional) - `options` (tgvalidatordLendingOfferOptions, optional) ### tgvalidatordDefaultSharedAddresses - `outgoingDefaultSharedAddresses` (list of tgvalidatordDefaultSharedAddress, optional) — The TN shared addresses designated by me to be shared to other participants - `incomingDefaultSharedAddresses` (list of tgvalidatordDefaultSharedAddress, optional) — The TN shared addresses designated by other participant to share to me ### tgvalidatordTnContactPerson - `firstName` (string, optional) - `lastName` (string, optional) - `phoneNumber` (string, optional) - `email` (string, optional) ### tgvalidatordTnParticipantAttributeSpecification - `attributeKey` (string, optional) - `attributeType` (string, optional) - `attributeDescription` (string, optional) ### tgvalidatordBlockchainEntity - `symbol` (string, optional) — symbol of the blockchain (e.g. BTC, ETH, FTM, Cosmos, ...) - `name` (string, optional) - `baseCurrency` (tgvalidatordCurrency, optional) - `dotInfo` (tgvalidatordDOTBlockchainInfo, optional) - `ethInfo` (tgvalidatordEVMBlockchainInfo, optional) - `network` (string, optional) - `chainId` (string, optional) - `blackholeAddress` (string, optional) — Destination address used for cancel requests - `confirmations` (string, optional) — Number of blocks needed for a transaction to be considered as confirmed - `blockHeight` (string, optional) — Current block height - `isLayer2Chain` (boolean, optional) — True indicates this is a Layer2 blockchain - `layer1Network` (string, optional) — Underlying layer 1 blockchain network, only relevant when isLayer2Chain is true - `xtzInfo` (tgvalidatordXTZBlockchainInfo, optional) ### tgvalidatordLendingCollateralRequirement - `acceptedCurrencies` (list of tgvalidatordCurrencyCollateralRequirement, optional) ### tgvalidatordCurrency - `name` (string, optional) — Name of the currency. - `symbol` (string, optional) — Shorthand symbol for the currency. - `coinTypeIndex` (string, optional) — Index used to identify the coin type in BIP44. (e.g. Bitcoin is 0, Ethereum is 60). - `blockchain` (string, optional) — The Blockchain the currency is associated with, (e.g. ETH, BTC). - `isToken` (boolean, optional) — Indicates if the currency is a token (e.g., ERC-20). - `isERC20` (boolean, optional) — DEPRECATED: use tokenInfo.tokenType == ERC20 instead. - `decimals` (string, optional) — Number of decimal places the currency uses (e.g. 18 for ETH). - `contractAddress` (string, optional) — Smart contract address if currency is a smart contract (e.g. ERC-20.). - `hasStaking` (boolean, optional) — Indicates if the currency supports staking. - `isUTXOBased` (boolean, optional) — Indicates if the currency is UTXO-based (e.g. Bitcoin). - `isAccountBased` (boolean, optional) — Indicates if the currency is account-based (e.g. Ethereum). - `isFiat` (boolean, optional) — Indicates if the currency is a fiat currency (e.g. CHF, EUR, USD). - `isFA12` (boolean, optional) — DEPRECATED: use tokenInfo.tokenType == FA12 instead. - `isFA20` (boolean, optional) — DEPRECATED: use tokenInfo.tokenType == FA2 instead. - `isNFT` (boolean, optional) — Indicates if the currency represents a Non-Fungible Token (NFT). - `enabled` (boolean, optional) — Indicates if the currency is enabled in the current tenant. - `id` (string, optional) — Unique identifier of the currency. - `displayName` (string, optional) — Display name for the currency, (e.g. Ethereum, Bitcoin). - `type` (string, optional) — Type of the currency. Can be `token`, `fiat`, `native` , or `signet`. - `wlcaId` (string, optional) — White listed contract address id associated with the currency. - `network` (string, optional) — Network or environment the currency is used on (e.g. 'mainnet', 'testnet'). - `tokenID` (string, optional) — Unique id for the token, if applicable (e.g. for NFTs). - `logo` (string, optional) — Currency logo in Data URI scheme. Base 64 encoded. (e.g. data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==). - `tokenInfo` (tgvalidatordTokenInfo, optional) — Token-specific details for a Currency. Present only when the currency is a token. ### tgvalidatordLendingOfferOptions - `acceptedFrequencies` (list of string, optional) - `acceptedDayCountConventions` (list of string, optional) - `gracePeriodDays` (integer, optional) - `interestGracePeriodDays` (integer, optional) - `marginCallThreshold` (double, optional) - `liquidationThreshold` (double, optional) - `marginCallResolutionWindowDays` (integer, optional) ### tgvalidatordDefaultSharedAddress - `blockchain` (string, optional) - `network` (string, optional) - `sharedAddressID` (string, optional) ### tgvalidatordDOTBlockchainInfo - `currentEra` (string, optional) - `maxNominations` (string, optional) - `forkNumber` (string, optional) — Set to 1 for AssetHub. - `forkMigratedAt` (datetime, optional) — Empty when DOT hasn't migrated to AssetHub ### tgvalidatordEVMBlockchainInfo - `chainId` (string, optional) ### tgvalidatordXTZBlockchainInfo - `currentCycle` (string, optional) ### tgvalidatordCurrencyCollateralRequirement - `blockchain` (string, optional) - `network` (string, optional) - `arg1` (string, optional) - `arg2` (string, optional) - `ratio` (string, optional) — The loan to value ratio of the lending offer, based on 2 decimals. Example: 12500 corresponds to my collateral shall be worth 125% of my loan - `currencyInfo` (tgvalidatordCurrency, optional) ### tgvalidatordTokenInfo Token-specific details for a Currency. Present only when the currency is a token. - `tokenType` (enum, optional) — Token standard of a currency; set only when it is a token. Replaces isERC20 (6), isFA12 (15), isFA20 (16). - Allowed values: `TOKEN_TYPE_ERC20`, `TOKEN_TYPE_ERC721`, `TOKEN_TYPE_ERC1155`, `TOKEN_TYPE_CRYPTO_PUNKS`, `TOKEN_TYPE_FA2`, `TOKEN_TYPE_FA12`, `TOKEN_TYPE_ASA`, `TOKEN_TYPE_COSMOS_BANK`, `TOKEN_TYPE_CW20`, `TOKEN_TYPE_XLM_ASSET`, `TOKEN_TYPE_SOL_TOKEN`, `TOKEN_TYPE_SOL_TOKEN_2022`, `TOKEN_TYPE_ICRC1`, `TOKEN_TYPE_HEDERA_TOKEN`, `TOKEN_TYPE_HEDERA_NFT`, `TOKEN_TYPE_CANTON_UTILITY`, `TOKEN_TYPE_TRC20`, `TOKEN_TYPE_CIP56`, `TOKEN_TYPE_XRP_ASSET` ## Examples **Response** ```json { "result": { "id": "string", "name": "string", "legalAddress": "string", "country": "string", "logoBase64": "string", "publicKey": "string", "shield": "string", "originRegistrationDate": "2024-01-15T09:30:00Z", "originDeletionDate": "2024-01-15T09:30:00Z", "createdAt": "2024-01-15T09:30:00Z", "updatedAt": "2024-01-15T09:30:00Z", "details": { "contactPersons": [ { "firstName": "string", "lastName": "string", "phoneNumber": "string", "email": "string" } ], "attributesSpecifications": [ { "attributeKey": "string", "attributeType": "string", "attributeDescription": "string" } ], "supportedBlockchains": [ { "symbol": "string", "name": "string", "baseCurrency": { "name": "string", "symbol": "string", "coinTypeIndex": "string", "blockchain": "string", "isToken": true, "isERC20": true, "decimals": "string", "contractAddress": "string", "hasStaking": true, "isUTXOBased": true, "isAccountBased": true, "isFiat": true, "isFA12": true, "isFA20": true, "isNFT": true, "enabled": true, "id": "string", "displayName": "string", "type": "string", "wlcaId": "string", "network": "string", "tokenID": "string", "logo": "string", "tokenInfo": { "tokenType": "TOKEN_TYPE_ERC20" } }, "dotInfo": { "currentEra": "906", "maxNominations": "16" }, "ethInfo": { "chainId": "1" }, "network": "string", "chainId": "string", "blackholeAddress": "string", "confirmations": "string", "blockHeight": "string", "isLayer2Chain": true, "layer1Network": "string", "xtzInfo": { "currentCycle": "823" } } ] }, "blockConfirmations": [ { "blockchain": "string", "network": "string", "confirmationsThreshold": "string" } ], "ownedSharedAddressesCount": "string", "targetedSharedAddressesCount": "string", "outgoingTotalPledgesValuationBaseCurrency": "string", "incomingTotalPledgesValuationBaseCurrency": "string", "publicSubname": "string", "legalEntityIdentifier": "string", "attributes": [ { "id": "string", "key": "string", "value": "string", "owner": "string", "type": "string", "subtype": "string", "contentType": "string", "isTaurusNetworkShared": true } ], "status": "string", "tnLendingOffers": [ { "id": "string", "annualPercentageYield": "string", "duration": "string", "collateralRequirement": { "acceptedCurrencies": [ { "blockchain": "string", "network": "string", "arg1": "string", "arg2": "string", "ratio": "string", "currencyInfo": { "name": "string", "symbol": "string", "coinTypeIndex": "string", "blockchain": "string", "isToken": true, "isERC20": true, "decimals": "string", "contractAddress": "string", "hasStaking": true, "isUTXOBased": true, "isAccountBased": true, "isFiat": true, "isFA12": true, "isFA20": true, "isNFT": true, "enabled": true, "id": "string", "displayName": "string", "type": "string", "wlcaId": "string", "network": "string", "tokenID": "string", "logo": "string", "tokenInfo": { "tokenType": "TOKEN_TYPE_ERC20" } } } ] }, "participantID": "string", "blockchain": "string", "network": "string", "arg1": "string", "arg2": "string", "currencyInfo": { "name": "string", "symbol": "string", "coinTypeIndex": "string", "blockchain": "string", "isToken": true, "isERC20": true, "decimals": "string", "contractAddress": "string", "hasStaking": true, "isUTXOBased": true, "isAccountBased": true, "isFiat": true, "isFA12": true, "isFA20": true, "isNFT": true, "enabled": true, "id": "string", "displayName": "string", "type": "string", "wlcaId": "string", "network": "string", "tokenID": "string", "logo": "string", "tokenInfo": { "tokenType": "TOKEN_TYPE_ERC20" } }, "annualPercentageYieldMainUnit": "string", "originCreatedAt": "2024-01-15T09:30:00Z", "createdAt": "2024-01-15T09:30:00Z", "updatedAt": "2024-01-15T09:30:00Z", "amount": "string", "amountMainUnit": "string", "options": { "acceptedFrequencies": [ "string" ], "acceptedDayCountConventions": [ "string" ], "gracePeriodDays": 1, "interestGracePeriodDays": 1, "marginCallThreshold": 1.1, "liquidationThreshold": 1.1, "marginCallResolutionWindowDays": 1 } } ], "defaultSharedAddresses": { "outgoingDefaultSharedAddresses": [ { "blockchain": "string", "network": "string", "sharedAddressID": "string" } ], "incomingDefaultSharedAddresses": [ { "blockchain": "string", "network": "string", "sharedAddressID": "string" } ] }, "types": [ "string" ], "capabilities": [ "string" ] } } ``` **SDK Code** ```python import requests url = "https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://your-protect-instance.example.com/api/rest/v1/tn/participants/participantID")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```