> ## Documentation Index > Fetch the complete documentation index at: https://docs.services.payward.com/llms.txt > Use this file to discover all available pages before exploring further. # List Asset Rates > Returns historical rates for a given asset. The response includes a timestamp and price for each interval in the requested time window. Use `quote_symbol` and `quote_type` to choose the asset used for pricing. ## OpenAPI ````yaml /api-reference/openapi_v3_pws.json get /v1/assets/{asset_type}/{asset_symbol}/rates openapi: 3.1.0 info: title: Payward Services API description: >- The Payward Services (PWS) public API. PWS exposes Swaps (institutional FX-style trading), Conversions (rule-driven and one-shot fiat ↔ crypto value movement), retail-style Quotes and Price Trigger Swaps, end-user Users / Verifications, Funds (deposits, withdrawals, addresses, transactions), Portfolio, Earn, Reports, Webhooks, and Ramp (hosted fiat-to-crypto on-ramp checkout). All requests must be authenticated. All monetary values are decimal strings; all timestamps are ISO 8601 UTC. List endpoints are cursor-paginated. Errors follow a uniform shape (see `*ErrorResponse` schemas). version: v1 contact: name: Payward Services API Support url: https://docs.payward.com email: api-support@payward.com servers: - url: https://api.services.payward.com description: Production security: - ApiKey: [] ApiNonce: [] ApiSign: [] tags: - name: Users description: >- Users and headless-user onboarding flows that the partner manages. - **Create User** provisions a user with full identity verification fields collected up front. - **Create Headless User** provisions a lightweight user when your licensing agreement allows you to manage KYC data outside Payward. - **Get User** retrieves the user's profile, verification status, and required actions. - **Update User** updates user profile fields and may re-trigger verification. Use the returned user `id` for calls that require the user's identifier. - name: Assets description: >- Catalog of assets available on the platform with retail-display metadata (logos, market data, descriptions). - name: Conversions description: >- Rule-driven and one-shot fiat ↔ crypto value movement, including conversion rules, deposits, and whitelisted wallets. - name: Earn description: >- Manage auto-earn preferences and retrieve allocation and reward information. - name: Funds description: >- Deposits, withdrawals, addresses, methods, and the consolidated funding-transactions ledger. - name: Portfolio description: End-user portfolio summary, history, and transaction views. - name: Price Trigger Swaps description: Limit-style orders that execute when a configured price trigger is met. - name: On-chain Swaps description: >- Wallet-funded onchain quote trading for xStock and USDC pairs. On-chain quotes settle on-chain through the Payward on-chain proxy contract. - name: Ramp description: >- Hosted fiat-to-crypto on-ramp checkout: country / fiat / payment-method / cryptocurrency-asset discovery, transaction limits and prospective quotes, and the hosted checkout URL. - name: Reports description: Settlement and reconciliation reports for the partner. - name: Swaps description: >- Direct partner-to-Payward swap quotes and executions (institutional FX-style trading). - name: Verifications description: Identity verification (KYC) submission and status for end users. - name: Webhooks description: Manage webhook subscriptions for asynchronous event delivery. paths: /v1/assets/{asset_type}/{asset_symbol}/rates: get: tags: - Assets summary: List Asset Rates description: >- Returns historical rates for a given asset. The response includes a timestamp and price for each interval in the requested time window. Use `quote_symbol` and `quote_type` to choose the asset used for pricing. operationId: listAssetRates parameters: - in: path name: asset_type required: true description: >- Classification of the asset (`fiat`, `crypto`, `stablecoin`, or `xstock`). schema: type: string enum: - fiat - crypto - stablecoin - xstock - in: path name: asset_symbol required: true description: Asset name (e.g., `BTC`, `ETH`, `USD`). schema: $ref: '#/components/schemas/AssetSymbol' - in: query name: country required: true description: >- ISO 3166-1 alpha-2 country code used to apply geo restrictions (e.g. `US`, `GB`). schema: type: string pattern: ^[A-Z]{2}$ example: US - in: query name: quote_symbol description: >- Ticker symbol of the fiat quote asset to use for valuations (e.g. `USD`, `EUR`). Defaults to `USD`. schema: type: string minLength: 3 maxLength: 16 default: USD example: USD - in: query name: quote_type description: >- Classification of the quote asset. Currently only `fiat` is supported. schema: type: string enum: - fiat default: fiat - in: query name: start_timestamp description: >- Start of the time window (inclusive). Only results whose timestamp is greater than or equal to `start_timestamp` are returned. deprecated: false schema: type: - string - 'null' format: date-time example: '2025-06-30T00:00:00.000Z' style: form allowEmptyValue: true - in: query name: end_timestamp description: >- End of the time window (exclusive). Only results whose timestamp is strictly less than `end_timestamp` are returned. deprecated: false schema: type: - string - 'null' format: date-time example: '2025-06-30T00:00:00.000Z' style: form allowEmptyValue: true - in: query name: interval description: > If provided, shows the history of the asset in the given interval. Should be in the format of an [ISO 8601 duration]. Supported resolutions: 1min, 5min, 15min, 30min, 60min, 4H, 1D, 7D, 15D deprecated: false schema: type: - string - 'null' format: duration example: PT15M style: form allowEmptyValue: true - in: query name: page_size schema: description: >- Maximum number of results to return on a single page. Defaults to 20, maximum 100. type: integer format: int32 minimum: 1 maximum: 25 default: 20 style: form - in: query name: page_token schema: description: >- Opaque page token returned by a previous response's `next_page_token`. Omit to start from the beginning. type: string minLength: 1 maxLength: 256 style: form responses: '200': description: Response content: application/json: schema: type: object properties: data: description: List of historical records type: array items: $ref: '#/components/schemas/PriceTick' quote_symbol: description: >- The asset used as the quote currency for all rates in `data`. Echoes the `quote_symbol` query parameter (or its default). type: string maxLength: 16 example: USD quote_type: description: >- Classification of the quote asset. Echoes the `quote_type` query parameter (or its default). type: string enum: - fiat start_timestamp: description: >- Start of the time window covered by `data`. Echoes the `start_timestamp` query parameter (or its default). type: string format: date-time end_timestamp: description: >- End of the time window covered by `data`. Echoes the `end_timestamp` query parameter (or its default). type: string format: date-time interval: description: >- Granularity of each row in `data`. Echoes the `interval` query parameter. type: - string - 'null' format: duration example: PT15M page_size: description: >- Maximum number of results returned on this page. Echoes the `page_size` query parameter (or its default). type: integer format: int32 minimum: 1 maximum: 100 next_page_token: description: >- Opaque token for the next page of results. Absent when there are no more pages. type: string minLength: 1 maxLength: 256 required: - data - quote_symbol - quote_type - start_timestamp - end_timestamp - interval - page_size example: data: - timestamp: '2026-04-21T00:00:00Z' price: '64218.34' - timestamp: '2026-04-22T00:00:00Z' price: '64902.11' - timestamp: '2026-04-23T00:00:00Z' price: '65430.78' - timestamp: '2026-04-24T00:00:00Z' price: '66120.05' - timestamp: '2026-04-25T00:00:00Z' price: '66890.42' - timestamp: '2026-04-26T00:00:00Z' price: '67234.18' quote_symbol: USD quote_type: fiat start_timestamp: '2026-04-21T00:00:00Z' end_timestamp: '2026-04-26T23:59:59Z' interval: P1D page_size: 20 next_page_token: null examples: btc-15m-window: summary: Two 15-minute candles for BTC priced in USD value: data: - timestamp: '2026-01-01T00:00:00Z' midpoint: '94250.12' - timestamp: '2026-01-01T00:15:00Z' midpoint: '94381.50' quote_symbol: USD quote_type: fiat start_timestamp: '2026-01-01T00:00:00Z' end_timestamp: '2026-01-01T00:30:00Z' interval: PT15M page_size: 20 headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '403': description: Permission denied content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/NotFoundErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '408': description: Deadline exceeded content: application/json: schema: $ref: '#/components/schemas/DeadlineExceededErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ConflictErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' Retry-After: $ref: '#/components/headers/RetryAfter' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' '503': description: Service unavailable content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableErrorResponse' headers: Request-Id: $ref: '#/components/headers/RequestId' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Strict-Transport-Security: $ref: '#/components/headers/StrictTransportSecurity' X-Content-Type-Options: $ref: '#/components/headers/XContentTypeOptions' Content-Security-Policy: $ref: '#/components/headers/ContentSecurityPolicy' Cache-Control: $ref: '#/components/headers/CacheControl' security: [] x-codeSamples: - lang: bash label: curl source: >- curl -X GET "https://api.services.payward.com/v1/assets/stablecoin/USDC/rates" components: schemas: AssetSymbol: description: Ticker symbol of an asset (e.g. `BTC`, `USDC`, `EUR`). type: string minLength: 3 maxLength: 16 example: BTC PriceTick: type: object properties: timestamp: $ref: '#/components/schemas/DateTime' midpoint: description: >- Midpoint between best bid and best ask, denominated in the quote asset. allOf: - $ref: '#/components/schemas/BigDecimal' required: - midpoint - timestamp ValidationErrorResponse: description: The request was rejected because the client supplied invalid input. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 400 instance: type: string code: type: string enum: - bad_request doc_url: type: string format: uri causes: type: array items: $ref: '#/components/schemas/ValidationCause' required: - type - status - instance - code required: - error UnauthenticatedErrorResponse: description: Authentication credentials were missing or invalid. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 401 instance: type: string code: type: string enum: - unauthenticated doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error ForbiddenErrorResponse: description: The caller is authenticated but is not allowed to perform this action. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 403 instance: type: string code: type: string enum: - forbidden doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error NotFoundErrorResponse: description: The requested resource does not exist. type: object properties: error: description: Error details. type: object properties: type: type: string enum: - request_error status: type: integer format: uint16 enum: - 404 instance: type: string code: type: string enum: - not_found doc_url: type: - string - 'null' format: uri required: - type - status - instance - code required: - error DeadlineExceededErrorResponse: description: The upstream request deadline was exceeded. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 504 instance: type: string code: type: string enum: - deadline_exceeded doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error ConflictErrorResponse: description: Generic state conflict that does not match a more specific 409 code. type: object properties: error: type: object properties: type: type: string enum: - state_error status: type: integer format: uint16 enum: - 409 instance: type: string code: type: string enum: - conflict doc_url: type: - string - 'null' required: - type - status - instance - code required: - error RateLimitErrorResponse: description: The request rate limit was exceeded. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 429 instance: type: string code: type: string enum: - resource_exhausted doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error InternalErrorResponse: description: An internal server error occurred. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 500 instance: type: string code: type: string enum: - internal doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error ServiceUnavailableErrorResponse: description: The service is temporarily unavailable. type: object properties: error: description: Error details. type: object properties: type: type: string status: type: integer format: int32 enum: - 503 instance: type: string code: type: string enum: - unavailable doc_url: type: string format: uri causes: type: array items: type: object additionalProperties: true required: - type - status - instance - code required: - error DateTime: type: string format: date-time description: A RFC 3339 datetime example: '2023-03-13T12:34:56Z' BigDecimal: type: string format: decimal128 example: '1.23' pattern: ^-?[0-9]+(\.[0-9]+)?$ minLength: 1 maxLength: 64 ValidationCause: description: One failed field-level validation rule. type: object properties: field: description: Dot-notation path to the offending request field. type: string message: description: Human-readable explanation of the failed validation rule. type: string required: - field - message headers: RequestId: description: >- Unique identifier for tracing this request across services. Include in support tickets. schema: type: string format: uuid example: 5f4d2a8e-91a4-4d6c-8a17-9b1e2c3f4a5b RateLimitLimit: description: Total requests allowed in the current window. schema: type: integer example: 1000 RateLimitRemaining: description: Requests remaining in the current window. schema: type: integer example: 955 RateLimitReset: description: Unix timestamp (seconds) when the rate-limit window resets. schema: type: integer format: int64 example: 1713182400 StrictTransportSecurity: description: >- Enforces HTTPS for the configured period. Always `max-age=63072000; includeSubDomains; preload`. schema: type: string example: max-age=63072000; includeSubDomains; preload XContentTypeOptions: description: Disables MIME sniffing. Always `nosniff`. schema: type: string enum: - nosniff example: nosniff ContentSecurityPolicy: description: >- Prevents embedding and resource loading. Always `default-src 'none'; frame-ancestors 'none'`. schema: type: string example: default-src 'none'; frame-ancestors 'none' CacheControl: description: Prevents caching of sensitive financial data. Always `no-store`. schema: type: string enum: - no-store example: no-store RetryAfter: description: Seconds the client should wait before retrying. schema: type: integer example: 30 securitySchemes: ApiKey: type: apiKey name: API-Key in: header description: Your public API key. Identifies the partner making the request. ApiNonce: type: apiKey name: API-Nonce in: header description: Monotonically increasing nonce included in the request signature. ApiSign: type: apiKey name: API-Sign in: header description: HMAC signature over the request, computed with your private key. ````