Search for tokens and get asset details across all supported chains.
Base URL: https://tws.trustwallet.com
Auth: HMAC-SHA256 (see setup)
Endpoints
Search Assets
GET /v1/search/assets
Search for tokens by name, symbol, or contract address. Returns matching tokens with metadata, market data, and verification status.
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | Search term (name, symbol, or address) |
networks |
string | No | Comma-separated SLIP-44 coin IDs to filter by chain (e.g., 60 for Ethereum, 60,714 for ETH+BSC) |
limit |
number | No | Max results (default: 20) |
Example request:
GET /v1/search/assets?query=USDC&networks=60
Response:
{
"total": 9,
"docs": [
{
"name": "USD Coin",
"symbol": "USDC",
"type": "ERC20",
"decimals": 6,
"asset_id": "c60_t0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"verifiers": ["trustwallet"],
"icon_url": "https://assets-cdn.trustwallet.com/...",
"market_cap": 32000000000,
"volume_24h": 5000000000,
"price": 1.0,
"tags": ["stablecoin"]
}
]
}
The v2/search/assets endpoint is also available with expanded results.
Get Assets
GET /v1/assets
Get asset details. Can be used to look up specific assets by ID or list assets for a chain.
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
assetId |
string | No | Specific asset ID (e.g., c60 for ETH) |
coin |
number | No | SLIP-44 coin ID to list assets for a chain |
Example request:
GET /v1/assets?assetId=c60
Get Coin Status
GET /v1/coinstatus/{assetId}
Get coin status including feature flags (buy/sell/swap/stake enabled), warning messages, and security info.
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
assetId |
string | Yes | Asset ID (e.g., c60 for ETH, c60_t0xA0b8... for ERC-20) |
Query parameters:
| Name | Type | Required | Description |
|---|---|---|---|
version |
string | No | API version (e.g., 8.4) |
platform |
string | No | Platform (android, ios) |
include_security_info |
boolean | No | Include security analysis (default: false) |
Example request:
GET /v1/coinstatus/c60?include_security_info=true
Response:
{
"asset": {
"name": "Ethereum",
"symbol": "ETH",
"type": "coin",
"decimals": 18,
"asset_id": "c60"
},
"isBuyCryptoEnabled": true,
"isSellCryptoEnabled": true,
"isSwapEnabled": true,
"isSwapCrossChainEnabled": true,
"isStakeEnabled": true,
"isDappsEnabled": true,
"messages": [],
"security_info": {
"is_scanned": true,
"contract_security": {
"num_risks": 0,
"num_warnings": 0,
"is_counterfeit": false
},
"honeypot_risk": {
"num_risks": 0,
"num_warnings": 0,
"buy_tax": 0.0,
"sell_tax": 0.0
}
}
}
The v2/coinstatus/{assetId} variant additionally includes native token payment info.