The current price of an asset

GET/v1/rates

The rate invoices are quoted at right now. 503 price_unavailable while the feed has no fresh price. A publishable key may call this operation (x-publishable-key); it is one of the few on this API that accept one.

Authorization

Send your API key as a bearer token in the Authorization header. Secret API key: Authorization: Bearer ctp_live_sk_…. A publishable key (ctp_…_pk_…) is accepted by these operations only, which serve reference data: getRate, listAssets, listNetworks (each marked x-publishable-key: true). Every other operation refuses it with 403 publishable_key_not_allowed, whatever Origin the request carries: that header binds browsers, not other clients, and nothing on this API relies on it.

Query parameters

Name	Type	Description
`base` required	string	Asset symbol, e.g. `ETH`. At most 16 characters.
`quote`	string	Default and only value: `USD`. One of `USD`.

curl "https://api.ctpeway.com/v1/rates?base=string" \
  -H "Authorization: Bearer $CTPEWAY_API_KEY"

import { CtpeWay } from '@ctpeway/sdk';

const ctpeway = new CtpeWay(process.env.CTPEWAY_API_KEY);

const result = await ctpeway.rates.retrieve({
  base: 'string',
});

Response

200 OK

Field	Type	Description
`base`	string
`quote`	string
`rate`	string	Price of one whole unit of `base` in `quote`. A decimal number written as a string, with up to 8 decimal places.
`fetched_at`	string (date-time)
`expires_at`	string (date-time)

{
  "base": "string",
  "quote": "string",
  "rate": "10.00",
  "fetched_at": "2026-01-01T00:00:00.000Z",
  "expires_at": "2026-01-01T00:00:00.000Z"
}

The values are placeholders generated from the schema. They show the shape, not real data.

Errors

A failed request answers with the error format described under Errors.

Besides the codes any endpoint can return, this endpoint can answer with these code values: