Returns buy and sell market rate bands (reference rate plus min/max tolerance) for a token/fiat pair. Use this to validate whether a sender-provided rate on order creation is within allowed bounds.
Response shape (data)
Field
Type
Description
buy
object (optional)
Buy-side band — see fields below
sell
object (optional)
Sell-side band — see fields below
Each side object:
Field
Type
Description
marketRate
string
Reference market rate for this side (fiat per crypto)
minimumRate
string
Minimum allowed rate for this side
maximumRate
string
Maximum allowed rate for this side
position
object (optional)
Rate benchmark vs. best public peer — see below
Numeric values are returned as strings (decimal). Either side may be omitted depending on corridor configuration.
position object
When qualifying public offers exist for this corridor, each side includes a position object so you can see how your effective rate compares to the best public peer:
Field
Type
Description
bestPublicRate
string
Best rate among enabled non-testnet public peers (highest for sell; lowest for buy)
yourEffectiveRate
string
Your own effective rate for this corridor and side
deltaVsBest
string
yourEffectiveRate − bestPublicRate
Interpreting deltaVsBest:
Sell (off-ramp): a positive delta means your rate is higher than the best peer — you are more competitive.
Buy (on-ramp): a negative delta means your rate is lower than the best peer — you are more competitive.
position is omitted when:
No qualifying public offers exist for the corridor, or
You have no effective rate configured for this corridor.
The reference fields marketRate, minimumRate, and maximumRate are unchanged — position is purely additive (backward compatible).The benchmark pool uses all enabled, non-testnet networks; it is not filtered by the {token}/{fiat} path parameters’ network.
GET /v1/provider/rates/{token}/{fiat} uses the same response shape as this v2 route, including the position field. See Get Market Rate (v1).
Authorizations
API-Key
string
header
required
Path Parameters
token
string
required
fiat
string
required
Response
Market rate
status
string
Example:
"success"
message
string
Example:
"Operation successful"
data
object
Market rate bounds split by side. Either or both of buy and sell may be present depending on corridor configuration.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Paycrest","colors":{"primary":"#3B82F6","light":"#F8FAFC","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/paycrest-ee534df1/1KJUqwVXLoIPJVij/logo/light.svg?fit=max\u0026auto=format\u0026n=1KJUqwVXLoIPJVij\u0026q=85\u0026s=c6db6fb90e95231160524cb515a51dd0","dark":"https://mintcdn.com/paycrest-ee534df1/1KJUqwVXLoIPJVij/logo/dark.svg?fit=max\u0026auto=format\u0026n=1KJUqwVXLoIPJVij\u0026q=85\u0026s=7f53003e64f81035e8f3a1faf6f380a1"},"favicon":"https://mintcdn.com/paycrest-ee534df1/1KJUqwVXLoIPJVij/logo/favicon.png?fit=max\u0026auto=format\u0026n=1KJUqwVXLoIPJVij\u0026q=85\u0026s=8711906a377765a909494b9fdd1f65a0","navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://github.com/paycrest","label":"GitHub"},{"href":"https://t.me/+Stx-wLOdj49iNDM0","label":"Community"}]},"footer":{"socials":{"x":"https://x.com/paycrest","github":"https://github.com/paycrest","linkedin":"https://www.linkedin.com/company/paycrest"}},"seo":{"metatags":{"base:app_id":"69f2113a05020c0316bbbf92"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paycrest-ee534df1","hasAudioNarration":false,"actualSubdomain":"paycrest-ee534df1","customDomains":["docs.paycrest.io"],"gitSource":{"type":"github","owner":"paycrest","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd9d9b921026410dbb2798","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Guides","count":17},{"language":"default","tag":"General","count":16},{"language":"default","tag":"Sender","count":12},{"language":"default","tag":"Provider","count":9},{"language":"default","tag":"Resources","count":5},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"For Senders","count":4},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Getting Started","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/provider/get-market-rate","slug":"/api-reference/provider/get-market-rate","pageMetadata":{"title":"Get Market Rate","openapi":"openapi-v2.yaml GET /provider/rates/{token}/{fiat}","description":null,"href":"/api-reference/provider/get-market-rate"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns `,_jsx(_components.strong,{children:`buy`}),` and `,_jsx(_components.strong,{children:`sell`}),` market rate `,_jsx(_components.strong,{children:`bands`}),` (reference rate plus min/max tolerance) for a token/fiat pair. Use this to validate whether a sender-provided `,_jsx(_components.code,{children:`rate`}),` on order creation is within allowed bounds.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`response-shape-data`,children:[`Response shape (`,_jsx(_components.code,{children:`data`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`buy`})}),_jsx(_components.td,{children:`object (optional)`}),_jsx(_components.td,{children:`Buy-side band — see fields below`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sell`})}),_jsx(_components.td,{children:`object (optional)`}),_jsx(_components.td,{children:`Sell-side band — see fields below`})]})]})]}),`\n`,_jsx(_components.p,{children:`Each side object:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`marketRate`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Reference market rate for this side (fiat per crypto)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`minimumRate`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Minimum allowed rate for this side`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`maximumRate`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Maximum allowed rate for this side`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`position`})}),_jsx(_components.td,{children:`object (optional)`}),_jsx(_components.td,{children:`Rate benchmark vs. best public peer — see below`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Numeric values are returned as `,_jsx(_components.strong,{children:`strings`}),` (decimal). Either side may be omitted depending on corridor configuration.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`position-object`,children:[_jsx(_components.code,{children:`position`}),` object`]}),`\n`,_jsxs(_components.p,{children:[`When qualifying public offers exist for this corridor, each side includes a `,_jsx(_components.code,{children:`position`}),` object so you can see how your effective rate compares to the best public peer:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bestPublicRate`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Best rate among enabled non-testnet public peers (highest for sell; lowest for buy)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`yourEffectiveRate`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Your own effective rate for this corridor and side`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deltaVsBest`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`yourEffectiveRate − bestPublicRate`})})]})]})]}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Interpreting `,_jsx(_components.code,{children:`deltaVsBest`}),`:`]})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sell`}),` (off-ramp): a `,_jsx(_components.strong,{children:`positive`}),` delta means your rate is higher than the best peer — you are more competitive.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Buy`}),` (on-ramp): a `,_jsx(_components.strong,{children:`negative`}),` delta means your rate is lower than the best peer — you are more competitive.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`position`}),` is `,_jsx(_components.strong,{children:`omitted`}),` when:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`No qualifying public offers exist for the corridor, or`}),`\n`,_jsx(_components.li,{children:`You have no effective rate configured for this corridor.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The reference fields `,_jsx(_components.code,{children:`marketRate`}),`, `,_jsx(_components.code,{children:`minimumRate`}),`, and `,_jsx(_components.code,{children:`maximumRate`}),` are `,_jsx(_components.strong,{children:`unchanged`}),` — `,_jsx(_components.code,{children:`position`}),` is purely additive (backward compatible).`]}),`\n`,_jsxs(_components.p,{children:[`The benchmark pool uses all enabled, non-testnet networks; it is not filtered by the `,_jsx(_components.code,{children:`{token}/{fiat}`}),` path parameters’ network.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`26`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`26`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rate fetched successfully\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sell\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marketRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1605.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minimumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1580.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maximumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1630.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bestPublicRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1608.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"yourEffectiveRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1605.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"deltaVsBest\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"-3.00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"buy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marketRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1598.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minimumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1575.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maximumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1620.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bestPublicRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1595.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"yourEffectiveRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1598.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"deltaVsBest\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3.00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Example when `,_jsx(_components.code,{children:`position`}),` is omitted (no public benchmark available):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rate fetched successfully\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sell\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"marketRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1605.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"minimumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1580.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maximumRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1630.00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`GET /v1/provider/rates/{token}/{fiat}`})}),` uses the same response shape as this v2 route, including the `,_jsx(_components.code,{children:`position`}),` field. See `,_jsx(_components.a,{href:`/api-reference/provider/get-market-rate-v1`,children:`Get Market Rate (v1)`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Market Rate","openapi":"openapi-v2.yaml GET /provider/rates/{token}/{fiat}","description":null,"href":"/api-reference/provider/get-market-rate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Response shape (data)","slug":"response-shape-data","depth":2,"children":[]},{"title":"position object","slug":"position-object","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Provider"],"summary":"Get market rate","security":["a60f7aa2-42ae-417c-be7a-18534050f89f"],"servers":["4c32fd07-b94d-4e2d-9313-ecb6267320e7"],"parameters":["5f5f311c-d7c2-47de-8d04-e530e1ce1242","a77f071e-d342-4bc2-a3f3-37ab069c30b6"],"responses":{"200":"ca2e4e69-d48d-425d-a55b-10377627aec8","400":"3c4a20e3-95ba-44aa-afe8-c96cef1a4e33","401":"6d413b56-eaf2-4aa4-8a01-ee2a85a6a208"},"method":"get","type":"path","path":"/provider/rates/{token}/{fiat}","baseUrlOptions":["https://api.paycrest.io/v2"],"title":"Get market rate","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5f5f311c-d7c2-47de-8d04-e530e1ce1242":{"in":"path","name":"token","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"a77f071e-d342-4bc2-a3f3-37ab069c30b6":{"in":"path","name":"fiat","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"ca2e4e69-d48d-425d-a55b-10377627aec8":{"description":"Market rate","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"success","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","example":"Operation successful","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"Market rate bounds split by side. Either or both of `buy` and `sell` may be present depending on corridor configuration.","properties":{"buy":{"type":"object","description":"Tolerance band for one side (buy or sell) of the market rate.","properties":{"marketRate":{"type":"string","description":"Reference market rate for this side (fiat per crypto).","uniqueKey":"data.buy.marketRate","typeLabel":"string"},"minimumRate":{"type":"string","description":"Minimum allowed rate for this side.","uniqueKey":"data.buy.minimumRate","typeLabel":"string"},"maximumRate":{"type":"string","description":"Maximum allowed rate for this side.","uniqueKey":"data.buy.maximumRate","typeLabel":"string"},"position":{"type":"object","description":"Rate benchmark vs. best public peer. Omitted when no public benchmark exists (backward compatible).","properties":{"bestPublicRate":{"type":"string","description":"Best rate among enabled non-testnet public peers for this side (highest effective sell rate; lowest effective buy rate).","uniqueKey":"data.buy.position.bestPublicRate","typeLabel":"string"},"yourEffectiveRate":{"type":"string","description":"The provider's own effective rate for this corridor and side.","uniqueKey":"data.buy.position.yourEffectiveRate","typeLabel":"string"},"deltaVsBest":{"type":"string","description":"`yourEffectiveRate − bestPublicRate`. For **sell** a positive delta means you offer a higher rate than the best peer (more competitive). For **buy** a negative delta means you offer a lower rate than the best peer (more competitive).\n","uniqueKey":"data.buy.position.deltaVsBest","typeLabel":"string"}},"uniqueKey":"data.buy.position","typeLabel":"object"}},"uniqueKey":"data.buy","typeLabel":"object"},"sell":{"type":"object","description":"Tolerance band for one side (buy or sell) of the market rate.","properties":{"marketRate":{"type":"string","description":"Reference market rate for this side (fiat per crypto).","uniqueKey":"data.sell.marketRate","typeLabel":"string"},"minimumRate":{"type":"string","description":"Minimum allowed rate for this side.","uniqueKey":"data.sell.minimumRate","typeLabel":"string"},"maximumRate":{"type":"string","description":"Maximum allowed rate for this side.","uniqueKey":"data.sell.maximumRate","typeLabel":"string"},"position":{"type":"object","description":"Rate benchmark vs. best public peer. Omitted when no public benchmark exists (backward compatible).","properties":{"bestPublicRate":{"type":"string","description":"Best rate among enabled non-testnet public peers for this side (highest effective sell rate; lowest effective buy rate).","uniqueKey":"data.sell.position.bestPublicRate","typeLabel":"string"},"yourEffectiveRate":{"type":"string","description":"The provider's own effective rate for this corridor and side.","uniqueKey":"data.sell.position.yourEffectiveRate","typeLabel":"string"},"deltaVsBest":{"type":"string","description":"`yourEffectiveRate − bestPublicRate`. For **sell** a positive delta means you offer a higher rate than the best peer (more competitive). For **buy** a negative delta means you offer a lower rate than the best peer (more competitive).\n","uniqueKey":"data.sell.position.deltaVsBest","typeLabel":"string"}},"uniqueKey":"data.sell.position","typeLabel":"object"}},"uniqueKey":"data.sell","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"success","message":"Operation successful","data":{"buy":{"marketRate":"\u003cstring>","minimumRate":"\u003cstring>","maximumRate":"\u003cstring>","position":{"bestPublicRate":"\u003cstring>","yourEffectiveRate":"\u003cstring>","deltaVsBest":"\u003cstring>"}},"sell":{"marketRate":"\u003cstring>","minimumRate":"\u003cstring>","maximumRate":"\u003cstring>","position":{"bestPublicRate":"\u003cstring>","yourEffectiveRate":"\u003cstring>","deltaVsBest":"\u003cstring>"}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"3c4a20e3-95ba-44aa-afe8-c96cef1a4e33":{"description":"Bad request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6d413b56-eaf2-4aa4-8a01-ee2a85a6a208":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"a60f7aa2-42ae-417c-be7a-18534050f89f":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"API-Key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"4c32fd07-b94d-4e2d-9313-ecb6267320e7":{"url":"https://api.paycrest.io/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"API-Key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi-v2.yaml"},"subdomain":"paycrest-ee534df1","siteName":"Paycrest","title":"Get Market Rate - Paycrest","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/provider/get-market-rate","matchLevel":0},"v1":{"href":"/api-reference/provider/list-lock-payment-orders","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T23:22:56.859Z","originalFileLocation":"api-reference/provider/get-market-rate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Paycrest\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Market Rate - Paycrest\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paycrest\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paycrest.io/api-reference/provider/get-market-rate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paycrest-ee534df1.mintlify.site/_mintlify/api/og/v2?division=Provider\u0026amp;title=Get+Market+Rate\u0026amp;theme=0eb6d8922c2e7a499381c97b\u0026amp;signature=0b2d8a1b9ab5ab8fe82564877c276214a7b9b0731628d1e97d18c89a3052c512\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Market Rate - Paycrest\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paycrest-ee534df1.mintlify.site/_mintlify/api/og/v2?division=Provider\u0026amp;title=Get+Market+Rate\u0026amp;theme=0eb6d8922c2e7a499381c97b\u0026amp;signature=0b2d8a1b9ab5ab8fe82564877c276214a7b9b0731628d1e97d18c89a3052c512\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/paycrest-ee534df1/NP63BVAIWeGufkEv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paycrest\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003cmeta data-mint-head name=\"base:app_id\" content=\"69f2113a05020c0316bbbf92\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paycrest.io/api-reference/provider/get-market-rate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/provider/get-market-rate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paycrest.io/#organization\",\"name\":\"Paycrest\",\"url\":\"https://docs.paycrest.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/paycrest-ee534df1/1KJUqwVXLoIPJVij/logo/light.svg?fit=max\u0026auto=format\u0026n=1KJUqwVXLoIPJVij\u0026q=85\u0026s=c6db6fb90e95231160524cb515a51dd0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paycrest.io#website\",\"name\":\"Paycrest\",\"url\":\"https://docs.paycrest.io\",\"publisher\":{\"@id\":\"https://docs.paycrest.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate#webpage\",\"url\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate\",\"name\":\"Get Market Rate\",\"dateModified\":\"2026-10-31T23:22:56.859Z\",\"isPartOf\":{\"@id\":\"https://docs.paycrest.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Provider\",\"item\":\"https://docs.paycrest.io/api-reference/provider/list-orders-v2\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Market Rate\",\"item\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate#apireference\",\"headline\":\"Get Market Rate\",\"name\":\"Get Market Rate\",\"url\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paycrest.io/api-reference/provider/get-market-rate#webpage\"},\"dateModified\":\"2026-10-31T23:22:56.859Z\",\"publisher\":{\"@id\":\"https://docs.paycrest.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paycrest.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paycrest\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Paycrest\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/provider/get-market-rate.md","siteName":"Paycrest","nav":{"global":null,"versions":[{"version":"v2","tag":"Latest","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":null,"href":"/api-reference/authentication"},{"title":null,"href":"/api-reference/errors"}]},{"group":"Sender","pages":[{"title":"Initiate Order","openapi":"openapi-v2.yaml POST /sender/orders","href":"/api-reference/sender/initiate-payment-order-v2"},{"title":"List Orders","openapi":"openapi-v2.yaml GET /sender/orders","href":"/api-reference/sender/list-payment-orders-v2"},{"title":"Get Order by ID","openapi":"openapi-v2.yaml GET /sender/orders/{id}","href":"/api-reference/sender/get-payment-order-by-id-v2"},{"title":"Get Order Status by Gateway ID","openapi":"openapi-v2.yaml GET /orders/{chain_id}/{id}","href":"/api-reference/sender/get-order-by-gateway-id"},{"title":"Get Sender Stats","openapi":"openapi-v2.yaml GET /sender/stats","href":"/api-reference/sender/get-sender-stats"},{"title":"List Webhook Deliveries","openapi":"openapi-v2.yaml GET /sender/webhooks","href":"/api-reference/sender/list-webhook-deliveries"},{"title":"Get Webhook Delivery","openapi":"openapi-v2.yaml GET /sender/webhooks/{id}","href":"/api-reference/sender/get-webhook-delivery-by-id"},{"title":"Retry Webhook Delivery","openapi":"openapi-v2.yaml POST /sender/webhooks/{id}/retry","href":"/api-reference/sender/retry-webhook-delivery"}]},{"group":"Provider","pages":[{"title":"List Orders","openapi":"openapi-v2.yaml GET /provider/orders","href":"/api-reference/provider/list-orders-v2"},{"title":"Get Order by ID","openapi":"openapi-v2.yaml GET /provider/orders/{id}","description":"Returns a single payment order assigned to the authenticated provider, including polymorphic source/destination, providerAccount, and transaction logs.","href":"/api-reference/provider/get-order-by-id-v2"},{"title":"Get Market Rate","openapi":"openapi-v2.yaml GET /provider/rates/{token}/{fiat}","href":"/api-reference/provider/get-market-rate"},{"title":"Get Provider Stats","openapi":"openapi-v2.yaml GET /provider/stats","description":null,"href":"/api-reference/provider/get-provider-stats"},{"title":"Get Node Info","openapi":"openapi-v2.yaml GET /provider/node-info","href":"/api-reference/provider/get-node-info"}]},{"group":"General","pages":[{"title":"List Supported Currencies","openapi":"openapi-v2.yaml GET /currencies","href":"/api-reference/general/list-supported-currencies"},{"title":"List Supported Institutions","openapi":"openapi-v2.yaml GET /institutions/{currency_code}","href":"/api-reference/general/list-supported-institutions"},{"title":"List Supported Tokens","openapi":"openapi-v2.yaml GET /tokens","href":"/api-reference/general/list-supported-tokens"},{"title":"Get Token Rate","openapi":"openapi-v2.yaml GET /rates/{network}/{from}/{amount}/{to}","href":"/api-reference/general/get-token-rate"},{"title":"Get Markets","openapi":"openapi-v2.yaml GET /markets","href":"/api-reference/general/get-markets"},{"title":"Get Aggregator Public Key","openapi":"openapi-v2.yaml GET /pubkey","href":"/api-reference/general/get-aggregator-public-key"},{"title":"Verify Account","openapi":"openapi-v2.yaml POST /verify-account","href":"/api-reference/general/verify-account"},{"title":"Reindex Transaction","openapi":"openapi-v2.yaml GET /reindex/{network}/{tx_hash_or_address}","href":"/api-reference/general/reindex-transaction"}]}]}]},{"version":"v1","tag":"Legacy","pages":[{"title":"v1","href":"/api-reference/provider/list-lock-payment-orders"}]}]},"basePath":"","title":"Get Market Rate - Paycrest","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}