> ## Documentation Index > Fetch the complete documentation index at: https://docs.delora.build/llms.txt > Use this file to discover all available pages before exploring further. # Get token > Returns metadata for a single token on a specific chain. The token query parameter can be a token address or symbol. ## OpenAPI ````yaml GET /v1/token openapi: 3.1.1 info: title: Delora API description: Delora API version: 1.0.0 servers: - url: https://api.delora.build security: [] tags: - name: Health description: Service health endpoints. - name: V1 description: Routing and metadata endpoints. - name: Transaction Tracking description: Read-only, integrator-scoped transaction tracking. paths: /v1/token: get: tags: - V1 summary: Find one token by chain and address or symbol description: >- Returns metadata for a single token on a specific chain. The token query parameter can be a token address or symbol. operationId: getToken parameters: - name: x-api-key in: header description: Optional API key for higher rate limits and fee rules. required: false schema: type: string - name: chain required: true in: query description: Chain ID or chain key, for example `8453` or `sol`. schema: example: '8453' type: string - name: token required: true in: query description: Token address or symbol. schema: type: string example: USDC responses: '200': description: Token metadata response. content: application/json: schema: $ref: '#/components/schemas/TokenDto' examples: success: summary: Token metadata response value: address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' symbol: USDC decimals: 6 chainId: 8453 name: USD Coin coinKey: USDC priceUSD: '1.00' priceUpdatedAt: '2026-06-22T12:00:00.000Z' priceSource: dexscreener priceStale: false priceTier: cold logoURI: https://example.com/usdc.png '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponseDto' examples: validationErrors: summary: Validation errors value: statusCode: 400 code: VALIDATION_ERROR message: Invalid request parameters details: message: - senderAddress should not be empty - senderAddress must be a string timestamp: '2026-05-15T16:58:45.603Z' path: /v1/quotes '404': description: Token was not found. content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponseDto' examples: tokenNotFound: summary: Token not found value: statusCode: 404 code: NOT_FOUND message: Requested resource was not found details: message: Requested resource was not found timestamp: '2026-05-15T16:58:45.603Z' path: /v1/token?chain=8453&token=UNKNOWN '429': description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponseDto' examples: rateLimitExceeded: summary: Rate limit exceeded value: statusCode: 429 code: RATE_LIMIT message: Rate limit exceeded. Please try again later. details: message: Rate limit exceeded. Please try again later. timestamp: '2026-05-15T16:58:45.603Z' path: /v1/quotes components: schemas: TokenDto: type: object properties: address: type: string example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' symbol: type: string example: USDC decimals: type: number example: 6 chainId: type: number example: 8453 name: type: string example: USD Coin coinKey: type: string example: USDC priceUSD: type: string example: '1.00' description: Cached USD price as a decimal string, when available. priceUpdatedAt: type: string example: '2026-06-22T12:00:00.000Z' description: Timestamp of the cached token price, when available. priceSource: type: string example: dexscreener description: Price source used for the cached token price, when available. priceStale: type: boolean example: false description: Whether the cached token price is outside Delora's freshness window. priceTier: type: string enum: - hot - cold example: cold description: >- Price refresh tier. `hot` tokens are prioritized for fresher cached prices; `cold` tokens refresh less aggressively. logoURI: type: string example: https://example.com/usdc.png required: - address - symbol - decimals - chainId - name - coinKey StandardErrorResponseDto: type: object properties: statusCode: type: number example: 400 code: enum: - NO_AVAILABLE_QUOTES - AMOUNT_TOO_LOW - WRONG_ADDRESS - RATE_LIMIT - SLIPPAGE_EXCEEDED - ADAPTER_BAD_REQUEST - ADAPTER_UNAUTHORIZED - ADAPTER_INTERNAL - VALIDATION_ERROR - NOT_FOUND - UNKNOWN type: string description: >- Machine-readable Delora error code. - NO_AVAILABLE_QUOTES: No bridge or exchange adapter returned an executable quote for the requested transfer. - AMOUNT_TOO_LOW: The requested input amount is below the minimum supported by the available bridge route. - WRONG_ADDRESS: A wallet address is missing, malformed, or incompatible with the requested chain type. - RATE_LIMIT: The request exceeded the configured rate limit. - SLIPPAGE_EXCEEDED: The expected output amount fell below the route's permitted minimum. - ADAPTER_BAD_REQUEST: An upstream bridge or exchange adapter rejected the request as invalid. - ADAPTER_UNAUTHORIZED: An upstream bridge or exchange adapter rejected the request because credentials are missing or invalid. - ADAPTER_INTERNAL: An upstream bridge or exchange adapter failed with an internal error. - VALIDATION_ERROR: The request failed Delora API validation, including invalid query parameters, body fields, or address formats. - NOT_FOUND: The requested chain, token, or resource was not found. - UNKNOWN: The request failed with an unexpected error that does not map to a more specific code. x-enumDescriptions: - >- No bridge or exchange adapter returned an executable quote for the requested transfer. - >- The requested input amount is below the minimum supported by the available bridge route. - >- A wallet address is missing, malformed, or incompatible with the requested chain type. - The request exceeded the configured rate limit. - >- The expected output amount fell below the route's permitted minimum. - >- An upstream bridge or exchange adapter rejected the request as invalid. - >- An upstream bridge or exchange adapter rejected the request because credentials are missing or invalid. - >- An upstream bridge or exchange adapter failed with an internal error. - >- The request failed Delora API validation, including invalid query parameters, body fields, or address formats. - The requested chain, token, or resource was not found. - >- The request failed with an unexpected error that does not map to a more specific code. example: VALIDATION_ERROR message: type: string example: Invalid request parameters details: description: >- Optional error details. When details is an object, `message` can be either a string or an array of strings. oneOf: - type: object additionalProperties: true properties: message: oneOf: - type: string - type: array items: type: string description: >- Human-readable details. Validation errors may return multiple messages. errorCode: type: string code: oneOf: - type: string - type: number status: oneOf: - type: string - type: number - type: string - type: array items: type: string example: message: - One or more request parameters are invalid. timestamp: type: string example: '2026-05-13T18:00:00.000Z' path: type: string example: /v1/... required: - statusCode - code - message - timestamp ````