[routes-d] GET /api/routes-d/exchange-rate — get USDC to NGN exchange rate

[davedumto]

Overview

Implement a `GET` handler that returns the current USDC to NGN exchange rate by calling the existing exchange rate utility in the codebase.

⚠️ Scope: Write your code only inside `app/api/routes-d/exchange-rate/route.ts`. Do not wire this into any page, component, or existing route.

---

Create the route file

File: `app/api/routes-d/exchange-rate/route.ts`

Note: The existing `app/api/exchange-rate/` route handles this for the main app. Do NOT modify that file. Write a fresh, standalone handler in the `routes-d` folder only.

Handler logic

1. No auth required — exchange rate is public data
2. Check the existing `app/api/exchange-rate/route.ts` to understand how the rate is fetched in this codebase, then replicate the same approach in your file
3. Return the rate along with a timestamp

Expected response

```json
{
"rate": {
"from": "USDC",
"to": "NGN",
"value": 1620.50,
"fetchedAt": "2025-01-01T12:00:00.000Z"
}
}
```

Error handling

If the upstream rate fetch fails, return:

```json
{ "error": "Unable to fetch exchange rate" }
```

Status: `503 Service Unavailable`

---

Acceptance criteria

• Returns `200` with rate object including `fetchedAt` timestamp
• No authentication required
• Returns `503` with descriptive error if upstream rate source is unavailable
• `value` is a number, not a string

[Iknow6aint]

@Iknow6aint has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hello can i work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Iknow6aint to this issue.

[FabSignal]

@FabSignal has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hi Dave! I’m Fab, a full-stack dev, and I’d like to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @FabSignal to this issue.

[Mmesolove]

@Mmesolove has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hi, maintainer I would love to work on this kindly assign to me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Mmesolove to this issue.

[Depo-dev]

@Depo-dev has applied to work on this issue as part of the Stellar Wave Program's 4th wave.

Hello, I’m Damola, a software engineer with full-stack experience and a strong background in integrating external data services into APIs. I’ve worked on financial and pricing endpoints before, so I understand the importance of reliability, proper error handling, and clean response structures.

For this issue in davedumto/LancePay, I’ll implement the exchange rate endpoint by reusing the existing logic from the main exchange rate route, ensuring consistency across the codebase. I’ll return the rate along with a timestamp, handle upstream failures gracefully with a 503 response, and make sure the value is correctly typed as a number. The implementation will remain isolated to the specified route, with no unnecessary dependencies, and I’ll verify that everything runs correctly and passes CI before submitting the PR.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Depo-dev to this issue.

[drips-wave]

Congratulations, @Depo-dev! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on April 29, 2026.

🧑‍💻 @Depo-dev: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @Depo-dev as part of the Stellar Wave Program's 4th Wave 🥳

😎 @Depo-dev: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.