{"id":36631110,"url":"https://github.com/conduit-innovation/php-livex","last_synced_at":"2026-01-12T09:37:13.686Z","repository":{"id":56957230,"uuid":"115123951","full_name":"conduit-innovation/php-livex","owner":"conduit-innovation","description":"PHP Liv-Ex fine wine exchange API adapter","archived":false,"fork":false,"pushed_at":"2018-01-20T09:50:09.000Z","size":666,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-23T10:24:19.792Z","etag":null,"topics":["api","cellarview","json","liv-ex","php","vine","webservice","wine"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/conduit-innovation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-22T14:45:52.000Z","updated_at":"2024-04-23T10:24:19.793Z","dependencies_parsed_at":"2022-08-21T08:50:38.574Z","dependency_job_id":null,"html_url":"https://github.com/conduit-innovation/php-livex","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/conduit-innovation/php-livex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conduit-innovation%2Fphp-livex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conduit-innovation%2Fphp-livex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conduit-innovation%2Fphp-livex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conduit-innovation%2Fphp-livex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/conduit-innovation","download_url":"https://codeload.github.com/conduit-innovation/php-livex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conduit-innovation%2Fphp-livex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cellarview","json","liv-ex","php","vine","webservice","wine"],"created_at":"2026-01-12T09:37:13.602Z","updated_at":"2026-01-12T09:37:13.676Z","avatar_url":"https://github.com/conduit-innovation.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP-LivEx\n\nA composer-installable set of classes for easily interacting with the various Liv-Ex APIs. \n\nSee http://www.developers.liv-ex.com/ for more information.\n\n## Important Limitations\n\n- Currently, only [CellarView2](https://e767cb5f8a24933f1193-10d7789927afb962c5fef2cb2f4d8412.ssl.cf3.rackcdn.com/Cellar%20View%202%20API%20Documentation_v4.pdf) functionality is implemented. Full coverage of all APIs are planned.\n\n## Feature Roadmap\n\n1. CellarView2 (Working, ~50% test coverage)\n2. LWIN API\n3. Logistics API\n4. Broking APIs\n5. Valuations\n6. Direct Market Access / Exchange Integration\n7. Trading Alerts\n8. My Account APIs\n\n## Dependencies\n\n- PHP 5.5.38 or newer\n- PHP cURL (Usually included in PHP itself)\n- Liv-Ex API Credentials\n- [Composer](https://getcomposer.org/)\n\n## Installation\n\n- Run `composer require conduit\\php-livex:dev-master`\n- Run `composer install`\n- Include the autoloader if you haven't already - `require './vendor/autoload.php';`\n\n## Usage\n\n*Note:* There is HTML API class documentation available in `docs/api`. \n\n### Namespaces and organsiation\n\nPHP-LivEx is organised into a series of namespaces, closely matching the API categories on the Liv-Ex developer's site. Right now, these are:\n\n`Conduit\\LivEx\\Logistics`\n`Conduit\\LivEx\\LWIN`\n\n\n### Quick Example: Get all CellarView items\n\n```PHP\n\nuse \\Conduit\\LivEx\\Logistics\\CellarView2;\nuse \\Conduit\\LivEx\\Error;\n\n$cv = new CellarView2('\u003cyour api key\u003e','\u003cyour api secret\u003e','DEV');\n$r = $cv-\u003egetAll();\n\nif(Error::isError($r)) {\n  $r-\u003epretty();\n  return;\n}\n\nvar_dump($r); // An array of CellarView items.\n\n```\n\n### Quick Example: Find all items by sub account code\n\n```PHP\n\nuse \\Conduit\\LivEx\\Logistics\\CellarView2;\nuse \\Conduit\\LivEx\\Error;\n\n$cv = new CellarView2('\u003cyour api key\u003e','\u003cyour api secret\u003e','DEV');\n$r = $cv-\u003efindBySubAccount('subaccountcode');\n\nif(Error::isError($r)) {\n  $r-\u003epretty();\n  return;\n}\n\nvar_dump($r); // An array of CellarView items, attached to \"subaccountcode\".\n\n```\n\n### Quick Example: Find all items by LWIN\n\n```PHP\n\nuse \\Conduit\\LivEx\\Logistics\\CellarView2;\nuse \\Conduit\\LivEx\\Error;\n\n$cv = new CellarView2('\u003cyour api key\u003e','\u003cyour api secret\u003e','DEV');\n$r = $cv-\u003efindByLwin('100598920111200750');\n\nif(Error::isError($r)) {\n  $r-\u003epretty();\n  return;\n}\n\nvar_dump($r); // An array of CellarView items of type LWIN 100598920111200750\n\n```\n\n### Quick Example: Find all items by buyer reference\n\n```PHP\n\nuse \\Conduit\\LivEx\\Logistics\\CellarView2;\nuse \\Conduit\\LivEx\\Error;\n\n$cv = new CellarView2('\u003cyour api key\u003e','\u003cyour api secret\u003e','DEV');\n$r = $cv-\u003efindByBuyerRef('buyer-ref');\n\nif(Error::isError($r)) {\n  $r-\u003epretty();\n  return;\n}\n\nvar_dump($r); // An array of CellarView items linked with buyer reference \"buyer-ref\"\n\n```\n\n## Unit Tests\n\nPHP-LivEx comes bundled with PHPUnit tests and a test runner. Full coverage is planned.\n\nTo run the test suite, make sure you have the require-dev dependencies installed, then run `composer run test`.\n\n## API Documentation Generator\n\nTo regenerate the API docs, using PHPDocumentor, run `composer run docs`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconduit-innovation%2Fphp-livex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconduit-innovation%2Fphp-livex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconduit-innovation%2Fphp-livex/lists"}