> ## Documentation Index > Fetch the complete documentation index at: https://docs.halliday.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Get token prices > Get the current price of one or more tokens denominated in a fiat currency. The response is a map keyed by the normalized token identifier (`chain:address`, lowercased) with the price as a decimal string. The fiat currency itself is included as a key (for example `usd`) with a value of `1.0`. The `usd` value is always included, even when the requested fiat is something like `eur`. Tokens that do not have a price will be left out of the response. ## OpenAPI ````yaml /public/openapi.yaml post /prices openapi: 3.1.0 info: title: Halliday description: > Halliday's payment infrastructure, supporting onramps, swaps, and offramps. This API provides a unified interface for cryptocurrency payments, allowing developers to: - Quote payments across multiple providers - Execute payments with onramps, swaps, and offramps - Track payment status and history ## Authentication API key authentication is required for all endpoints. version: 2.0.0 contact: name: Contact Halliday url: https://halliday.xyz email: support@halliday.xyz servers: - url: https://v2.prod.halliday.xyz description: Base domain security: - ApiKeyAuth: [] tags: - name: Chains description: Blockchain network information and configuration - name: Assets description: Asset information, discovery, and supported asset pairs - name: Geolocation description: >- Resolve an end user's IP address to a location and default fiat currency before quoting - name: Prices description: Current token prices denominated in a fiat currency - name: Payments description: >- Core payment operations including quotes, confirmation, and status tracking - name: Webhooks description: > Register HTTPS endpoints to receive signed notifications when a workflow reaches a terminal state, instead of polling for status. You subscribe to one or more event types per webhook. | Event type | Fires when a workflow's status becomes | | --- | --- | | `WORKFLOW_COMPLETED` | `COMPLETE` | | `WORKFLOW_FAILED` | `FAILED` | All management endpoints live under `/orgs/webhooks` and authenticate with a secret API key (passed as a bearer token) that has webhook access. Publishable keys cannot manage webhooks. **Integration checklist** - Receiver is a public HTTPS endpoint (no private IPs). - Save the `signing_secret` when you create the webhook — it is shown only once. - Verify `X-Halliday-Signature` against the raw body, accepting any of its comma-separated signatures. - Respond `2xx` quickly and do the real work afterward. - Skip deliveries whose `id` you have already handled. paths: /prices: post: tags: - Prices summary: Get token prices description: > Get the current price of one or more tokens denominated in a fiat currency. The response is a map keyed by the normalized token identifier (`chain:address`, lowercased) with the price as a decimal string. The fiat currency itself is included as a key (for example `usd`) with a value of `1.0`. The `usd` value is always included, even when the requested fiat is something like `eur`. Tokens that do not have a price will be left out of the response. operationId: getPrices requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PricesRequest' example: fiat: USD tokens: - ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 - base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 responses: '200': description: Prices retrieved successfully content: application/json: schema: $ref: '#/components/schemas/PricesResponse' example: ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48: '0.9999' base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913: '0.9999' usd: '1.0' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' example: errors: - code: custom path: - tokens - 0 message: 'Unknown Chain: ''nope''' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: errors: - kind: other message: Invalid API key components: schemas: PricesRequest: type: object required: - fiat - tokens properties: fiat: $ref: '#/components/schemas/Fiat' tokens: type: array description: Tokens to price items: $ref: '#/components/schemas/Token' PricesResponse: type: object description: >- Normalized token identifier (`chain:address`, lowercased) mapped to its price in the requested fiat currency. The fiat currency is included as a key with a value of `1.0`. additionalProperties: type: string description: Price as a decimal string example: '0.9999' ValidationErrorResponse: type: object description: > Returned when a request body fails schema validation. `errors` contains one entry per validation issue. required: - errors properties: errors: type: array items: type: object required: - code - path - message properties: code: type: string description: Validation issue code (for example `invalid_type`). example: invalid_type expected: type: string description: Expected type. Present on type-mismatch issues. example: string path: type: array description: Path to the offending field in the request body. items: type: - string - integer example: - label message: type: string example: 'Invalid input: expected string, received undefined' ErrorResponse: type: object required: - errors properties: errors: type: array items: $ref: '#/components/schemas/Issue' description: Error response for known errors Fiat: type: string description: Fiat currency code example: USD Token: type: string description: Token identifier in the format "chain:address" pattern: ^[a-z]+:0x[a-fA-F0-9]+$ example: ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 Issue: oneOf: - $ref: '#/components/schemas/AmountIssue' - $ref: '#/components/schemas/AmountDownstreamIssue' - $ref: '#/components/schemas/FundingIssue' - $ref: '#/components/schemas/OwnerIssue' - $ref: '#/components/schemas/GeolocationIssue' - $ref: '#/components/schemas/ProviderIssue' - $ref: '#/components/schemas/PayinMethodIssue' - $ref: '#/components/schemas/OtherIssue' - $ref: '#/components/schemas/UnknownIssue' - $ref: '#/components/schemas/OrgConfigurationIssue' - $ref: '#/components/schemas/ParkedFundIssue' - $ref: '#/components/schemas/DestinationIssue' - $ref: '#/components/schemas/PayoutMethodIssue' - $ref: '#/components/schemas/KycIssue' discriminator: propertyName: kind AmountIssue: type: object required: - kind - asset - given - limits - source - message - reason properties: kind: type: string enum: - amount asset: $ref: '#/components/schemas/Asset' given: $ref: '#/components/schemas/Amount' limits: $ref: '#/components/schemas/Limits' downstream_limits: $ref: '#/components/schemas/Limits' source: type: string message: type: string reason: type: string enum: - TOO_LOW - TOO_HIGH - UNEXPECTEDLY_LOW - UNEXPECTEDLY_HIGH - NO_VALID_AMOUNT - UNKNOWN AmountDownstreamIssue: type: object required: - kind - asset - given - limits - source - message - reason properties: kind: type: string enum: - amount-downstream asset: $ref: '#/components/schemas/Asset' given: $ref: '#/components/schemas/Amount' limits: $ref: '#/components/schemas/Limits' downstream_limits: $ref: '#/components/schemas/Limits' source: type: string message: type: string reason: type: string enum: - TOO_LOW - TOO_HIGH - UNEXPECTEDLY_LOW - UNEXPECTEDLY_HIGH - NO_VALID_AMOUNT - UNKNOWN FundingIssue: type: object required: - kind - token - balance properties: kind: type: string enum: - funding token: $ref: '#/components/schemas/Token' balance: type: object required: - '#' properties: '#': type: string description: Balance amount as a decimal string. description: Current token balance at the funding address. OwnerIssue: type: object required: - kind - message - mitigation properties: kind: type: string enum: - owner message: type: string mitigation: type: string enum: - change - verify GeolocationIssue: type: object required: - kind - message properties: kind: type: string enum: - geolocation message: type: string ProviderIssue: type: object required: - kind - message properties: kind: type: string enum: - provider message: type: string PayinMethodIssue: type: object required: - kind - message properties: kind: type: string enum: - payin_method message: type: string OtherIssue: type: object required: - kind - message properties: kind: type: string enum: - other message: type: string UnknownIssue: type: object required: - kind - message properties: kind: type: string enum: - unknown message: type: string OrgConfigurationIssue: type: object required: - kind - message properties: kind: type: string enum: - org_configuration message: type: string rev_share_pct: type: string total_pct: type: string threshold: type: string ParkedFundIssue: type: object description: >- Funds are held at a deposit address associated with the owner and are not being processed. required: - kind - token - balance - classification - severity - payment_gist - withdraw_from properties: kind: type: string enum: - parked_fund token: $ref: '#/components/schemas/Token' balance: type: object required: - '#' properties: '#': type: string description: >- Integer amount in the token's smallest unit, serialized as a string. example: '25500000' description: > Token balance parked at the address, as an integer in the token's smallest unit. The `{"#": "..."}` wrapper is how the API serializes integers too large for a JSON number. Divide by the token's `decimals` from `GET /assets` to display it, for example `{"#": "25500000"}` is 25.5 USDC. Note that `POST /payments/balances` reports the same funds as a plain decimal string (`"25.5"`). classification: type: string enum: - MISSENT - STUCK - UNDERFUNDED - STALLED - EXTRA - SLIPPED - DELAYED description: Why the funds are parked. severity: type: string enum: - HIGH - LOW payment_gist: $ref: '#/components/schemas/PaymentGist' description: Summary of the payment the funds were intended for, or null. withdraw_from: $ref: '#/components/schemas/WithdrawFrom' description: >- Where the parked funds can be withdrawn from, or null if they cannot be withdrawn through the API. DestinationIssue: type: object required: - kind - message properties: kind: type: string enum: - destination message: type: string PayoutMethodIssue: type: object required: - kind - message properties: kind: type: string enum: - payout_method message: type: string KycIssue: type: object required: - kind - message properties: kind: type: string enum: - kyc message: type: string provider_id: type: string Asset: type: string description: >- Identifier in the token format ("chain:address") or fiat currency code ("USD") example: ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 Amount: type: string description: A decimal amount string. Limits: type: object properties: min: type: string description: Minimum amount as a decimal string. max: type: string description: Maximum amount as a decimal string. PaymentGist: anyOf: - type: object required: - op - destination_address - destination_token properties: op: type: string enum: - buy destination_address: type: string destination_token: $ref: '#/components/schemas/Token' - type: 'null' description: Summary of a payment, or null. WithdrawFrom: anyOf: - type: object required: - withdraw_type - payment_id - withdraw_account properties: withdraw_type: type: string enum: - PAYMENT payment_id: type: string format: uuid withdraw_account: type: string enum: - INTENT - SPW - RDW - type: object required: - withdraw_type - rdw_address properties: withdraw_type: type: string enum: - EXTRA_RDW_BALANCE rdw_address: type: string - type: 'null' description: >- Where funds can be withdrawn from, or null if they cannot be withdrawn through the API. securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API_KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.