para

head

OpenRouter::API::Result::ActivityRow - One daily activity / spending row


code

=begin code :lang<raku>

# Requires a management key — see OpenRouter::API::Client.
my @rows = $or.get-activity;
for @rows -> $r {
    printf "%s  %-32s  %6d reqs  \$%7.4f  %d in / %d out\n",
        $r.date, $r.model, $r.requests, $r.cost,
        $r.prompt-tokens, $r.completion-tokens;
}

=end code


Wraps one entry from C<GET /activity>. Each row aggregates a single
UTC date × model × endpoint × provider. Use
C<cost-per-1k-tokens> when comparing across rows — raw cost is hard
to reason about without dividing by volume.



unit class OpenRouter::API::Result::ActivityRow;

has %!data;

submethod BUILD(:%!data) { }

method new(:%data --> OpenRouter::API::Result::ActivityRow:D) {
	self.bless(:%data);
}

method date(--> Str)               { %!data<date> }
method model(--> Str)               { %!data<model> }
method model-permaslug(--> Str)     { %!data<model_permaslug> }
method endpoint-id(--> Str)         { %!data<endpoint_id> }
method provider-name(--> Str)       { %!data<provider_name> }

method requests(--> Int)            { %!data<requests> // 0 }
method prompt-tokens(--> Int)       { %!data<prompt_tokens> // 0 }
method completion-tokens(--> Int)   { %!data<completion_tokens> // 0 }
method reasoning-tokens(--> Int)    { %!data<reasoning_tokens> // 0 }

#|( OpenRouter credits spent (USD) for this row. Paid out of the
    user's OR balance. )
method cost(--> Numeric) { %!data<usage> // 0 }

#|( External-credit spend for BYOK requests — i.e. USD spent on the
    user's own provider account, reimbursed to OR. )
method byok-cost(--> Numeric) { %!data<byok_usage_inference> // 0 }

#|( USD per thousand tokens for this row, computed from C<cost> and
    the sum of prompt + completion tokens. Returns 0 when there's
    no token usage (shouldn't happen in practice, but guards
    against divide-by-zero on a malformed row).

    Named C<cost-per-thousand-tokens> rather than the more natural
    C<cost-per-1k-tokens> because Raku identifiers can't have a
    digit immediately after a hyphen — C<1k-tokens> would parse as
    a subtraction. )
method cost-per-thousand-tokens(--> Rat) {
	my $tokens = self.prompt-tokens + self.completion-tokens;
	return 0.Rat unless $tokens;
	return ((self.cost * 1000) / $tokens).Rat;
}

method raw(--> Hash) { %!data.Hash }


root

Credits

Filter

React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<AI|file:../mcp/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>
    =item2 L<Hand these documents to an AI assistant|file:../mcp/index.podlite>

=end nested
=begin nested :!nested
=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>

=end nested
=end React


Built with L<Podlite|https://podlite.org> — the markup and publishing tools behind this site.


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


ActivityRow

NAME

SYNOPSIS

DESCRIPTION

OpenRouter::API v0.1.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation