---
updatedAt: 2026-02-27T01:29:56.000Z
---

Fetch the complete documentation index at: https://docs.noves.fi/llms.txt. Use this file to discover all available pages before exploring further.

# /price

Returns the price for the requested token at the given timestamp. If no timestamp is passed, the price for the current time will be returned.
            
Currently, only the "cc" (Canton Coin) token is supported.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Pricing API",
    "description": "Real-time and historical DEX pricing across chains. Every token, priced. Powered by Noves.",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://pricing.noves.fi"
    }
  ],
  "paths": {
    "/daml/{chain}/price/{tokenAddress}": {
      "get": {
        "tags": [
          "Daml"
        ],
        "summary": "/price",
        "description": "Returns the price for the requested token at the given timestamp. If no timestamp is passed, the price for the current time will be returned.\r\n            \r\nCurrently, only the \"cc\" (Canton Coin) token is supported.",
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "description": "The chain to query (e.g. canton)",
            "required": true,
            "style": "simple",
            "schema": {
              "type": "string",
              "default": "canton",
              "example": "canton"
            }
          },
          {
            "name": "tokenAddress",
            "in": "path",
            "description": "The token identifier to price (currently only \"cc\" is supported)",
            "required": true,
            "style": "simple",
            "schema": {
              "type": "string",
              "default": "cc",
              "example": "cc"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "Unix timestamp (seconds) to query price at. If not provided, returns the latest price.",
            "style": "form",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "apiKey",
            "in": "header",
            "description": "API Key for Pricing API. To generate an API Key, visit https://noves.fi/pricing",
            "required": true,
            "style": "simple",
            "schema": {
              "type": "string",
              "default": "demokey"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/DamlPriceResponseApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DamlPriceResponseApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DamlPriceResponseApiModel"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DamlPriceDetailModel": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "string",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "DamlPriceResponseApiModel": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "nullable": true
          },
          "token": {
            "$ref": "#/components/schemas/DamlTokenInfo"
          },
          "price": {
            "$ref": "#/components/schemas/DamlPriceDetailModel"
          },
          "priceStatus": {
            "type": "string",
            "nullable": true
          },
          "priceObservedAt": {
            "type": "string",
            "description": "The timestamp at which the price was observed",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Public API response for DAML price endpoint"
      },
      "DamlTokenInfo": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "nullable": true
          },
          "symbol": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": {}
      }
    }
  }
}
```