Skip to main content

​
What Are Credits?

Credits are the currency of the Mr. Doge API. Instead of monthly subscriptions or complex tier plans, you purchase credits once and use them as you make API requests. Think of credits like prepaid phone minutes - buy what you need, use when you want.
1 credit = 1 API request for most endpoints. No hidden fees, no monthly charges, no commitment.

​
Why Credits Instead of Subscriptions?

Pay Only for What You Use

Don’t waste money on monthly subscriptions when you have seasonal usage. Buy credits when you need them.

No Expiration

Credits never expire. Buy once, use over months or years. Perfect for hobby projects and irregular usage patterns.

Predictable Costs

Know exactly what each API call costs. No surprise bills at the end of the month.

Scale as You Grow

Start small with 20,000 credits ($29.90) and scale up to millions as your usage grows.

​
How Credits Work

1

Purchase Credits

Buy a credit package that fits your needs - from 29.90to29.90 to 999.90
2

Make API Requests

Each API call automatically deducts credits based on the endpoint cost (usually 1 credit)
3

Track Usage

Monitor your credit balance in real-time via response headers and the dashboard
4

Recharge When Needed

Buy more credits manually or enable auto-recharge to never run out

​
Credit Consumption

​
Standard Endpoints (1 Credit)

Most endpoints cost 1 credit per request:
  • /v2/matches - Get matches with odds (supports status=live for live events)
  • /v2/matches/{matchId} - Single match details (markets + status)
  • /v2/teams - Search teams
  • /v2/ai/betting-recommendations - AI recommendations (filtered)
  • And 20+ more standard endpoints

​
Free Endpoints (0 Credits)

Some public endpoints are completely free:
  • /v2/health - API health check
  • /v2/regions - Available regions/countries
  • /v2/competitions - List competitions
  • /v2/stats - System statistics

​
Premium Endpoints (2-10 Credits)

Advanced features cost more:
  • /v2/bets/bet-items/{betItemId}/odds-movement - 2 credits - Historical odds data
  • /v2/matches/{eventId}/live-odds - 2 credits - Current live odds
  • /v2/ai/value-opportunities - 5 credits - Best value bets with edge analysis
  • /v2/ai/mrdoge-picks - 10 credits - Featured parlay picks with AI analysis

Full Pricing Details

See complete pricing, packages, and how to purchase credits

​
Monitoring Your Credits

​
Response Headers

Every API response includes your credit status: 
HTTP/1.1 200 OK
X-Credits-Remaining: 19850
X-Credits-Consumed: 1
X-Auto-Recharge: false
Example in code: 
const response = await fetch('https://api.mrdoge.co/v2/matches?locale=en', {
  headers: { 'Authorization': 'Bearer sk_live_...' }
});

console.log('Remaining:', response.headers.get('X-Credits-Remaining')); // 19850
console.log('This request cost:', response.headers.get('X-Credits-Consumed')); // 1
You can also monitor your credit balance and usage analytics in the dashboard.

​
What Happens When Credits Run Out?

When your balance reaches 0 credits, the API will:
  1. Return HTTP 402 (Payment Required)
  2. Provide error details: 
    {
  "statusCode": 402,
  "message": "Insufficient credits",
  "creditsRequired": 1,
  "creditsRemaining": 0,
  "error": "Payment Required"
}
  3. Stop processing requests until credits are added

​
Solutions

  1. Log in to the dashboard
  2. Go to Credits → Purchase
  3. Select a package
  4. Complete payment
  5. Credits are added within seconds

Setup Auto-Recharge

Configure automatic credit top-ups

​
Optimizing Credit Usage

Save credits with these best practices:

Cache Responses

Store frequently-accessed data (regions, competitions) locally instead of fetching repeatedly.

Use Free Endpoints

Leverage free endpoints like /v2/regions and /v2/stats for reference data.

Batch Requests

Use filters to get multiple events in one request instead of calling events individually.

Smart Polling

For live data, poll every 10-20 seconds instead of every second.

​
Example: Efficient vs. Inefficient

// Fetching 100 events individually
for (let i = 0; i < 100; i++) {
  await fetch(`https://api.mrdoge.co/v2/matches/${eventIds[i]}?locale=en`, {
    headers: { 'Authorization': 'Bearer sk_live_...' }
  }); // 100 requests = 100 credits
}

​
Usage Examples

Let’s see how far credits go in real-world scenarios:
Daily Usage:
  • Fetch events 3 times/day: 3 credits
  • Get trending events 2 times/day: 2 credits
  • Fetch AI recommendations for 10 events: 10 credits
  • Total per day: 15 credits
  • Package lasts: ~3.6 years
Perfect for hobby projects or apps with < 1,000 users.
Daily Usage:
  • Fetch events every hour: 24 credits
  • Live events every 5 minutes: 288 credits
  • 50 AI recommendations: 50 credits
  • Total per day: 362 credits
  • Package lasts: ~276 days
Great for production apps with moderate traffic.
Daily Usage:
  • Events endpoint: 1,000 requests = 1,000 credits
  • Live odds: 5,000 requests = 5,000 credits
  • AI picks: 200 requests = 2,000 credits
  • Total per day: 8,000 credits
  • Package lasts: ~250 days
Built for high-traffic betting platforms.

​
FAQs

No, never. Credits remain in your account indefinitely until you use them. Buy once, use whenever you want - even years later.
No. Credits are like gift cards - non-refundable once purchased. However, since they never expire, you can use them at any time in the future.
Contact [email protected] within 24 hours if you made a purchase error. We’ll review on a case-by-case basis.
No. Credits are tied to your account and cannot be transferred. For team/organization use, create a shared account.
There’s no concept of “rollover” because credits never expire. Every credit you purchase stays in your account forever.

​
Next Steps

View Pricing & Purchase

See all packages, pricing details, and purchase credits

Get Started

Make your first API request with your credits

Authentication

Learn how to create and manage API keys

Dashboard

Monitor usage and manage credits