Stable /api/currencies

Currency selector

Choose a currency with its ISO code and native symbol, sourced from the World currency endpoint.

ISO 4217 codes Native symbols Search-ready labels 250 country mappings

Installation

Install once, use everywhere.

composer require nnjeim/world:^2.0
php -d memory_limit=1G artisan world:install

React, Angular, and Vue consume the same Laravel API; no frontend package is required.

For the default database cache, run application migrations first. Existing 1.x users should review the 2.0 upgrade guide or stay with the 1.x documentation.

Playground

Live behavior and copy-ready code.

Currency selector

Connecting to the World API…

Live preview

Selected value

Loading…

component.blade.php 
Loading example…

API reference

Request only the fields you need.

GET /api/currencies?fields=code,symbol
Endpoint
/api/currencies
Fields used
id, name, code, symbol

Component contract

Props

NameTypeDefaultDescription
name string currency_id Submitted form-field name.
value number|null null Initially selected currency ID.
showSymbol boolean true Includes the native currency symbol.
disabled boolean false Prevents selection changes.

Events

change Currency

Emitted after a currency is selected.

loading boolean

Reports API loading state.

error Error

Reports an unavailable or invalid response.

Validation guidance

  • Submit the numeric currency ID.
  • Use the currency code for external integrations.
  • Store monetary values separately from presentation symbols.

Accessibility checklist

  • ✓Do not use a symbol as the only currency label.
  • ✓Include both the currency name and ISO code.
  • ✓Expose loading and failure states.
  • ✓Keep option text unambiguous.