> ## Documentation Index > Fetch the complete documentation index at: https://docs.hydric.org/llms.txt > Use this file to discover all available pages before exploring further. # Get a specific token basket for a specific network. > Returns a detailed specific basket on a single blockchain network, containing only tokens for that network. ## OpenAPI ````yaml https://api.hydric.org/v1/openapi.json get /v1/tokens/baskets/{chainId}/{basketId} openapi: 3.1.0 info: title: hydric Gateway API description: Access DeFi Liquidity easily. One plug. Every Protocol. Every Network. version: 1.0.0 contact: {} servers: - url: https://api.hydric.org security: - bearerAuth: [] tags: [] paths: /v1/tokens/baskets/{chainId}/{basketId}: get: tags: - Token Baskets summary: Get a specific token basket for a specific network. description: >- Returns a detailed specific basket on a single blockchain network, containing only tokens for that network. operationId: TokensBasketsController_getSingleChainBasket parameters: - name: chainId required: true in: path description: >- The chain id of the network to get the basket from. This must be a supported network chain id. schema: example: 143 enum: - 1 - 143 - 130 - 999 - 8453 - 9745 - 534352 type: number - name: basketId required: true in: path description: The unique slug of the basket to get. schema: example: usd-stablecoins enum: - usd-stablecoins - eth-pegged-tokens - btc-pegged-tokens - hype-pegged-tokens - monad-pegged-tokens - xau-stablecoins - eur-stablecoins type: string responses: '200': description: The requested token basket. content: application/json: schema: $ref: '#/components/schemas/GetTokenBasketResponse' '400': description: Validation failed (Invalid Basket ID or Unsupported Chain ID). content: application/json: examples: Invalid Basket ID: value: statusCode: 400 timestamp: '2026-02-28T19:40:59.698Z' path: /tokens/baskets/1/invalid-id traceId: doc_sample_trace_id error: code: INVALID_BASKET_ID title: Invalid Parameters message: 'Invalid Basket ID: invalid-id' details: >- The provided ID is not supported. Supported IDs are: usd-stablecoins, eth-pegged-tokens, btc-pegged-tokens, hype-pegged-tokens, monad-pegged-tokens, xau-stablecoins, eur-stablecoins metadata: basketId: invalid-id supportedIds: - usd-stablecoins - eth-pegged-tokens - btc-pegged-tokens - hype-pegged-tokens - monad-pegged-tokens - xau-stablecoins - eur-stablecoins Unsupported Chain ID: value: statusCode: 400 timestamp: '2026-02-28T19:40:59.698Z' path: /tokens/baskets/1/id traceId: doc_sample_trace_id error: code: UNSUPPORTED_CHAIN_ID title: Invalid Parameters message: 'Unsupported Chain ID: 999999' details: >- The provided ID is not supported. Supported IDs are: [1, 143, 130, 999, 8453, 9745, 534352]. metadata: chainId: 999999 unsupportedIds: - 999999 supportedIds: - 1 - 143 - 130 - 999 - 8453 - 9745 - 534352 '404': description: Token basket not found in the specified network. content: application/json: example: statusCode: 404 timestamp: '2026-02-28T19:40:59.698Z' path: /tokens/baskets/1/monad-pegged-tokens traceId: doc_sample_trace_id error: code: TOKEN_BASKET_NOT_FOUND title: Not Found message: >- Couldn't find the token basket 'monad-pegged-tokens' on chain id 1 details: >- The requested token basket does not exist or has no assets on the specified network. metadata: basketId: monad-pegged-tokens chainId: 1 components: schemas: GetTokenBasketResponse: type: object properties: basket: description: The requested token basket. example: id: usd-stablecoins name: USD Stablecoins description: A basket of the most liquid USD stablecoins in the ecosystem. logoUrl: >- https://cdn.jsdelivr.net/gh/hydric-org/token-baskets/assets/logos/usd-stablecoins.png chainIds: - 1 - 143 addresses: - chainId: 1 address: '0xdac17f958d2ee523a2206206994597c13d831ec7' - chainId: 143 address: 0x1234... tokens: - chainId: 1 address: '0x0000000000000000000000000000000000000000' decimals: 18 name: Ether symbol: ETH logoUrl: >- https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000 allOf: - $ref: '#/components/schemas/TokenBasket' required: - basket TokenBasket: type: object properties: id: type: string description: The unique identifier of the token basket. example: usd-stablecoins enum: - usd-stablecoins - eth-pegged-tokens - btc-pegged-tokens - hype-pegged-tokens - monad-pegged-tokens - xau-stablecoins - eur-stablecoins name: type: string description: The human-readable name of the basket. example: USD Stablecoins description: type: string description: A detailed description of what the basket represents. example: A basket of the most liquid USD stablecoins in the ecosystem. logoUrl: type: string description: The URL of the basket logo. example: >- https://cdn.jsdelivr.net/gh/hydric-org/token-baskets/assets/logos/usd-stablecoins.png chainIds: description: List of chain IDs where this basket is available. example: - 1 - 143 type: array items: type: number addresses: description: List of underlying token addresses across supported chains. example: - chainId: 1 address: '0xdac17f958d2ee523a2206206994597c13d831ec7' - chainId: 143 address: 0x1234... type: array items: $ref: '#/components/schemas/BlockchainAddress' tokens: description: Token metadata for the assets in this basket. example: - chainId: 1 address: '0x0000000000000000000000000000000000000000' decimals: 18 name: Ether symbol: ETH logoUrl: >- https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000 type: array items: $ref: '#/components/schemas/SingleChainTokenMetadata' description: >- Multiple tokens grouped together to represent a basket of assets for a specific primitive or theme. required: - id - name - description - logoUrl - chainIds - addresses - tokens BlockchainAddress: type: object properties: chainId: type: number description: The chain id of the address. Must be one of the supported networks enum: - 1 - 143 - 130 - 999 - 8453 - 9745 - 534352 example: 1 address: type: string description: The address tied to the blockchain example: '0x0000000000000000000000000000000000000000' description: An address that is tied to a blockchain required: - chainId - address SingleChainTokenMetadata: type: object properties: chainId: type: number description: The chain id of the network where the token resides. example: 1 enum: - 1 - 143 - 130 - 999 - 8453 - 9745 - 534352 address: type: string description: >- The contract address of the token on its host network. * **ERC-20 Tokens:** The 20-byte hex contract address. * **Native Assets (e.g., ETH, MATIC):** Represented by the "Zero Address" (`0x000...000`). example: '0x0000000000000000000000000000000000000000' decimals: type: number description: >- The number of decimal places used to represent the smallest fractional unit of the token (e.g., 18 for ETH, 6 for USDC). example: 18 name: type: string description: >- The full human-readable name of the asset (e.g., "Ethereum", "Wrapped Bitcoin"). example: Ether symbol: type: string description: The ticker symbol of the token (e.g., "ETH", "WBTC").. example: ETH logoUrl: type: string description: The URL of the token logo. example: >- https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000 description: Core identifying metadata for a token on a single blockchain. required: - chainId - address - decimals - name - symbol - logoUrl securitySchemes: bearerAuth: scheme: bearer bearerFormat: JWT type: http description: >- Use the docs sandbox API key for authentication: **hydric_docs_4N4ocuirsN8Sh** ````